SDK Integration | Appodeal Intelligent Ad Mediation

SDK Integration

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 Admob.com.

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

INSTALL EXTENSION


The extension source code is available at https://github.com/appodeal/admob-configurator.

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.

VIDEO TUTORIAL

Download and integrate SDK

To get the beta Appodeal SDK 2.4.1 with major native ads improvements, segment v2 support, GDPR compliance and Parallel bidding support click the button below:

Android SDK 2.4.1

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

using MultiDex

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

not using MultiDex

Demo

Include Google Play Services lib (12.0.0 and up only) in your project:

Make sure you are using third party libraries from downloaded archive.

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:

AdColony Support

Please note that AdColony v3.x and higher uses NDK libraries for all currently supported architectures.

If you are using some native libraries please check architectures used by them and add abi filters to exclude architectures that supported by adcolony but missing from those libraries by using this gradle parameter:

Currently supported AdColony architectures: armeabi, armeabi-v7a, arm64-v8a, x86, x86_64.

Our sdk uses Android Support Library

They are used by most nested SDKs to support compatibility.

You can add them from the optional folder

  • android-support-v4-23.1.1.jar
  • android-support-v7-recyclerview-23.1.1.jar

or you can use any newer version of this library.

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

General Data Protection Regulation (GDPR) compliance

Publishers need to update their apps to collect user consent prior to initializing our SDK (Read our guide on collecting consent here). Publisher need to pass boolean consent flag(with 'false' meaning that user declined to give consent) to Appodeal.initialize() method in our SDK.

AndroidManifest.xml

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

Add the following under application tag:

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.hardware.location.network" android:required="false" />

In the "optional” folder there are additional SDKs and libraries

  • picasso-2.5.2.jar
  • The InMobi SDK for Android uses the popular Picasso library for loading the ad assets.

  • flurry-ads-10.1.0.jar

    flurry-analytics-10.1.0.jar

  • You can add the Flurry SDK. To do this, place the files from the "optional" folder of the SDK archive into the libs folder of your application.

    If you do not want to add the Flurry SDK, please delete following activities from AndroidManifest.xml:

  • ogury-2.1.15.jar
  • You can add the Ogury SDK. To do this, place the file from the "optional" folder of the SDK archive into the libs folder of your application.

    If you do not want to add the Ogury SDK. please delete the following to your AndroidManifest.xml under application tag:

Android Integration

Ad Types

Appodeal.INTERSTITIAL

Appodeal.REWARDED_VIDEO

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

Appodeal.BANNER

Appodeal.NATIVE

Appodeal.MREC - is deprecated, should use native ads instead.

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:

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

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

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

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

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

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

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

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:

@Override
public void onResume() {
  super.onResume();
  Appodeal.onResume(this, Appodeal.BANNER);
}

Display Ad

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

Appodeal.show(this, adTypes);

Appodeal.show() returns a boolean value indicating whether show call was passed to appropriate SDK

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

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

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

To display interstitial or rewarded video: use Appodeal.show(this, Appodeal.INTERSTITIAL | Appodeal.REWARDED_VIDEO);

To display banner at the bottom of the screen: use Appodeal.show(this, Appodeal.BANNER_BOTTOM);

To display banner at the top of the screen: use Appodeal.show(this, Appodeal.BANNER_TOP);

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

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

Interstitial

5.4.1. Display interstitial

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

Appodeal.show(this, Appodeal.INTERSTITIAL);

5.4.2. Checking if interstitial is loaded

Appodeal.isLoaded(Appodeal.INTERSTITIAL);

5.4.3. Using Interstitial callbacks

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

Rewarded Video

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

Appodeal.show(this, Appodeal.REWARDED_VIDEO);

5.5.1. Checking if rewarded video is loaded

Appodeal.isLoaded(Appodeal.REWARDED_VIDEO);

5.5.2. Using rewarded video callbacks

5.5.3. 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.

