SDK Integration | Appodeal Intelligent Ad Mediation

App key

Link your Admob account

Appodeal yields optimal results in cooperation with Admob. To continue, you need to link your Admob account.

If you don't have Admob account, please sign up on

To link your Admob account to Appodeal, use the Chrome extension:


The extension source code is available at

The extension will make two changes in your Admob account. First, it will allow Appodeal to access your Admob reports over API, and second, it will create new ad units on Admob and submit them to Appodeal.


Download and integrate SDK

You can download Android SDK beta version 2.4.6 with major native ads improvements, segment v2 support, GDPR compliance and Parallel Bidding support here. Be aware that this version is still beta and may contain bugs.

You can download Appodeal Android SDK 2.1.11

Android SDK 2.1.11

If you're using MultiDex in your application, use this SDK


If you're not using MultiDex in your application and encountering 65K methods limit, use this SDK

not using MultiDex

Demo app

Make sure to add Privacy Policy to your app on Google Play that links to Appodeal's Privacy Policy to avoid violating Google Play Developer Distribution Agreement

Include Google Play Services lib in your project:

compile ''
compile ''

Place all .jar files from the SDK archive into the libs folder of your app.

Add all files from aar folder in SDK archive to your libs folder.

Add libs folder to repositories in build.gradle file:

repositories {
    flatDir {
        dirs 'libs'

Add dependencies to your gradle file:

compile 'com.squareup.picasso:picasso:2.5.2' //for Inmobi
compile name: 'adcolony-sdk-3.2.1', ext: 'aar'
compile name: 'mmedia-6.4.0', ext: 'aar'
compile name: 'mobvista_alphab', ext: 'aar'
compile name: 'mobvista_appwall', ext: 'aar'
compile name: 'mobvista_appwallext', ext: 'aar'
compile name: 'mobvista_common', ext: 'aar'
compile name: 'mobvista_interstitial', ext: 'aar'
compile name: 'mobvista_mvdownloads', ext: 'aar'
compile name: 'mobvista_mvjscommon', ext: 'aar'
compile name: 'mobvista_mvnative', ext: 'aar'
compile name: 'mobvista_nativeex', ext: 'aar'
compile name: 'mobvista_offerwall', ext: 'aar'
compile name: 'mobvista_playercommon', ext: 'aar'
compile name: 'mobvista_reward', ext: 'aar'
compile name: 'mobvista_videocommon', ext: 'aar'
compile name: 'mobvista_videofeeds', ext: 'aar'

Minimum OS requirements: Android API level 14 (Android OS 4.0), but you can include Appodeal SDK in apps with lower minSdkVersion


Add the following to your AndroidManifest.xml under manifest tag:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!--optional -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <!--optional -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!--optional-->

Add the following under application tag:

<activity android:name=""
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
<activity android:name=""
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
<activity android:name=""
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
<activity android:name=""
<receiver android:name="" android:exported="true" android:enabled="true">
		<action android:name="android.intent.action.PACKAGE_ADDED" />
		<data android:scheme="package" />
<activity android:name=""
	android:theme="@android:style/Theme.Translucent.NoTitleBar" />

<meta-data android:name="" android:value="@integer/google_play_services_version" />
<activity android:name=""
        tools:replace="android:theme" />

<activity android:name="com.chartboost.sdk.CBImpressionActivity" android:excludeFromRecents="true"
	android:hardwareAccelerated="true" android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
	android:configChanges="keyboardHidden|orientation|screenSize" />

<activity android:name="com.applovin.adview.AppLovinInterstitialActivity" android:configChanges="orientation|screenSize"/>
<activity android:name="com.applovin.adview.AppLovinConfirmationActivity" android:configChanges="orientation|screenSize"/>

<activity android:name="com.mopub.mobileads.MoPubActivity"
	android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />
<activity android:name="com.mopub.common.MoPubBrowser"
	android:configChanges="keyboardHidden|orientation|screenSize" />
<activity android:name="com.mopub.mobileads.MraidActivity"
	android:configChanges="keyboardHidden|orientation|screenSize" />
<activity android:name="com.mopub.mobileads.MraidVideoPlayerActivity"
	android:configChanges="keyboardHidden|orientation|screenSize" />
<activity android:name="com.mopub.mobileads.RewardedMraidActivity"

<activity android:name="org.nexage.sourcekit.vast.activity.VASTActivity"

<activity android:name="org.nexage.sourcekit.vast.activity.VPAIDActivity"
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />

<activity android:name=""
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />

<activity android:name="" android:configChanges="keyboardHidden|orientation|screenSize"/>

<activity android:name="" android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"

<!--suppress AndroidDomInspection -->
<activity android:name="" android:configChanges="keyboardHidden|orientation|screenSize" />

<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:theme="@android:style/Theme" />
<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:configChanges="orientation|keyboardHidden|screenSize" />
<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:configChanges="orientation|keyboardHidden|screenSize" />
<!--suppress AndroidDomInspection -->
<service android:name="" />
<!--suppress AndroidDomInspection -->
<service android:name="" />
<receiver android:name="" >
		<action android:name="android.intent.action.BOOT_COMPLETED" />

<service android:name="" android:enabled="true"
	android:exported="true" android:process=":Metrica">
		<category android:name="android.intent.category.DEFAULT" />
		<action android:name="" />
		<data android:scheme="metrica" />
	<meta-data android:name="metrica:api:level" android:value="58" />
<receiver android:name=""
	android:enabled="true" android:exported="true">
		<action android:name="" />

<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize" />

<activity android:name=""
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:hardwareAccelerated="true" />
<activity android:name=""
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:hardwareAccelerated="false" />
<activity android:name="com.unity3d.ads2.adunit.AdUnitActivity"
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:hardwareAccelerated="true" />
<activity android:name="com.unity3d.ads2.adunit.AdUnitSoftwareActivity"
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" android:hardwareAccelerated="false" />

<!--suppress AndroidDomInspection -->
<activity android:name="com.jirbo.adcolony.AdColonyOverlay"
	android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />
<!--suppress AndroidDomInspection -->
<activity android:name="com.jirbo.adcolony.AdColonyFullscreen"
	android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" />
<!--suppress AndroidDomInspection -->
<activity android:name="com.jirbo.adcolony.AdColonyBrowser"
	android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen" />

<!--suppress AndroidDomInspection -->
<activity android:name="com.vungle.publisher.VideoFullScreenAdActivity"
<!--suppress AndroidDomInspection -->
<activity android:name="com.vungle.publisher.MraidFullScreenAdActivity"
<!--suppress AndroidDomInspection -->
<activity android:name="com.vungle.publisher.FlexViewAdActivity"

<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:theme="@android:style/Theme.Translucent.NoTitleBar" />
<!--suppress AndroidDomInspection -->
<activity android:name=""
	android:theme="@android:style/Theme.Translucent.NoTitleBar" />

<activity android:name="com.mobvista.msdk.offerwall.view.MVOfferWallActivity"
	android:screenOrientation="portrait" />
<activity android:name="com.mobvista.msdk.offerwall.view.MVOfferWallRewardVideoActivity"
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
<activity android:name="com.mobvista.msdk.reward.player.MVRewardVideoActivity"
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
<activity android:name="com.mobvista.msdk.videofeeds.vfplayer.VideoFeedsActivity"
	android:screenOrientation="portrait" />
<activity android:name="com.mobvista.msdk.out.LoadingActivity" />
<activity android:name="com.mobvista.msdk.interstitial.view.MVInterstitialActivity"
	android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
<activity android:name=""
	android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />

<!--suppress AndroidDomInspection -->
<activity android:name="com.tapjoy.TJAdUnitActivity" android:configChanges="orientation|keyboardHidden|screenSize"
	android:hardwareAccelerated="true" android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen" />
<!--suppress AndroidDomInspection -->
<activity android:name="com.tapjoy.mraid.view.ActionHandler" android:configChanges="orientation|keyboardHidden|screenSize" />
<!--suppress AndroidDomInspection -->
<activity android:name="com.tapjoy.mraid.view.Browser" android:configChanges="orientation|keyboardHidden|screenSize" />
<!--suppress AndroidDomInspection -->
<activity android:name="com.tapjoy.TJContentActivity" android:configChanges="orientation|keyboardHidden|screenSize"
	android:theme="@android:style/Theme.Translucent.NoTitleBar" android:hardwareAccelerated="true" />

<!--suppress AndroidDomInspection -->
<activity android:name="com.ironsource.sdk.controller.ControllerActivity" android:configChanges="orientation|screenSize"
	android:hardwareAccelerated="true" />
<!--suppress AndroidDomInspection -->
<activity android:name="com.ironsource.sdk.controller.InterstitialActivity" android:configChanges="orientation|screenSize"
	android:hardwareAccelerated="true" android:theme="@android:style/Theme.Translucent" />
<!--suppress AndroidDomInspection -->
<activity android:name="com.ironsource.sdk.controller.OpenUrlActivity" android:configChanges="orientation|screenSize"
	android:hardwareAccelerated="true" android:theme="@android:style/Theme.Translucent" />

<!--suppress AndroidDomInspection -->
<activity android:name="com.adcolony.sdk.AdColonyInterstitialActivity" android:configChanges="keyboardHidden|orientation|screenSize"
<!--suppress AndroidDomInspection -->
<activity android:name="com.adcolony.sdk.AdColonyAdViewActivity" android:configChanges="keyboardHidden|orientation|screenSize"

<activity android:name="com.inmobi.rendering.InMobiAdActivity" android:configChanges="keyboardHidden|orientation|keyboard|smallestScreenSize|screenSize|screenLayout"
	android:hardwareAccelerated="true" android:resizeableActivity="false" android:theme="@android:style/Theme.NoTitleBar" />
<receiver android:name="com.inmobi.commons.core.utilities.uid.ImIdShareBroadCastReceiver" android:enabled="true" android:exported="true">
		<action android:name=""/>

<meta-data android:name="presage_key" android:value="000000"/>
<service android:name="io.presage.PresageService" android:enabled="true" android:exported="true" android:process=":remote">
		<action android:name="io.presage.PresageService.PIVOT" />
<activity android:name="io.presage.activities.PresageActivity" android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
	android:hardwareAccelerated="true" android:theme="@android:style/Theme.Translucent.NoTitleBar">
		<action android:name="io.presage.intent.action.LAUNCH_WEBVIEW" />
		<category android:name="android.intent.category.DEFAULT" />
<receiver android:name="io.presage.receiver.NetworkChangeReceiver">
		<action android:name="" />
		<action android:name="" />
		<action android:name="io.presage.receiver.NetworkChangeReceiver.ONDESTROY" />
<receiver android:name="io.presage.receiver.AlarmReceiver" />
	android:exported="true" />

<!--optional, remove if not using Millennial Media-->
	android:exported="false" />

Google Play device compatibility

If you are not using location services in you app and not using any other SDK that requires location permissions, you can add the following code to manifest to make your app available on devices that don't have GPS support:

<uses-feature android:name="android.hardware.location" android:required="false" />
<uses-feature android:name="" android:required="false" />

Android Integration

Ad Types



Appodeal.NON_SKIPPABLE_VIDEO - alias of Appodeal.REWARDED_VIDEO. Both of them shouldn't be used together




Ad types can be combined using "|" operator. For example Appodeal.INTERSTITIAL | Appodeal.REWARDED_VIDEO

SDK Initialization

To initialize SDK, you need to add the following code in onCreate method of your main activity:

  String appKey = "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f";
  Appodeal.initialize(this, appKey, Appodeal.INTERSTITIAL | Appodeal.REWARDED_VIDEO | Appodeal.BANNER | Appodeal.NATIVE | Appodeal.MREC);

To initialize only interstitials: use Appodeal.initialize(this, "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f", Appodeal.INTERSTITIAL);

To initialize interstitials and rewarded videos: use Appodeal.initialize(this, "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f", Appodeal.INTERSTITIAL | Appodeal.REWARDED_VIDEO);

To initialize only banners: use Appodeal.initialize(this, "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f", Appodeal.BANNER);

To initialize only rewarded video: use Appodeal.initialize(this, "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f", Appodeal.REWARDED_VIDEO);

To initialize only non-skippable video: use Appodeal.initialize(this, "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f", Appodeal.NON_SKIPPABLE_VIDEO);

To initialize only 300*250 banners: use Appodeal.initialize(this, "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f", Appodeal.MREC);

To initialize only native ads: use Appodeal.initialize(this, "fee50c333ff3825fd6ad6d38cff78154de3025546d47a84f", Appodeal.NATIVE);

If your activity is recreated on screen rotation banner will disappear. To prevent that you need to call the following method in onResume of your activity:

public void onResume() {
  Appodeal.onResume(this, Appodeal.BANNER);

Display Ad

To display ad you need to call the following code in activity:, adTypes); returns a boolean value indicating whether show call was passed to appropriate SDK

To display interstitial: use, Appodeal.INTERSTITIAL)

To display rewarded video: use, Appodeal.REWARDED_VIDEO)

