Integration Guides

Android - version 10.0.0

Quick Start

1 Register your App

  1. Go to your Apps page
  2. Click on Create > Android
  3. Get your App ID, it will be used in the next steps.

3 Add Library

Requirements: Android 2.3 (API level 9) or higher. Rich ads are supported only for Android 3.0 (API level 11) or higher. Video and Rewarded Video ads require Android version higher than 4.0.X (API level 14 or higher).

  1. Unzip the download and you'll find our revmob.jar and our Sample Apps for Eclipse and Android Studio (they are a good model if you have any doubts).
  2. Add the revmob.jar to your project in your libs directory (you can create it as a new folder if you don't have one - follow our SampleApp's structure).
  3. Linking
    • Android Studio: Right-click the revmob.jar file on Android Studio and "Add as Library" (if you can't find it, go to your project explorer, click on the box that says "Android" and select "Project").
    • Eclipse: Right-click the revmob.jar file on Eclipse, select Build Path > Add to Build Path.

4 Android Manifest

It's necessary to add the Internet permission.
In your AndroidManifest.xml file, add the following code inside the <manifest></manifest> tag:


If you wish to display interstitial or rewarded video ads, you must also add the following:


If your app displays Revmob ads in multiple orientations, you must include the following attributes in your activities where this happens:


5 Basic Code

All you need to do now is import the SDK, initialize Revmob and add an ad.
This is where you'll use the media ID you got on step 1.
On the example below, we call on a clickable Link ad unit as soon as the session has started. You have full control over this ad unit's design: you build it, attach our method to its click event and the user will be redirected to the Play Store when he clicks:

import android.os.Bundle;
import android.util.Log;
import android.view.ViewGroup;

public class YourActivity extends Activity {

   RMNativeViewStandard rmNativeViewStandard;

   protected void onCreate(Bundle savedInstanceState) {

       Rm.init(this, YOUR_REVMOB_APP_ID);


   public void cacheNativeStandard() {
       Rm.cacheNativeStandard(YOUR_REVMOB_PLACEMENT_ID, 370, 250,  new RmListener.Cache() {
           public void onRmAdReceived() {
               Log.i("RevMob","Native ready to be displayed");

           public void onRmAdNotReceived(String message) {
               Log.i("Revmob", "Native NotReceived with error: " + message);

   public void showNativeStandard() {
       if (Rm.isNativeStandardLoaded(YOUR_REVMOB_PLACEMENT_ID)) {
           rmNativeViewStandard = Rm.getNativeStandard(this, YOUR_REVMOB_PLACEMENT_ID, new RmListener.Get() {

               public void onRmAdDisplayed() {
                   Log.i("Revmob", "Native Displayed");

               public void onRmAdFailed(String message) {
                   Log.i("Revmob", "Native Not Failed to Load");

               public void onRmAdDismissed() {
                   Log.i("Revmob", "Native Dismissed");

               public void onRmAdClicked() {
                   Log.i("RevMob", "Native clicked. You earned a coin!");

           ViewGroup view = (ViewGroup) findViewById (;
           view.removeAllViews ();
           view.addView (rmNativeViewStandard);


In your Activity's layout, add a container for your Native Ad.


To learn more about Revmob's ad units (link, native, banner, popup or rewarded video), please take a look at Android SDK's full guide.


100-million-downloads Ant Smasher's success case.

6 Testing

While you're developing your app, you will only receive test ads. Your app must make at least one ad request while on test mode in order to be validated before receiving live ads. Be sure you are able to receive at least one of our sample ads and that it’s redirecting to our "Success Page" when clicked. Once you are able to receive our sample ads it means you’ve successfully integrated our sdk.


Fullscreen sample, Banner sample, and Success Page

7 Go Live

Once you're finished and your app is in the store with our SDK, click on the "Go live" button in your Apps page and insert your app's URL. It may take up to 48h for your app to be approved. After that, it will start receiving live ads.