{http://example.com/reward}?data1={data1}&data2={data2}

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: reward.java

Sample in Node.js: reward.js

Sample in Python 3: reward.py

Sample in C#: reward.cs

5.5.4. Getting reward data for placement

To get placement reward data before video is shown use:

Appodeal.getRewardParameters(placementName)

This method returns Pair with reward amount and currency

Native Ads

5.6.1. Caching native

To cache native ads use:

5.6.2. Caching multiple native ads

To cache multiple native ads use:

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

5.6.3 Check if NativeAd was loaded

5.6.4. Get loaded native ads

To get loaded native ads use the following method:

This method returns List with up to amount loaded native ads

5.6.5. Native ads callbacks

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

5.6.6. 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

Appodeal.setAutoCacheNativeIcons(false);
Appodeal.setAutoCacheNativeMedia(false);

5.6.7. Native video

To show video native ads you should use NativeMediaView. If where is no video on NativeAd object, main image will be shown automatocally.

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

5.6.8. 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. Should always be displayed. Max length 25 symbols.

nativeAd.getCallToAction() - String. Call to action text. Mandatory. Should be displayed. Max length 25 symbols.

nativeAd.getDescription() - String. Text description of native ad. Optional. Max length 100 symbols.

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. Deprecated, should use NativeMediaView to show main image or video.

nativeAd.getProviderView(context) - View. If returned view is not null it is mandatory to display it in any corner of native ad. 

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

nativeAd.isPrecache() - Boolean. Returns true if NativeAd is precache.

nativeAd.getAdProvider() - Boolean. Return ad provider name.

nativeAd.destroy() - Destroy Native ad and unregister from tracking. You can't use this instance on NativeAd after call destroy().

5.6.9. 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.

5.6.10. Using templates

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:

<com.appodeal.ads.native_ad.views.NativeAdViewNewsFeed
android:id="@+id/native_ad_view_news_feed"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginBottom="10dp">
</com.appodeal.ads.native_ad.views.NativeAdViewNewsFeed>

<com.appodeal.ads.native_ad.views.NativeAdViewAppWall
android:id="@+id/native_ad_view_app_wall"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_marginBottom="10dp">
</com.appodeal.ads.native_ad.views.NativeAdViewAppWall>

<com.appodeal.ads.native_ad.views.NativeAdViewContentStream
android:id="@+id/native_ad_view_content_stream"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginBottom="10dp">
</com.appodeal.ads.native_ad.views.NativeAdViewContentStream>

And when you need to show an ad:

NativeAdViewNewsFeed nav_nf = (NativeAdViewNewsFeed) mActivity.findViewById(R.id.native_ad_view_news_feed);
nav_nf.setNativeAd(mNativeAd);

NativeAdViewAppWall nav_aw = (NativeAdViewAppWall) mActivity.findViewById(R.id.native_ad_view_app_wall);
nav_aw.setNativeAd(mNativeAd);

NativeAdViewContentStream nav_cs = (NativeAdViewContentStream) mActivity.findViewById(R.id.native_ad_view_content_stream);
nav_cs.setNativeAd(mNativeAd);

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

RelativeLayout holder = (RelativeLayout) mActivity.findViewById(R.id.native_template_holder);
NativeAdViewAppWall nativeAdView = new NativeAdViewAppWall(mActivity, mNativeAd);
holder.addView(nativeAdView);

Template elements:

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

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

nav.showSponsored(true)

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

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

5.6.11. Using custom layout

nativeAdView = (NativeAdView) findViewById(R.id.native_layout)
TextView tvTitle = (TextView) nativeAdView.findViewById(R.id.tv_title);
tvTitle.setText(nativeAd.getTitle());
nativeAdView.setTitleView(tvTitle);

TextView tvDescription = (TextView) nativeAdView.findViewById(R.id.tv_description);
tvDescription.setText(nativeAd.getDescription());
nativeAdView.setDescriptionView(tvDescription);

RatingBar ratingBar = (RatingBar) nativeAdView.findViewById(R.id.rb_rating);
if (nativeAd.getRating() == 0) {
	ratingBar.setVisibility(View.INVISIBLE);
} else {
	ratingBar.setVisibility(View.VISIBLE);
	ratingBar.setRating(nativeAd.getRating());
	ratingBar.setStepSize(0.1f);
}
nativeAdView.setRatingView(ratingBar);

Button ctaButton = (Button) nativeAdView.findViewById(R.id.b_cta);
ctaButton.setText(nativeAd.getCallToAction());
nativeAdView.setCallToActionView(ctaButton);

ImageView icon = (ImageView) nativeAdView.findViewById(R.id.icon);
icon.setImageBitmap(nativeAd.getIcon());
nativeAdView.setIconView(icon);

View providerView = nativeAd.getProviderView(mNativeListView.getContext());
if (providerView != null) {
	if (providerView.getParent() != null && providerView.getParent() instanceof ViewGroup) {
		((ViewGroup) providerView.getParent()).removeView(providerView);
	}
	FrameLayout providerViewContainer = (FrameLayout) nativeAdView.findViewById(R.id.provider_view);
	ViewGroup.LayoutParams layoutParams = new ViewGroup.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT);
	providerViewContainer.addView(providerView, layoutParams);
}
nativeAdView.setProviderView(providerView);