To display non-skippable video: use, Appodeal.NON_SKIPPABLE_VIDEO)

To display interstitial or rewarded video: use, Appodeal.INTERSTITIAL | Appodeal.REWARDED_VIDEO)

To display banner at the bottom of the screen: use, Appodeal.BANNER_BOTTOM)

To display banner at the top of the screen: use, Appodeal.BANNER_TOP)

To display banner in the view specified in layout file: use, Appodeal.BANNER_VIEW)

To display banner 300*250 you need to call the following code in activity:, Appodeal.MREC)


Display interstitial

To display interstitial you need to call the following code in activity:, Appodeal.INTERSTITIAL);

Checking if interstitial is loaded


Using Interstitial callbacks

Appodeal.setInterstitialCallbacks(new InterstitialCallbacks() {
  public void onInterstitialLoaded(boolean isPrecache) {
    Log.d("Appodeal", "onInterstitialLoaded");
  public void onInterstitialFailedToLoad() {
    Log.d("Appodeal", "onInterstitialFailedToLoad");
  public void onInterstitialShown() {
    Log.d("Appodeal", "onInterstitialShown");
  public void onInterstitialClicked() {
    Log.d("Appodeal", "onInterstitialClicked");
  public void onInterstitialClosed() {
    Log.d("Appodeal", "onInterstitialClosed");

Rewarded Video

To display rewarded video you need to call the following code in activity:, Appodeal.REWARDED_VIDEO);

Checking if rewarded video is loaded


Using rewarded video callbacks

Appodeal.setRewardedVideoCallbacks(new RewardedVideoCallbacks() {
  public void onRewardedVideoLoaded() {
    Log.d("Appodeal", "onRewardedVideoLoaded");
  public void onRewardedVideoFailedToLoad() {
    Log.d("Appodeal", "onRewardedVideoFailedToLoad");
  public void onRewardedVideoShown() {
    Log.d("Appodeal", "onRewardedVideoShown");
  public void onRewardedVideoFinished(int amount, String name) {
    Log.d("Appodeal", "onRewardedVideoFinished");
  public void onRewardedVideoClosed(boolean finished) {
    Log.d("Appodeal", "onRewardedVideoClosed");

S2S Reward Callbacks

To secure you apps economy we offer S2S reward callbaks. To validate each reward you need to setup callback URL on your server that will receive reward information. We will pass user data to your callback URL that you will need to validate and adjust user balance accordingly

1. Create reward callback URL on your server that will receive reward information

2. Fill created URL and encryption key in the app settings in your dashboard

3. Reward callback will be sent to your URL using GET request with two parameters:


4. Your URL should decrypt the data and validate it

5. Check impression_id for uniqueness and store it in your system to prevent duplicate transactions

To set user ID use Appodeal.getUserSettings(this).setUserId("User#123") method before SDK initialization

We offer sample script in PHP, Ruby, Java, Node.js and Python 3 to decrypt the data. If you need samples in other languages please contact our support and we will provide it for you.

Sample in PHP: reward.php

Sample in Ruby: reward.rb

Sample in Java:

Sample in Node.js: reward.js

Sample in Python 3:

Sample in C#: Reward.cs

Getting reward data for placement

To get placement reward data before video is shown use:


This method returns Pair with reward amount and currency

Native Ads

Caching native

To cache native ads use:

Appodeal.cache(this, Appodeal.NATIVE);

Caching multiple native ads

To cache multiple native ads use:

Appodeal.cache(this, Appodeal.NATIVE, 3);

The number of cached ads is not guaranteed and could be less than requested.

Get loaded native ads

To get loaded native ads use the following method:

Appodeal.getNativeAds(int amount)

This method returns List with up to amount loaded native ads

Native ads callbacks

Appodeal.setNativeCallbacks(new NativeCallbacks() {
  public void onNativeLoaded() {
    Log.d("Appodeal", "onNativeLoaded");
  public void onNativeFailedToLoad() {
    Log.d("Appodeal", "onNativeFailedToLoad");
  public void onNativeShown(NativeAd nativeAd) {
    Log.d("Appodeal", "onNativeShown");
  public void onNativeClicked(NativeAd nativeAd) {
    Log.d("Appodeal", "onNativeClicked");

Image caching

To disable caching of native icons or images/video if you are not planning to use both, use the following methods before native ads initialization:


Native video

To show video native ads you should add NativeMediaView to native ad layout

NativeMediaView nativeMediaView = (NativeMediaView) adView.findViewById(;
if (nativeAd.containsVideo()) {
} else {

Native video settings

To control whether you want to show video native ads, use the following methods:

Appodeal.setNativeAdType(Native.NativeAdType.Auto) - both static image and video native ads will be loaded

Appodeal.setNativeAdType(Native.NativeAdType.NoVideo) - only static image native ads will be loaded

Appodeal.setNativeAdType(Native.NativeAdType.Video) - only video native ads will be loaded

NativeAd object

After native ads are cached using Appodeal.cache(), list of NativeAd objects are returned in onNativeLoaded callback. NativeAd object has the following methods:

nativeAd.getTitle() - String: Title of native ad. Mandatory. Minimum 25 symbols of title should always be displayed. You can add ellipsis at the end if the title is longer.

nativeAd.getCallToAction() - String: Call to action text. Mandatory. Should be displayed without truncation on a visible button.

nativeAd.getDescription() - String: Text description of native ad. Optional. If you choose to display the description you should display minimum 75 characters. You should limit number of lines displayed suitable for your app. You can add ellipsis at the end.

nativeAd.getRating() - Float: Rating of the app in [0-5] range.

nativeAd.getAgeRestrictions() - String. App age restriction. Optional, may return null.

nativeAd.getIcon() - Bitmap: Icon. Either icon or image is mandatory to display.

nativeAd.getImage() - Bitmap: Image. Either icon or image is mandatory to display.

nativeAd.getIconUrl() - String. Returns URL of the Icon. Disable automatic caching of icons using Appodeal.setAutoCacheNativeIcons(false) if you are planning on caching icons yourself.

nativeAd.getMainImageUrl() - String. Returns URL of the Image. Disable automatic caching of images using Appodeal.setAutoCacheNativeMedia(false) if you are do not want to use images/video.

nativeAd.getProviderView(context) - View: If returned view is not null it is mandatory to display it in any corner of native ad. Only used for Facebook to display AdChoices icon.

nativeAd.registerViewForInteraction(nativeAdView) - Registers native ad view to the native ad to track impressions and process clicks. Mandatory.

nativeAd.unregisterViewForInteraction() - Unregisters view after native ad is no longer displayed. Mandatory.

nativeAd.setNativeMediaView(NativeMediaView) - Registers NativeMediaView to NativeAd object. Mandatory if videos are used.

nativeAd.containsVideo() - Returns true if NativeAd object contains video.

Native ads requirements

All of the fields of native ad marked as mandatory must be displayed.

Every ad should have a sign that clearly indicates that it is an ad. For example "Ad" or "Sponsored".

Provided images can be resized to fit your ad space but should not be significantly distorted or cropped.


Appodeal SDK provides 3 types of templates for native ads:

  • NativeAdViewNewsFeed
  • NativeAdViewAppWall
  • NativeAdViewContentStream

If you want to use one of these templates, you can add the selected template in the layout:




And when you need to show an ad:

NativeAdViewNewsFeed nav_nf = (NativeAdViewNewsFeed) mActivity.findViewById(;

NativeAdViewAppWall nav_aw = (NativeAdViewAppWall) mActivity.findViewById(;

NativeAdViewContentStream nav_cs = (NativeAdViewContentStream) mActivity.findViewById(;

You can also create a view programmatically and add it to the screen:

RelativeLayout holder = (RelativeLayout) mActivity.findViewById(;
NativeAdViewAppWall nativeAdView = new NativeAdViewAppWall(mActivity, mNativeAd);

Template elements:

ImageView getImageView()
ImageView getIconView()
TextView getTitleView()
TextView getDescriptionView()
TextView getCallToActionView()
RatingBar getRatingBar()

By default, native ads are labeled «Ad». You can replace it with «Sponsored»:


To change the color of the call-to-action button in the templates use:

nav.setCallToActionColor(int color)
nav.setCallToActionColor(String color)

Native ads integration sample

Appodeal.initialize(this, APP_KEY, Appodeal.NATIVE);
Appodeal.setNativeCallbacks(new NativeCallbacks() {
    public void onNativeLoaded() {
        Toast.makeText(MainActivity.this, "onNativeLoaded", Toast.LENGTH_SHORT).show();

    public void onNativeFailedToLoad() {
        Toast.makeText(MainActivity.this, "onNativeFailedToLoad", Toast.LENGTH_SHORT).show();

    public void onNativeShown(NativeAd nativeAd) {
        Toast.makeText(MainActivity.this, "onNativeShown", Toast.LENGTH_SHORT).show();

    public void onNativeClicked(NativeAd nativeAd) {
        Toast.makeText(MainActivity.this, "onNativeClicked", Toast.LENGTH_SHORT).show();

To show loaded native ad:

public void showNativeAd() {
    RelativeLayout nativeView = findViewById(;
    NativeAd nativeAd = Appodeal.getNativeAds(1).get(0);

    TextView nativeAdSign = nativeView.findViewById(;

    TextView nativeTitle = nativeView.findViewById(;

    TextView nativeDescription = nativeView.findViewById(;

    RatingBar nativeRating = nativeView.findViewById(;
    if (nativeAd.getRating() == 0) {
    } else {

    Button nativeCta = nativeView.findViewById(;

    ((ImageView) nativeView.findViewById(;
    ((ImageView) nativeView.findViewById(;

    View providerView = nativeAd.getProviderView(MainActivity.this);
    if (providerView != null) {
        FrameLayout providerViewContainer = nativeView.findViewById(;


Banner 300*250 (MREC)

To display MREC you need to call the following code in activity:

Add to your layout file:

  android:visibility="gone" />

Set view id before SDK initialization


Now you can show banner in the view specified:, Appodeal.MREC);

To hide MREC you need to call the following code in activity:

Appodeal.hide(this, Appodeal.MREC);

Destroying cached MREC


Using MREC callbacks

Appodeal.setMrecCallbacks(new MrecCallbacks() {
  public void onMrecLoaded(boolean isPrecache) {
    Log.d("Appodeal", "onMrecLoaded");
  public void onMrecFailedToLoad() {
    Log.d("Appodeal", "onMrecFailedToLoad");
  public void onMrecShown() {
    Log.d("Appodeal", "onMrecShown");
  public void onMrecClicked() {
    Log.d("Appodeal", "onMrecClicked");

Using programmatically created 300*250 banner view

Create banner view


Add view to your layout and than show banner in it:, Appodeal.MREC);


Display banner at the bottom of the screen, Appodeal.BANNER_BOTTOM);

Display banner at the top of the screen, Appodeal.BANNER_TOP);

Display banner in the view specified in layout file

Add to your layout file:

  android:visibility="gone" />

Set view id before SDK initialization


Now you can show banner in the view specified:, Appodeal.BANNER_VIEW);

Using programmatically created banner view

Create banner view


Add view to your layout and then show banner in it:, Appodeal.BANNER_VIEW);

Hiding banner

Appodeal.hide(this, Appodeal.BANNER);

Destroying cached banner


Using banner callbacks

Appodeal.setBannerCallbacks(new BannerCallbacks() {
  public void onBannerLoaded(int height, boolean isPrecache) {
    Log.d("Appodeal", "onBannerLoaded");
  public void onBannerFailedToLoad() {
    Log.d("Appodeal", "onBannerFailedToLoad");
  public void onBannerShown() {
    Log.d("Appodeal", "onBannerShown");
  public void onBannerClicked() {
    Log.d("Appodeal", "onBannerClicked");

Enabling 728*90 banners

To enable 728*90 banner use the following method:


Disabling banner refresh animation

To disable banner refresh animation use:


Disabling smart banners


Disables smart banners, enabled by default

Advanced Features

Enabling test mode


In test mode test ads will be shown and debug data will be written to logcat

Enabling logging


Available parameters: Log.LogLevel.none, Log.LogLevel.debug, Log.LogLevel.verbose

Enable debug logging to logcat using tag "Appodeal"

Checking if loaded ad is precache


Currently supported only for interstitials, banners and MREC

To check if loaded interstitial is precache: use Appodeal.isPrecache(Appodeal.INTERSTITIAL);

To check if loaded banner is precache: use Appodeal.isPrecache(Appodeal.BANNER);

To check if loaded MR|EC is precache: use Appodeal.isPrecache(Appodeal.MREC);

Manual ad caching

Appodeal.cache((Activity)this, adTypes);

You should disable automatic caching before SDK initialization using setAutoCache(adTypes, false);.

To cache interstitial: use Appodeal.cache(this, Appodeal.INTERSTITIAL);

To cache rewarded video: use Appodeal.cache(this, Appodeal.REWARDED_VIDEO);

To cache non-skippable video: use Appodeal.cache(this, Appodeal.NON_SKIPPABLE_VIDEO);

To cache interstitial and rewarded video: use Appodeal.cache(this, Appodeal.INTERSTITIAL | Appodeal.REWARDED_VIDEO);

To cache banner: use Appodeal.cache(this, Appodeal.BANNER);

To cache 300*250 banner: use Appodeal.cache(this, Appodeal.MREC);

To cache native ads: use Appodeal.cache(this, Appodeal.NATIVE);

Enabling or disabling automatic caching

Appodeal.setAutoCache(adTypes, false);

Should be used before SDK initialization

To disable automatic caching for interstitials: use Appodeal.setAutoCache(Appodeal.INTERSTITIAL, false);

To disable automatic caching for rewarded videos: use Appodeal.setAutoCache(Appodeal.REWARDED_VIDEO, false);

To disable automatic caching for non-skippable videos: use Appodeal.setAutoCache(Appodeal.NON_SKIPPABLE_VIDEO, false);

To disable automatic caching for banners: use Appodeal.setAutoCache(Appodeal.BANNER, false);

To disable automatic caching for native ads: use Appodeal.setAutoCache(Appodeal.NATIVE, false);

Triggering onLoaded callback on precache

Appodeal.setTriggerOnLoadedOnPrecache(adTypes, true);

Currently supported only for interstitials, banners and MREC

setTriggerOnLoadedOnPrecache(Appodeal.INTERSTITIAL | Appodeal.BANNER, false); - onInterstitialLoaded and onBannerLoaded will trigger only when normal ad was loaded (default).

setTriggerOnLoadedOnPrecache(Appodeal.INTERSTITIAL | Appodeal.BANNER, true); - onInterstitialLoaded and onBannerLoaded will trigger twice, both when precache and normal ad were loaded.

Should be used before SDK initialization

Disabling data collection for kids apps


Handling orientation change

If your activity is recreated on screen rotation banner will disappear. To prevent that you need to call the following method in onResume of your activity:

public void onResume() {
  Appodeal.onResume(this, Appodeal.BANNER);
  Appodeal.onResume(this, Appodeal.MREC);

Disabling networks

Appodeal.disableNetwork((Context)this, (String)network);

Available parameters: "adcolony", "admob", "amazon_ads", "applovin", "appnext", "avocarrot", "chartboost", "facebook", "flurry", "inmobi", "inner-active", "ironsource", "mailru", "mmedia", "mopub", "mobvista", "ogury", "openx", "pubnative", "smaato", "startapp", "tapjoy", "unity_ads", "vungle", "yandex"

Should be used before SDK initialization

Disabling networks for specific ad types

Appodeal.disableNetwork((Context)this, (String)network, adTypes);


Appodeal.disableNetwork(this, "startapp", Appodeal.BANNER | Appodeal.INTERSTITIAL);

Should be used before SDK initialization

Disabling location permission check

To disable toast messages ACCESS_COARSE_LOCATION permission is missing, use the following method:


Should be used before SDK initialization.

Disabling write external storage permission check.

To disable toast messages WRITE_EXTERNAL_STORAGE permission is missing use the following method:


Disables all ad networks that need this permission may lead to low video fillrates

Should be used before SDK initialization

Requesting Android M permissions

To request WRITE_EXTERNAL_STORAGE and ACCESS_COARSE_LOCATION permissions on Android M and higher call the following method:

Appodeal.requestAndroidMPermissions((Activity) this, new PermissionsHelper.AppodealPermissionCallbacks(){
  public void writeExternalStorageResponse(int result) {
    if (result == PackageManager.PERMISSION_GRANTED) {
      Utils.showToast((Activity) MainActivity.this, "WRITE_EXTERNAL_STORAGE permission was granted");
    } else {
      Utils.showToast((Activity) MainActivity.this, "WRITE_EXTERNAL_STORAGE permission was NOT granted");

  public void accessCoarseLocationResponse(int result) {
    if (result == PackageManager.PERMISSION_GRANTED) {
      Utils.showToast((Activity) MainActivity.this, "ACCESS_COARSE_LOCATION permission was granted");
    } else {
      Utils.showToast((Activity) MainActivity.this, "ACCESS_COARSE_LOCATION permission was NOT granted");

Tracking in-app purchase

Appodeal.trackInAppPurchase((Context) this, amount, currencyCode);

Tracks in-app purchase information and sends info to our servers for analytics. Example:

Appodeal.trackInAppPurchase(this, 5, "USD");

Testing third-party networks adapters integration

To start test activity for testing adapters integration call:

Appodeal.startTestActivity((Activity) this)

Muting videos if call volume is muted


Setting User Data


Our SDK provides the transfer of user data for better ad targeting and higher eCPM. All parameters are optional and can be defined partially.

To obtain reference to the user settings, please call this before Appodeal initialization:

UserSettings userSettings = Appodeal.getUserSettings(this);

Set the age of the user

Positive integer value.


Specify gender of the user


Possible values: UserSettings.Gender.FEMALE, UserSettings.Gender.MALE, UserSettings.Gender.OTHER.

Segments and Placements

Segments are divisions of your user base, which share commonalities such as age, sex, location, interests, income bracket, etc. There are several ways to segment users into groups including the use of demographics, in-app behavior or engagement analysis, interests and personal profile data, and location.

Once user segments have been created, they can then be analyzed and used to configure ads.

To create new segment go here

1) Enter its name

2) Select match rule:

  • ALL - user will only match to segment if all of the rules will apply to them
  • ANY - user will match to segment if any of the rules will apply to them

3) Select platform

4) Select rules that apply to the user, you can select as many rules as you want or none at all:

  • App - match users in one or multiple of your apps
  • SDK version - match users that only use specified SDK version or range of versions
  • Device type - match users that using tablet and/or phone
  • App version - match users that only use specified app version or range of versions
  • Country - match users only from specified countries
  • OS version - match users that are using devices with specified Android
  • Has app installed - only match users that have specified apps installed
  • Session count - match users that had specified number of sessions in your app
  • Average session length - match users with specified that spent specified average session length in your app
  • Device model - match user on specified devices
  • Connection type - match users using specified connection type
  • Gender, Age, Occupation, Relation - matches users with specified Gender, Age, Occupation, Relation
  • Last session time - matches users that last used your app at the specified time
  • Bought inapps - matches users that made in-app purchases (tracked using Appodeal.trackInAppPurchase method)
  • Inapp sum, Inapp sum all apps - matches users the spent specified amount in your the app or all apps (only counts in-apps tracked using Appodeal.trackInAppPurchase method)
  • Hour, Day - matches users using the app at the specified time
  • Int, Float, String, Bool - matches users using custom parameters. You can set custom parameters in SDK using Appodeal.setCustomRule method, i.e. Appodeal.setCustomRule("levels_played", 3). To match users that played more than 3 level select Int and enter name "levels_played", select operator > and value 3

5) Segment settings. You can apply following settings for each segment. They will apply to all users matched to that segment.

  • Disable networks - Allows you to disable any network for an ad type it supports
  • Min pricefloor - Allows you to set minimum price floor for each ad type. Ads with eCPM lower then price floor will not be filled.
  • Overriden eCPM - Allows you to override eCPM of each network for ad type. High eCPM(100+) will ensure that the network will be at the top of the waterfall and get the first fill. Low eCPM (close to 0) will ensure that the network acts as backfill.

If you have no segments all users will be matched to hidden default segment

If you have multiple segments, their order is important. Only the first segment in which rules are matched to the user will apply. All of the rest will be ignored.


Appodeal SDK allows you to tag each impression with different placement.

To show an ad with placement, you have to call show method like this:, adTypes, placementName);

To check if ad can be shown for the specific placement use:

Appodeal.canShow(adTypes, placementName)

Placement can be used for separating your revenue by placement in our dashboard and determining which placement earns you more money.

Also you can configure your impression logic for each placement. You can use the following Placement settings:

  • Disable ads - disables ads completely for that placement
  • Disable as types - disables specific ad type for a placement. If you integrated to show Appodeal.INTERSTITIAL | Appodeal.SKIPPABLE_VIDEO you can disable interstitials or skippable video for the placement
  • Reward - you can set a reward amount and name which will be passed in onRewardedVideoFinished callback for all videos shown with this placement. To get reward before video if played use Appodeal.getRewardParameters(placementName)
  • Impression/Refresh period - you can set impression period (in seconds) for interstitials, skippable and rewarded video shown with the placement. If the period between two impression is less than impression period, second impression will not be shown and method will return false. For banners and MRECs you can set their refresh period
  • Min pricefloor - Allows you to set minimum price floor for each ad type. Ads with eCPM lower than price floor will not be shown and method will return false.

Placements can only be used as part of existing segment. If you only want to use placements create, one segment for each platform without any rules and match rule ALL. All of your users will be matched to it.

If you have no placement, or call with placement that do not exist or without placement in your segment, the impression will be tagged with 'default' placement and its settings will be applied.

You can check more examples here

Proguard Settings

If you are using Proguard

If you are using Proguard add the following to your Proguard config file:

# Appodeal
-keep class com.appodeal.** { *; }
-keep class org.nexage.** { *; }
-keepattributes EnclosingMethod, InnerClasses, Signature, JavascriptInterface

# Amazon
-keep class** { *; }

# Mopub
-keep public class com.mopub.**
-keepclassmembers class com.mopub.** { public *; }
-dontwarn com.mopub.**
-keep class * extends com.mopub.mobileads.CustomEventBanner {}
-keepclassmembers class com.mopub.mobileads.CustomEventBannerAdapter {!private !public !protected *;}
-keep class * extends com.mopub.mobileads.CustomEventInterstitial {}
-keep class * extends com.mopub.nativeads.CustomEventNative {}
-keep class * extends com.mopub.mobileads.CustomEventRewardedVideo {}
-keepclassmembers class ** { @com.mopub.common.util.ReflectionTarget *; }
-dontwarn com.mopub.volley.toolbox.**

# Applovin
-keep class com.applovin.** { *; }
-dontwarn com.applovin.**

# Facebook
-keep class** { *; }
-keeppackagenames com.facebook.*

# Chartboost
-keep class com.chartboost.** { *; }
-dontwarn com.chartboost.**

# Unity Ads
-keepattributes SourceFile,LineNumberTable
-keep class com.unity3d.** { *; }
-dontwarn com.unity3d.**

# Yandex
-keep class** { *; }
-keep class** { *; }
-keepattributes *Annotation*

# StartApp
-keep class com.startapp.** { *;}
-dontwarn com.startapp.**
-dontwarn android.webkit.JavascriptInterface
-keepattributes Exceptions, InnerClasses, Signature, Deprecated, SourceFile, LineNumberTable, *Annotation*, EnclosingMethod

# Flurry
-keep class com.flurry.** { *; }
-dontwarn com.flurry.**
-keepattributes *Annotation*,EnclosingMethod,Signature
-keepclasseswithmembers class * {
  public <init>(android.content.Context, android.util.AttributeSet, int);

# Avocarrot
-keep class com.avocarrot.** { *; }
-keepclassmembers class com.avocarrot.** { *; }
-dontwarn com.avocarrot.**
-keep public class * extends android.view.View {
  public <init>(android.content.Context);
  public <init>(android.content.Context, android.util.AttributeSet);
  public <init>(android.content.Context, android.util.AttributeSet, int);
  public void set*(...);

# Adcolony
-keep class com.jirbo.adcolony.** { *;}
-keep class com.adcolony.** { *;}
-keep class com.immersion.** { *;}
-dontnote com.immersion.**
-dontwarn android.webkit.**
-dontwarn com.jirbo.adcolony.**
-dontwarn com.adcolony.**
-keepclassmembers class com.adcolony.sdk.ADCNative** { *; }

# Vungle
-keepattributes *Annotation*, Signature
-keep class com.vungle.** { *;}
-dontwarn com.vungle.**
-dontnote com.vungle.**
-dontwarn com.moat.**
-keep class** { *;}
-keep class com.moat.** { public protected private *; }
-keep class dagger.**
-dontwarn de.greenrobot.event.util.**
-keep class de.greenrobot.event.**
-keep class javax.inject.**
-keep class rx.**
-dontwarn rx.**
-keepclassmembers class rx.internal.util.unsafe.*ArrayQueue*Field* {
   long producerIndex;
   long consumerIndex;
-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueProducerNodeRef {
   rx.internal.util.atomic.LinkedQueueNode producerNode;
-keepclassmembers class rx.internal.util.unsafe.BaseLinkedQueueConsumerNodeRef {
   rx.internal.util.atomic.LinkedQueueNode consumerNode;

# MyTarget
-keep class** { *; }

# Mobvista
-keepattributes Signature
-keepattributes *Annotation*
-keep class com.mobvista.** {*; }
-keep interface com.mobvista.** {*; }
-keep class** { *; }
-dontwarn com.mobvista.**
-keep class **.R$* { public static final int mobvista*; }
-keep class com.alphab.** {*; }
-keep interface com.alphab.** {*; }

# Admob
-keep class** { *; }

# Tapjoy
-keep class com.tapjoy.** { *; }
-dontwarn com.tapjoy.**

# IronSource
-keepclassmembers class com.ironsource.sdk.controller.IronSourceWebView$JSInterface { public *; }
-keepclassmembers class * implements android.os.Parcelable { public static final android.os.Parcelable$Creator *; }
-keep public class** { public *; }
-dontwarn com.moat.**
-keep class com.moat.** { public protected private *; }
-keep class com.ironsource.** { *; }
-dontwarn com.ironsource.**

# AdColonyV3
-keepclassmembers class * { @android.webkit.JavascriptInterface <methods>; }
-keep class com.adcolony.** { *; }
-dontwarn com.adcolony.**

-keep class com.appnext.** { *; }
-dontwarn com.appnext.**

# Inmobi
-keep class com.inmobi.** { *; }
-dontwarn com.inmobi.**
-dontwarn com.squareup.picasso.**
-keep class com.squareup.picasso.** {*;}
-dontwarn com.squareup.picasso.**
-dontwarn com.squareup.okhttp.**
-keep class com.moat.** {*;}
-dontwarn com.moat.**

# MMdeia
-keepclassmembers class com.millennialmedia** {public *;}
-keep class com.millennialmedia**
-dontwarn com.millennialmedia.**

# Ogury
-dontwarn io.presage.**
-dontnote io.presage.**
-dontwarn shared_presage.**
-dontwarn org.codehaus.**
-keepattributes Signature
-keep class shared_presage.** { *; }
-keep class io.presage.** { *; }
-keepclassmembers class io.presage.** { *; }
-keepattributes *Annotation*
-keepattributes JavascriptInterface
-keepclassmembers class * {
  @android.webkit.JavascriptInterface <methods>;
-dontnote okhttp3.**
-dontnote okio.**
-dontwarn okhttp3.**
-dontwarn okio.**
-dontwarn javax.annotation.Nullable
-dontwarn javax.annotation.ParametersAreNonnullByDefault

-dontnote sun.misc.Unsafe

-dontnote org.apache.commons.codec.**
-dontnote org.apache.http.**

-dontwarn org.apache.commons.collections.BeanMap
-dontwarn java.beans.**
-keepclassmembers class * implements {
  static final long serialVersionUID;
  private static final[] serialPersistentFields;
  private void writeObject(;
  private void readObject(;
  java.lang.Object writeReplace();
  java.lang.Object readResolve();

# Google
-keep class {*;}
-keep class** { *; }

# Legacy
-keep class org.apache.http.** { *; }
-dontwarn org.apache.http.**

# Google Play Services library
-keep class * extends java.util.ListResourceBundle {
  protected Object[][] getContents();
-keep public class {
  public static final *** NULL;
-keepnames class * implements android.os.Parcelable
-keepclassmembers class * implements android.os.Parcelable {
  public static final *** CREATOR;
-keep @interface
-keep class *
-keepclasseswithmembers class * { <fields>;
-keepclasseswithmembers class * { <methods>;
-keep @interface
-keepnames class *
-keepclassmembernames class * { *;
-keep @interface
-keep public class * {
  public <fields>;
  public <methods>;
-keep class {*;}
-keep class {*;}

# Google Play Services library 9.0.0 only
-keep public class * { *; }

# support-v4
-keep class { *; }
-keep class { *; }
-keep class { *; }
-keep class { *; }
-keep class { *; }
-keep class { *; }
-keep class { *; }
-keep class { *; }
-keep class { *; }
-keep class { *; }

# support-v7-recyclerview
-keep class { *; }
-keep class { *; }

Third-party SDKs versions

NetworkSDK version
Amazon Ads5.8.1.1
Facebook Audience Network4.26.1
Millennial Media6.4.0
Unity Ads2.1.0
Yandex Metrica2.73
Yandex Mobile Ads2.61


2.1.11 (Mar 15, 2018)

  • Ogury SDK became mandatory

2.1.10 (Feb 28, 2018)

  • Fix issue with checking Mobvista classes

2.1.9 (Nov 30, 2017)

  • Updating and in AndroidManifest
  • Adding Mobvista support (Interstitial, Rewarded videos), add new activities to AndroidManifest, update ProGuard
  • Adding support for Tapjoy skippable videos
  • Updating Startapp to 3.6.7, add new receiver to AndroidManifest
  • Updating Applovin to 7.5.0
  • Updating Adcolony to 3.2.1, update ProGuard
  • Updating Facebook to 4.26.1
  • Updating IronSource to 6.7.3, update ProGuard

2.1.7 (Oct 26, 2017)

  • Improving Admob mediation algorithm
  • Adding Appodeal.destroy method that allows to destroy cached banner or MREC ads to avoid memory leaks
  • Android O improvements
  • Appodeal.isPrecache method fix
  • Updating Applovin to 7.4.0
  • Updating Facebook to 4.26.0
  • Updating Yandex Mobile Ads to 2.61

2.1.4 (Sep 15, 2017)

  • Updating Ogury to 2.1.15
  • Android O improvements
  • Memory leaks fixes
  • Small fixes

2.1.3 (Sep 1, 2017)

  • Updating Applovin to 7.3.2
  • Applovin integration fix
  • Proguard fix for Mopub, please update your Proguard file

2.1.2 (Sep 1, 2017)

  • Vungle integration fix
  • Small fixes

2.1.1 (Aug 29, 2017)

  • Making Ogury optional, if you're not using Ogury remove Ogury service and receiver from AndroidManifest
  • Fixing Startapp activity in AndroidManifest
  • Small fixes

2.1.0 (Aug 18, 2017)

  • Adding Millenial Media support (Interstitial, Banner, MREC, Native) (Optional, user accounts only)
  • Adding Appnext native ads
  • Flurry is now optional, use it only with your own account
  • Adding Appodeal.setChildDirectedTreatment method to disable user data collection
  • Adding message in log if you're not using latest SDK version
  • Updating Applovin to 7.2.0
  • Updating Avocarrot to 3.8.2
  • Updating Chartboost to 6.6.3
  • Updating Facebook to 4.25.0
  • Updating Flurry to 7.0.0
  • Updating Inmobi to 6.2.3
  • Updating IronSource to
  • Updating Mopub to 4.15.0
  • Updating myTarget to 4.6.17
  • Updating Startapp to 3.6.2
  • Updating Tapjoy to 11.11.0
  • Updating Unity Ads to 2.1.0
  • Updating Vungle to 5.1.0
  • Updating Yandex Metrica to 2.73 & Yandex Ads to 2.60
  • Adding optional Picaso lib (for Inmobi)
  • Banner and MREC optimizations
  • Memory leaks fixes
  • Fixing minor crashes and ANRs
  • Fixing issue when banner might appear on top of full screen ads after refresh

2.0.2 (May 31, 2017)

  • Small fixes

2.0.1-beta (May 19, 2017)

  • Adding interstitials from Ogury
  • Adding banners and MREC from Applovin
  • Improving support for rewarded videos from Mopub
  • Adding optional ACCESS_WIFI_STATE permission
  • Enabling 728*90 banners on tablets by default
  • Many AndroidManifest and Proguard changes, please do not forget to update them
  • Removing Appodeal.confirm method
  • Removing onInterstitialFinished callback from InterstitialCallbacks
  • Removing setEmail, setBirthday, setOccupation, setRelation, setSmoking, setAlcohol, setInterests methods from UserSettings
  • Removing Admob & Mopub mediation adapters
  • Removing Revmob integration
  • Removing Cheetah Mobile integration
  • Updating Adcolony to 3.1.2
  • Updating Facebook to 4.22
  • Manifest checks improvements
  • Fixes and improvements

2.0.0-beta (Apr 12, 2017)

  • Removing Appodeal.SKIPPABLE_VIDEO ad type. Static interstitials and skippable videos are now merged into one type: Appodeal.INTERSTITIAL
  • Adding onInterstitialFinished method to InterstitialCallbacks
  • Major native ads improvements
  • onNativeLoaded callback doesn't return loaded ads as an argument anymore, to get loaded native ads use Appodeal.getNativeAds method
  • Adding report button to all ad types, which includes network name and sdk/plugin version
  • Removing support for Android OS 2.3.x, SDK will only work on Android 4.0+
  • Many AndroidManifest and Proguard changes, please do not forget to update them
  • Removed support for AdMob Mediation and Mopub Mediation adapters
  • Adding Appodeal.canShow method which allows to test whether ad can be showed for specific placement
  • Adding Appodeal.getRewardParameters method which allows to get rewarded video reward amount and currency for a specific placement
  • Adding Appodeal.startTestActivity method which shows test activity that allows to test adapters integration
  • Adding Appodeal.getNativeAds method which allows to get loaded native ads
  • Adding Appodeal.setBannerAnimation(false) method that allows to disable banner refresh animation
  • Adding Appodeal.set728x90Banners(true) method that allows to enable 728*90 banners
  • Adding Appodeal.muteVideosIfCallsMuted(true) method that allows to mute videos ads sound if call volume is muted
  • AppodealMediaView class renamed to NativeMediaView
  • Appodeal.setOnLoadedTriggerBoth method renamed to Appodeal.setTriggerOnLoadedOnPrecache
  • NativeAd.setAppodealMediaView method renamed to NativeAd.setNativeMediaView
  • DFP integration (Interstitial, Banner, MREC)
  • IronSource integration (Interstitial, Rewarded Video)
  • Inmobi integration. Add compile 'com.squareup.picasso:picasso:2.5.2' to your Gradle file
  • Zplay integration (Interstitial, Banner, Native)
  • Adding Rewarded Video support from Facebook
  • Adding Rewarded Video support from Admob
  • Adding video native ads from Applovin
  • Adding support for playable ads
  • Frequency capping support in placements
  • Adding support for new segment features
  • Add support for new crosspromo features
  • Updating Adcolony to 3.1.1
  • Updating AmazonAds to
  • Updating Applovin to 6.3.2
  • Updating Avocarrot to 3.7.5
  • Updating Chartboost to 6.6.1
  • Updating CheetahMobile to 3.5
  • Updating Facebook to 4.19.0
  • Updating Flurry to 6.6.0
  • Updating Mopub to 4.10.0
  • Updating MyTarget to 4.5.15
  • Updating Startapp to 3.5.1
  • Updating Tapjoy to 11.8.2
  • Updating UnityAds to 2.0.5
  • Updating Vungle to 4.0.3
  • Updating Yandex Metrica to 2.62 & Yandex Ads to 2.50
  • VAST video player redesign and improvements
  • Logging improvements
  • Migrating from AsyncTasks to separate threads to improve performance
  • Imroved kids apps support
  • Adding Javadoc
  • Startap, Revmob, Tapjoy, Pubnative integration improvements
  • Detecting impression errors
  • Memory leak fixes
  • Default placement fixes
  • Banner refresh animation fix
  • Other optimizations and fixes

1.15.9 (Feb 16, 2017)

  • Fixing rare OutOfMemoryError
  • Updating Chartboost to 6.61
  • Updating YandexMetrica to 2.62 and YandexAds to 2.50. Do not forget to change metrica:api:level in AndroidManifest to 52
  • Updating Avocarrot to 3.7.6
  • Small fixes

1.15.8 (Dec 15, 2016)

  • Fixing rare ConcurrentModificationException in native ads
  • Fixing rare OutOfMemoryError in native ads
  • Fixing rare NullPointerException from Adcolony when using Google Play Services 10+
  • Banner animation fixes
  • Updating Revmob to 9.2.3 to fix banner issues
  • Updating Yandex Metrica to 2.51 & Yandex Ads to 2.31 to fix crashes on Android 7. Update your AndroidManifest
  • Adding android:hardwareAccelerated="true" to
  • Small fixes

1.15.7 (Oct 10, 2016)

  • Small fixes

1.15.6 (Oct 5, 2016)

  • Adding setLogLevel method. Available parameters: LogLevel.none, LogLevel.debug, LogLevel.verbose
  • Removing setLogging method
  • Chartboost integration fixes
  • Adding day and hour segment rules
  • Updating Proguard

1.15.5 (Sep 21, 2016)

  • Updating Unity Ads to 2.0.4

1.15.4 (Sep 16, 2016)

  • Integrating Revmob: banners, interstitials, skippable videos, rewarded videos
  • Adding per placement price floors
  • Banner change animation optimization
  • Performance optimizations
  • Updating Unity Ads to 2.0.2. AAR is no longer needed
  • Updating Proguard
  • Updating AndroidManifest

1.15.3 (Sep 6, 2016)

  • Fixing GoogleApiAvailability NoClassDefFoundError on old Google Play Services during initialization
  • Fixing rare crashes in VASTActivity
  • Renaming setCustomSegment to setCustomRule
  • Adding rewarded videos from Tapjoy. Do not forget to add new activities in AndroidManifest
  • Adding support for refresh period in banners and MRECs configured using placements
  • Sending pricefloor on impression with our offers to improve second price calculation
  • Minor fixes
  • Updating Avocarrot to 3.7.3
  • Updating Tapjoy to 11.8.0
  • Updating MyTarget to 4.5.10
  • Updating Chartboost to 6.5.1
  • Updating Amazon Ads to 5.8.1
  • Updating Applovin to 6.3.0
  • Updating Flurry to 6.5.0

1.15.2 (Aug 12, 2016)

  • Fixing NPE in cases where some network SDKs are not present

1.15.1 (Aug 08, 2016)

  • Removing Inmobi SDK. Do not forget to remove inmobi receivers from manifest
  • Adding support of videos from MyTarget
  • Dex loading improvements
  • Keeping screen on during video playback
  • Adding support for disabling network by ad type in segments
  • Adding container interface for native ads
  • Updating Unity Ads to 1.5.8
  • Updating Adcolony to 2.3.6
  • Update MyTarget to 4.5.6
  • Updating Startapp to 3.4.3
  • Updating Applovin to 6.2.4
  • Adding Cheetah Mobile Ads SDK

1.15 (June 24, 2016, Internal)

  • Adding video native ads. Use AppodealMediaView to show video in your native ads
  • Adding setAppodealMediaView and containsVideo methods to NativeAd object
  • Adding Appodeal.setNativeAdType method to change video native ads settings
  • Renaming setAutoCacheNativeImages to setAutoCacheNativeMedia
  • Updating segment when using setCustomSegment method
  • Fixes
  • Updating Mopub to 4.7.1
  • Updating MyTarget to 4.5.0
  • Updating Avocarrot to 3.7.2
  • Updating Facebook to 4.12.1
  • Removing setVkId and setFacebookId methods from UserSettings
  • Adding to manifest

1.14.15 (June 17, 2016)

  • Adding setSmartBanners method to enable/disable smart banners (Enabled by default)
  • Adding set728x90Banners method to enable/disable 728*90 banners (Disabled by default)
  • Minor fixes
  • Adding banner and mrec precache
  • onBannerLoaded(int height) -> onBannerLoaded(int height, boolean isPrecache). setOnLoadedTriggerBoth, isPrecache
  • onMrecLoaded() -> onMrecLoaded(boolean isPrecache). setOnLoadedTriggerBoth, isPrecache
  • Adding autocaching in native ads, enabled by default. One ad is requested after initialization. setAutoCache
  • Support for campaign frequency for cross promo
  • Performance optimization
  • Removing Appodeal.BANNER_CENTER
  • Fixes:
  • Updating Inmobi to 5.3.1
  • Updating Yandex Ads to 2.12
  • Updating Vungle to 3.3.5
  • Updating Startap to 3.4.2
  • Updating Applovin to 6.2.2
  • Updating Mopub to 4.6.1
  • Updating Amazon to 5.7.2
  • Updating Facebook to 4.12
  • Updating MyTarget to 4.5.1. Rename activity to Fixes the issue with URL credentials alert in Google Play
  • Updating Avocarrot to 3.7.0
  • Changing Proguard

1.14.14 (May 04, 2016)

  • Adding setSmartBanners method to enable/disable smart banners (Enabled by default)
  • Adding set728x90Banners method to enable/disable 728*90 banners (Disabled by default)
  • Minor fixes

1.14.13 (May 01, 2016)

  • Adding boolean flag to onSkippableVideoClosed, onRewardedVideoClosed, onNonSkippableVideoClosed which equals true if video was finished
  • Updating YandexMetrica to 2.41 and YandexAds to 2.11. Do not forget to change metrica:api:level in AndroidManifest to 44
  • Updating Amazon to
  • Updating Inmobi to 5.3.0
  • Updating Avocarrot to 3.6.1
  • Updating Adcolony to 2.3.5
  • Integarting Applovin native ads over API
  • Removing isLoadedWithPriceFloor method
  • Fixes to banner refresh animation
  • AndroidManifest changes
  • Proguard changes
  • Minor fixes

1.14.12 (April 10, 2016)

  • Minor fixes

1.14.11 (April 4, 2016)

  • Adding Appodeal.disableWriteExternalStoragePermissionCheck() method. Disables all ad networks that need this permission may lead to low video fillrate
  • Adding toast on initialization if support-v7-recyclerview is missing for native ads
  • Adding getAgeRestrictions method for native ads. Optional, may return null
  • Cleaning video cache automatically
  • Adding video, interstitials and banner from Flurry
  • Keeping screen on during video playback
  • Updating Startapp to 3.3.2
  • Updating Avocarrot to 3.6.0
  • Updating Facebook to 4.10.1
  • Updating Mailru to 4.3.10
  • Updating Yandex Metrica to 2.32 and Yandex Ads to 2.02. Do not forget to change metrica:api:level in AndroidManifest
  • Updating Chartboost to 6.4.1
  • Updating Adcolony to 2.3.4
  • Updating MoPub to 4.5.0
  • Updating android-support-v4 to 23.1.1
  • Updating android-support-v7-recyclerview to 23.1.1
  • Removing Pubnative aar and integrating over API
  • AndroidManifest changes
  • Minor fixes

1.14.10 (March 14, 2016)

  • Minor fixes
  • Updating Inmobi to 5.2.3

1.14.9 (March 7, 2016)

  • Native ads fixes

1.14.8 (February 26, 2016)

  • Minor fixes

1.14.7 (February 22, 2016, Internal)

  • Performance improvements
  • Replacing Liverail with Facebook, do not forget to update your AndroidManifest.xml
  • Native ads fixes
  • Updating Startapp to 3.3.1
  • Updating Vungle to 3.3.4
  • Updating Mailru to 4.3.6
  • Updating Yandex to 2.01
  • Updating Chartboost to 6.3.0
  • Updating Inmobi to 5.2.1
  • Removing showWithPriceFloor(soon to be replaced with placements)
  • unRegisterViewForInteraction no longer requires View as argument

1.14.6 (January 30, 2016)

  • Minor fixes

1.14.5 (January 29, 2016)

  • Minor fixes

1.14.4 (January 27, 2016, Internal)

  • Adding native templates
  • Minor fixes

1.14.3 (January 23, 2016, Internal)

  • Adding MoPub Banner Adapter
  • Updating Avocarrot to 3.5.4
  • Minor fixes

1.14.2 (January 20, 2016)

  • Small fixes
  • Adding new entries to Proguard
  • Adding new entries to AndroidManifest

1.14.1 (January 18, 2016, Internal)

  • Updating Chartboost to 6.2.0
  • Updating Inmobi to 5.2.0
  • Updating YandexMetrica to 2.30 and YandexAds to 2.00
  • Updating Flurry to 6.2.0

1.14 (January 10, 2016, Internal)

  • Adding native ads, Appodeal.NATIVE
  • Adding 300*250 banners, Appodeal.MREC
  • Updating Applovin to 6.1.5
  • Updating Avocarrot to 3.5.3
  • Updating Startapp to 3.3.0
  • Updating Mailru to 4.2.0
  • Updating UnityAds to 1.5.6
  • Updating MoPub to 4.3.3
  • Bug fixes

1.13.11 (December 7, 2015, Internal)

  • Improving video fillrate
  • Adding rewarded video from MoPub
  • Removing Appodeal.ALL constant
  • Renaming Appodeal.VIDEO to Appodeal.SKIPPABLE_VIDEO
  • Renaming VideoCallbacks to SkippableVideoCallbacks
  • Adding Appodeal.NON_SKIPPABLE_VIDEO alias for Appodeal.REWARDED_VIDEO
  • Adding NonSkippableVideoCallbacks
  • Adding alert dialog when using Appodeal.NON_SKIPPABLE_VIDEO, to disable use Appodeal.confirm(Appodeal.SKIPPABLE_VIDEO)
  • Updating Chartboost to 6.1.0
  • Updating Liverail to 4.7.0
  • Bug fixes

1.13.10 (November 18, 2015)

  • Fixing issue with rewarded video were onVideoFinished callback will not trigger in some cases
  • Renaming rewarded video callbacks:
  • onVideoLoaded -> onRewardedVideoLoaded
  • onVideoFailedToLoad -> onRewardedVideoFailedToLoad
  • onVideoShown -> onRewardedVideoShown
  • onVideoFinished -> onRewardedVideoFinished
  • onVideoClosed -> onRewardedVideoClosed

1.13.9 (November 14, 2015)

  • Adding banner fadeout animation
  • Updating Mailru to 4.1.2
  • Updating Startapp to 3.2.2
  • Updating Vungle to 3.3.3
  • Updating Chartboost to 6.0.2 (Make sure to copy CBImpressionActivity from AndroidManifest docs)
  • Fixing issues with Liverail banners and interstitials crashes
  • Proguard changes
  • Various fixes

1.13.7 (October 27, 2015)

  • Removing default Appodeal.initialize(activity, appKey) method, use Appodeal.initialize(activity, appKey, adTypes) method instead. To initialize banner, interstitials and rewarded video use Appodeal.initialize(activity, appKey, Appodeal.BANNER | Appodeal.INTERSTITIAL | Appodeal.REWARDED_VIDEO)
  • Various fixes

1.13.6 (October 23, 2015, Internal)

  • Adding Appodeal.trackInAppPurchase() method
  • Adding Liverail video
  • Various fixes

1.13.5 (October 19, 2015, Internal)

  • Adding separate ad type Appodeal.REWARDED_VIDEO for rewarded videos
  • Android M support
  • Triggering onLoad callback when cache is called if ad is already loaded
  • Adding Appodeal.setLogging(true) method to enable logging
  • Appodeal.disableNetwork() method now accepts optional adType and allows to diable specific network for on or more ad types. Should be used before initialization
  • Adding StartApp interstitials, banners and rewarded videos
  • Adding Yandex interstitials and banners
  • Adding Inneractive interstitials and banners
  • Adding rewarded video from Vungle
  • Replacing Facebook with LiveRail, do not forget to remove facebook.jar
  • Using separate dex file for each ad network
  • Updating Applovin to 6.1.4
  • Updating Mailru to 4.1.1
  • Updating MoPub to 4.0.0
  • Updating Unity Ads to 1.5.3
  • Adding new entries to Proguard
  • Adding new entries to AndroidManifest
  • Fixing bug when banners sometimes would appear on screen rotate
  • Various fixes

1.13.1 (August 18, 2015)

  • Small fixes

1.13 (August 14, 2015, Internal)

  • General:
  • Decreasing network traffic from and to Appodeal servers
  • Appodeal.cache() method will not work if autocache is enabled
  • | VIDEO) will show 3s loader if ad is not cached yet
  • Impression and click stats will not be tracked when test mode is enabled
  • support-v4 library is now needed
  • Loading new networks from dex file to solve 65k method limit
  • Context added as first argument of Appodeal.disableNetwork() method.
  • Interstitials:
  • Adding Facebook and Appnexus interstitials
  • Banners:
  • Adding Facebook and Appnexus banners
  • Removing Applovin banners
  • Caching next banner after show
  • Refreshing Admob smart banner on orientation change
  • Video:
  • Adding unskippable videos support. To change which videos to show go to app settings in dashboard.
  • Adding rewarded video from Chartboost, Applovin and UnityAds
  • Adding unskippable video from MoPub
  • Adding Vungle support (Only skippable)
  • Adding Andcolony support (Skippable and V4VC)
  • Adding video without end screen banner support (Currently only from MoPub). To change which videos to show go to app settings in dashboard.
  • Fixes to increase video fillrate
  • Libraries updates:
  • Updating Chartboost to 5.5.3
  • Updating Applovin to 6.0.1
  • Updating MoPub to 3.10.0
  • Fixes:
  • General fillrate fixes
  • Centering fixes in some interstitials

1.12.9 (July 2, 2015, Internal)

  • Updating Unity Ads to 1.4.7
  • Updating Mailru to 4.0.13
  • Fixing MoPub NullPointerException

1.12.8 (June 30, 2015)

  • Small fixes

1.12.7 (June 23, 2015)

  • Updating Unity Ads library to 1.4.4
  • Updating Mailru library to 4.0.11
  • Adding new meta-data entry com.appodeal.framework to AndroidManifest
  • Fixing banner refresh if banner failed to load
  • Banner related fixes

1.12.6 (June 18, 2015)

  • Fixing "for kids" setting
  • Fixing bug related to showing banner in dynamic View

1.12.5 (June 16, 2015)

  • Bug fixes

1.12.4 (June 15, 2015, Internal)

  • Bug fixes

1.12.3 (June 13, 2015, Internal)

  • Adding Mailru banners and interstitials support
  • Adding MoPub video support
  • Adding Applovin video support
  • Removing Supersonic library from SDK. Do not forget to remove Supersonic entries from AndroidManifest.xml
  • Running callbacks on UI thread
  • Adding ability to disable specific ad type from dashboard (coming soon!)
  • Adding Admob banner mediation
  • Adding getBannerView method which return View with banner in it (Call, BANNER_VIEW) after getBannerView)
  • Adding isLoadedWithPriceFloor method for interstitials
  • Adding getVersion method
  • Adding setTesting(true) method to show test ads and write to debug log
  • Renaming method Appodeal.orientationChange to Appodeal.onResume. This method should be called in onResume method of you activity if banner dissappears on orientation change
  • Not showing banner if view wasn't found (BANNER_VIEW only)
  • Updating MoPub library to 3.8.0
  • Updating Chartboost library to 5.4.1
  • Updating Amazon library to 5.6.20
  • Updating Unity Ads library to 1.4.2
  • Banner fillrate fixes
  • Fixing centering in some banners
  • Disabling SDK on devices < 2.3 to prevent crashing
  • Bug fixes

1.12.2 (May 15, 2015)

  • Adding Smaato banners support
  • Adding Appodeal.disableLocationPermissionCheck()
  • Sending video finished stats to server
  • Bug fixes

1.12.1 (May 14, 2015, Internal)

  • Adding MoPub banners support
  • Adding TapSense banners support
  • Bug fixes

1.12 (May 12, 2015, Internal)

  • Adding banners support (Admob, Amazon, Applovin)
  • Adding banners callbacks
  • Adding banners position customization
  • Adding new ad types parameters:
  • Appodeal.BANNER
  • Appodeal.BANNER_BOTTOM
  • Appodeal.BANNER_TOP
  • Appodeal.BANNER_CENTER
  • Appodeal.BANNER_VIEW

1.11.2 (May 4, 2015)

  • Adding ad types parameters:
  • Appodeal.VIDEO
  • Appodeal.ALL and Appodeal.ANY - combination of all currently supported and future ad types
  • Ad types can be combined using "|" operator. For example Appodeal.INTERSTITIAL | Appodeal.VIDEO
  • Appodeal.initialize method will initialize interstitials and videos. To initialize only one use initialize with adType parameter
  • Removing initialization with callbacks. Use setInterstitialCallbacks and setVideoCallbacks
  • Removing showBanner method. Use show with adType parameter
  • Removing cacheBanner method. Use cache with adType parameter
  • Removing showBannerWithPriceFloor method. Use showWithPriceFloor with adType parameter(Currently supported only for interstitials)
  • isLoaded now takes adType parameter
  • isLoadedPrecache renamed to isPrecache that takes adType parameter(Currently supported only for interstitials)
  • setAutoCache now takes adType parameter
  • setOnLoadedTriggerBoth now takes adType parameter(Currently supported only for interstitials)
  • Updating MoPub library to 3.7.0
  • Fixing ad centering issue on new versions of Android WebView
  • isLoaded now returns false if autocache is disabled and ad is expired(OpenX ads only, they expire 4 minutes after cache)

1.11.1 (Apr 28, 2015, Internal)

  • Renaming interstitial callbacks from onAd... to onInterstitial...
  • Removing the need for android-support-v4.jar for SDK functionality. If your app doesn't need it function properly and you do not use SDKs that require it you can delete the android-support-v4.jar
  • Checking if loaded Applovin ad is video to prevent video display when interstitial is expected
  • Removing Facebook Audience Network library from SDK. Do not forget to remove Facebook entries from AndroidManifest.xml
  • Removing Mobilecore library from SDK. Do not forget to remove Mobilecore entries from AndroidManifest.xml
  • Fixing an issue where SDK will not work on Android 4.0.4 in Unity apps in some cases

1.11 (Apr 21, 2015, Internal)

  • Adding video support
  • Adding video callbacks
  • Adding Unity Ads support
  • Removing the need of applovin.sdk.key in AndroidManifest.xml
  • Changing debug file from "110" to "1100"
  • renamed to
  • added to AndroidManifest.xml


  • Adding Appodeal.showBannerWithPriceFloor() method that displays banner only if it's ecpm is bigger or equal to price floor set in our dashboard
  • Fixing issue with SDK pausing when switching between activities
  • Bug fixes


  • Adding Facebook Audience Network support
  • Adding Mobilecore support
  • Adding Admob Adapter
  • Preventing Appodeal methods from being called in Unity Editor


  • MoPub click url fix


  • Removing Heyzap library from SDK. Do not forget to remove Heyzap entries from AndroidManifest.xml
  • Updating AmazonAds library to 5.5.102
  • Updating Chartboost library to 5.2.0
  • Updating MoPub library to 3.6.1
  • Bug fixes


  • Setting timeout for each network and precache load
  • Pausing SDK when app goes to background on Android 4.0+
  • Resuming SDK when app returns to foreground on Android 4.0+
  • Bug fixes


  • showBanner() now returns a boolean value indicating whether show call was passed to appropriate SDK
  • Retrying ad caching if network connection was lost
  • Bug fixes


  • Displaying toast message if android-support-v4.jar library not present
  • Fixing Heyzap integration issue
  • Adding Appodeal.isLoadedPrecache() method that returns whether precache or normal ad was loaded
  • Adding Appodeal.disableNetwork(String) method to disable network. Available parameters: "admob", "amazon_ads", "applovin", "chartboost", "heyzap", "mopub"
  • Fixes and performance optimizations


  • Adding MoPub adapter to SDK


  • Adding boolean parameter to onAdLoaded callback. If true precache was loaded, if false normal ad was loaded. By default onAdLoaded callback triggers only when normal ad was loaded.
  • Adding Appodeal.setOnLoadedTriggerBoth() method.
  • setOnLoadedTriggerBoth(false) - onAdLoaded will trigger only when normal ad was loaded.
  • setOnLoadedTriggerBoth(true) - onAdLoaded will trigger twice, both when precache and normal ad were loaded


  • Fixing onAdClosed not triggering bug
  • Preventing onAdFailedToLoad from triggering if precache was loaded
  • Small fixes


  • Adding Admob precache to make ads load faster
  • Updating Applovin library to 5.4.3
  • Updating Chartboost library to 5.1.2
  • Updating MoPub library to 3.5.0
  • Bug fixes and some architectural changes
  • Increasing support on devices without GPS. Add
<uses-feature android:name="android.hardware.location" android:required="false" />
<uses-feature android:name="" android:required="false" />
  • to your AndroidManifest.xml if you don't require this hardware features to make app compatible with devices without GPS


  • Adding cacheBanner method to manually cache banner. You should disable automatic caching before SDK initialization using setAutoCache(false)
  • Adding setAutoCache method to enable or disable automatic caching. Should be used before SDK initialization.


  • Adding Unity callbacks
  • Updating MoPub library to 3.4.0
  • Bug fixes


  • Adding Smaato support
  • Adding Heyzap support