TextView tvAgeRestrictions = (TextView) nativeAdView.findViewById(R.id.tv_age_restriction);
if (nativeAd.getAgeRestrictions() != null) {
	tvAgeRestrictions.setText(nativeAd.getAgeRestrictions());
	tvAgeRestrictions.setVisibility(View.VISIBLE);
} else {
	tvAgeRestrictions.setVisibility(View.GONE);
}
NativeMediaView nativeMediaView = (NativeMediaView) nativeAdView.findViewById(R.id.appodeal_media_view_content);
nativeAdView.setNativeMediaView(nativeMediaView);

nativeAdView.registerView(nativeAd);

To show NativeAd in custom layout you should use NativeAdView, populate and register the asset views.

Bind assets view to NativeAdView:

nativeAdView.setTitleView(View view)
nativeAdView.setRatingView(View view)
nativeAdView.setDescriptionView(View view)
nativeAdView.setImageView(View view)
nativeAdView.setIconView(View view)
nativeAdView.setProviderView(View view)
nativeAdView.setNativeMediaView(NativeMediaView nativeMediaView)

And register NativeAd object in NativeAdView

If another NativeAd was registered to this instance of view, it wil be automatically unregistered.

To unregister NativeAd from NativeAdView call:

nativeAdView.unregisterViewForInteraction()

If NativeAdView is reused to display the same ad or to display other ads, it's better call the unregisterViewForInteraction() method before you can register the same view with another instance of NativeAd.

To destroy NativeAd that was registered to NativeAdView, you must call

You can't use this instance on NativeAdView after call destroy(). You should hide this view or register another NativeAd.

5.6.12. Native Ad integration example

5.6.13. Native Ad integration to the feed

You can use this example to integrate Naitve Ad to existed feed in your application:

To use this wrapper adapter you should create new instance of AppodealWrapperAdapter:

And set this wrapper adapter to your recycler view.

Banner 300*250 (MREC)

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

Add com.appodeal.ads.MrecView to your layout file:

<com.appodeal.ads.MrecView
  android:id="@+id/appodealMrecView"
  android:layout_width="300dp"
  android:layout_height="250dp"
  android:layout_centerInParent="true"
  android:visibility="gone" />

Set view id before SDK initialization

Appodeal.setMrecViewId(R.id.appodealMrecView);

Now you can show banner in the view specified:

Appodeal.show(this, Appodeal.MREC);

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

Appodeal.hide(this, Appodeal.MREC);

5.7.3. Destroying cached MREC

Appodeal.destroy(Appodeal.MREC)

5.7.4. Using MREC callbacks

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

5.7.5. Using programmatically created 300*250 banner view

Create banner view

Appodeal.getMrecView(this);

Add view to your layout and then show banner in it:

Appodeal.show(this, Appodeal.MREC);

Banner

5.8.1. Display banner at the bottom of the screen

Appodeal.show(this, Appodeal.BANNER_BOTTOM);

5.8.2. Display banner at the top of the screen

Appodeal.show(this, Appodeal.BANNER_TOP);

5.8.3. Display banner in the view specified in layout file

Add com.appodeal.ads.BannerView to your layout file:

<com.appodeal.ads.BannerView 
  android:id="@+id/appodealBannerView"  
  android:layout_width="match_parent" 
  android:layout_height="wrap_content" 
  android:visibility="gone" />

Set view id before SDK initialization

Appodeal.setBannerViewId(R.id.appodealBannerView);

Now you can show banner in the view specified:

Appodeal.show(this, Appodeal.BANNER_VIEW);

5.8.4. Using programmatically created banner view

Create banner view

Appodeal.getBannerView(this);

Add view to your layout and then show banner in it:

Appodeal.show(this, Appodeal.BANNER_VIEW);

5.8.5. Hiding banner

Appodeal.hide(this, Appodeal.BANNER);

5.8.6. Destroying cached banner

Appodeal.destroy(Appodeal.BANNER)

5.8.7. Using banner callbacks

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

5.8.8. Enabling 728*90 banners

To enable 728*90 banner use the following method:

Appodeal.set728x90Banners(true);

5.8.9. Disabling banner refresh animation

To disable banner refresh animation use:

Appodeal.setBannerAnimation(false);

5.8.10. Disabling smart banners

Appodeal.setSmartBanners(false);

Disables smart banners, enabled by default

Advanced Features

Enabling test mode

Appodeal.setTesting(true);

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

Enabling logging

Appodeal.setLogLevel(Log.LogLevel.debug);

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

Appodeal.isPrecache(adTypes);

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)

Checks if ad type was initialised

Appodeal.isInitialized((Activity)this, adType);

Return true if ad type was initialised before

Checks caching type for ad type

Appodeal.isAutoCacheEnabled((Activity)this, adType);

Return true if auto cache enabled for this ad type

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

Appodeal.setChildDirectedTreatment(true);

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:

@Override
public void onResume() {
  super.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", "mobvista", "mailru", "mmedia", "mopub", "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);

Example:

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:

Appodeal.disableLocationPermissionCheck();

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:

Appodeal.disableWriteExternalStoragePermissionCheck();

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(){
  @Override
  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");
    }
  }

  @Override
  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

Appodeal.muteVideosIfCallsMuted(true)

Setting User Data

Initialization

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.

userSettings.setAge(25);

Specify gender of the user

userSettings.setGender(UserSettings.Gender.FEMALE);

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

Segments and Placements

Segments

Segments are used to track statistics for various user categories and to manage ads for these categories. A segment is a fraction of audience unified by filters: e.g. by gender, age or any other parameter known to the app and directed to Appodeal SDK.

You can read more in our Knowledge base.

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

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

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


Manual Filters allows to groups users by any available characteristics. E.g. you know the sources that directed users to you and you want to track the statistics for such users — group them into a segment.

To create such a segment you have to give our SDK the name or the criterion and an actual value for it. Value can be boolean, numeric or string-based.

You can check more examples here

Bought Inapps allows to group users by the fact of purchasing in-apps. This will help you adjust the ads for such users or simply turn it off, if needed.

To make this setting work correctly, please submit the purchase info via Appodeal SDK.

You can check more examples here

Placements

Placements allow you to separate ads impressions by places where it was shown.

You can read more in our Knowledge base

To show an ad with placement, you have to call show method like this:

Appodeal.show(this, adTypes, placementName);

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

Appodeal.canShow(adTypes, placementName)

You can use "default" placement or create new in application settings.

If you have no placement, or call Appodeal.show 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.

Proguard Settings

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

Third-party SDKs versions

NetworkSDK version
Adcolony3.3.0
Admob15.0.0
Amazon Ads5.8.1.1
Applovin8.0.0
Chartboost 7.2.0
Facebook Audience Network4.27.0
Flurry 10.1.0
Inmobi7.1.0
IronSource6.7.6
Mobvista8.11.0
myTarget4.7.2
Mopub4.15.0
Ogury2.1.15
Startapp3.8.4
Tapjoy11.11.1
Unity Ads2.1.2
Vungle6.2.5
Yandex Metrica2.80
Yandex Mobile Ads2.62

Changelog

2.4.1 (19 May, 2018)

  • Support General Data Protection Regulation (GDPR) compliance
  • Mobvista updated to 8.11.0
  • Startapp updated to 3.8.4
  • Inmobi updated to 7.1.0
  • Applovin update to 8.0.0
  • Chartboost updated to 7.2.0
  • Vungle updated to 6.2.5
  • Flurry updated to 10.1.0
  • Appnext removed
  • Avocarrot removed
  • Millennial Media removed

2.4.0 (April 28, 2018)

  • Parallel bidding support
  • Applovin updated to 7.8.5

2.3.3 (17 May, 2018)

  • Support General Data Protection Regulation (GDPR) compliance
  • Mobvista updated to 8.11.0
  • Startapp updated to 3.8.4
  • Inmobi updated to 7.1.0
  • Applovin update to 8.0.0
  • Chartboost updated to 7.2.0
  • Vungle updated to 6.2.5
  • Flurry updated to 10.1.0
  • Appnext removed
  • Avocarrot removed
  • Millennial Media removed

2.3.2 (May 7, 2018)

  • Fix MaxDex build (If you're not using MultiDex in your application and encountering 65K methods limit)
  • Support new D8 compiler

2.3.1 (April 27, 2018)

  • Mobvista updated to 8.9.0
  • Add force test mode support
  • Ogury is no longer optional
  • Support play services version 12.0.0 and above (for Admob rewarded video)

2.3.0 (February 27, 2018)

  • Segment V2 support 

  • Yandex metrica updated to 2.80

  • Inmobi updated to 7.0.2

  • Flurry updated to 8.2.0

  • Adcolony updated to 3.3.0

  • Startapp updated to 3.6.9

  • Applovin updated to 7.7.0

  • Appnext updated to 2.1.1.436

  • Chartboost updated to 7.0.1

  • Ironsource updated to 6.7.6

  • myTarget updated to 4.7.2

  • Tapjoy updated to 11.11.1

  • Unity ads updated to 2.1.2

  • Vungle updated to 5.3.2

2.2.3 (February 13, 2018)

  • Fix loading assets in Native Ad
  • Fix permission check in Native Ad

2.2.2 (January 22, 2018)

  • NativeAd fixes

2.2.1 (December 27, 2017)

  • Yandex Metrica updated to 2.78
  • Yandex Mobile Ads SDK updated to 2.62
  • Vungle updated to 5.3.0
  • Facebook Audience Network updated to 4.27.0
  • Add AOL api integration (banner and interstitial)

2.2.0 (December 07, 2017)

  • NativeAd integration changed
  • MREC ad type is deprecated, should use NativeAd instead
  • Startapp updated to version 3.6.7
  • Inmobi updated to version 6.2.4
  • Yandex Metrica updated to version 2.76
  • Yandex Mobile Ads SDK updated to version 2.61
  • Mobvista updated to version 8.3.7
  • Applovin updated to version 7.5.0
  • Chartboost updated to version 7.0.0
  • Facebook Audience Network updated to version 4.26.1
  • IronSource updated to version 6.7.3
  • myTarget updated to version 4.6.19
  • Bug fixes

Changelog

2.4.9 (5 December, 2018)

  • Facebook update to 5.1.0
  • Mobvista update to 9.0.0
  • Add availability to set required MediaAssetType for Native ads

2.4.8 (17 October, 2018)

  • Yandex Metrica update to 3.2.2
  • Yandex Mobile Ads updated to 2.75
  • Add AndroidX support

2.4.6 (3 September, 2018)

  • Admob update: implement UnifiedNativeAd API for native ad

2.4.5 (9 August, 2018)

  • Amazon Ads updated to 5.9.0
  • Applovin updated to 8.0.2
  • Flurry updated to 11.0.0
  • Inmobi updated to 7.1.1
  • Mobvista updated to 8.11.3
  • Mopub updated to 5.1.0
  • Ogury updated to 3.0.13
  • Startapp updated to 3.9.3
  • Unity Ads updated to 2.2.1
  • Vungle updated to 6.3.12
  • Yandex Mobile Ads updated to 2.72
  • add getAvailableNativeAdsCount method
  • add onExpire callbacks
  • add support targeting cross-promo by placements

2.4.4 (28 June, 2018)

  • Facebook updated to 4.28.2
  • IronSource updated to 6.7.9.1

2.4.3 (7 June, 2018)

  • Mopub updated to 5.0.0
  • myTarget updated to 5.1.0
  • Adcolony updated to 3.3.4
  • Tapjoy updated to 11.12.2
  • Add getPredictedEcpm method
  • Remove LoaderActivity

2.4.2 (22 May, 2018)

  • Fixed Banner ads showing on load

2.4.1 (19 May, 2018)

  • Support General Data Protection Regulation (GDPR) compliance
  • Mobvista updated to 8.11.0
  • Startapp updated to 3.8.4
  • Inmobi updated to 7.1.0
  • Applovin update to 8.0.0
  • Chartboost updated to 7.2.0
  • Vungle updated to 6.2.5
  • Flurry updated to 10.1.0
  • Appnext removed
  • Avocarrot removed
  • Millennial Media removed

2.4.0 (April 28, 2018)

  • Parallel bidding support
  • Applovin updated to 7.8.5

2.3.2 (7 May, 2018)

  • Fix MaxDex build (If you're not using MultiDex in your application and encountering 65K methods limit)
  • Support new D8 compiler

2.3.1 (27 April, 2018)

  • Mobvista updated to 8.9.0
  • Add force test mode support
  • Ogury is no longer optional
  • Support play services version 12.0.0 and above (for Admob rewarded video)

2.3.0 (27 February, 2018)

  • Segment V2 support
  • Yandex metrica updated to 2.80
  • Inmobi updated to 7.0.2
  • Flurry updated to 8.2.0
  • Adcolony updated to 3.3.0
  • Startapp updated to 3.6.9
  • Applovin updated to 7.7.0
  • Appnext updated to 2.1.1.436
  • Chartboost updated to 7.0.1
  • Ironsource updated to 6.7.6
  • myTarget updated to 4.7.2
  • Tapjoy updated to 11.11.1
  • Unity ads updated to 2.1.2
  • Vungle updated to 5.3.2

2.2.3 (13 February, 2018)

  • Fix loading assets in Native Ad
  • Fix permission check in Native Ad

2.2.2 (22 January, 2018)

  • NativeAd fixes

2.2.1 (27 December, 2017)

  • Yandex Metrica updated to 2.78
  • Yandex Mobile Ads SDK updated to 2.62
  • Vungle updated to 5.3.0
  • Facebook Audience Network updated to 4.27.0
  • Add AOL api integration (banner and interstitial)

2.2.0 (07 December, 2017)

  • NativeAd integration changed
  • MREC ad type is deprecated, should use NativeAd instead
  • Startapp updated to version 3.6.7
  • Inmobi updated to version 6.2.4
  • Yandex Metrica updated to version 2.76
  • Yandex Mobile Ads SDK updated to version 2.61
  • Mobvista updated to version 8.3.7
  • Applovin updated to version 7.5.0
  • Chartboost updated to version 7.0.0
  • Facebook Audience Network updated to version 4.26.1
  • IronSource updated to version 6.7.3
  • myTarget updated to version 4.6.19
  • Bug fixes

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 com.appodeal.ads.InterstitialActivity and com.appodeal.ads.VideoActivity 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 6.6.2.1
  • 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 5.8.1.1
  • 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 com.my.target.ads.MyTargetActivity
  • 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 com.appodeal.ads.VideoPlayerActivity 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 ru.mail.android.mytarget.ads.MyTargetActivity activity to com.my.target.ads.MyTargetActivity. 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 5.7.1.1
  • 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
  • Appodeal.show(INTERSTITIAL | 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 Appodeal.show(this, 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.INTERSTITIAL
  • 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"
  • com.appodeal.ads.AdActivity renamed to com.appodeal.ads.InterstitialActivity
  • com.appodeal.ads.VideoActivity added to AndroidManifest.xml

1.10.10

  • 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

1.10.9

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

1.10.8

  • MoPub click url fix

1.10.7

  • 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

1.10.6

  • 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

1.10.5

  • 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

1.10.4

  • 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

1.10.3

  • Adding MoPub adapter to SDK

1.10.2

  • 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

1.10.1

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

1.10

  • 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.hardware.location.network" android:required="false" />
  • to your AndroidManifest.xml if you don't require this hardware features to make app compatible with devices without GPS

1.9.2

  • 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.

1.9.1

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

1.9

  • Adding Smaato support
  • Adding Heyzap support