- Bug Fixes
- Now sends ad width in pixels instead of dips when setting a
MoPubAdSize
.
- Now sends ad width in pixels instead of dips when setting a
-
Features
- Certified against Android 10.
- Removed support for
tel
,sms
,createCalendarEvent
, andstorePicture
functions for MRAID ads. - Upgraded ExoPlayer to 2.10.3.
- Migrated to AndroidX. See [https://developer.android.com/jetpack/androidx/migrate] for more information.
- Upgraded
targetSdkVersion
andcompileSdkVersion
to 29.
-
Bug Fixes
- SDK location is now prioritized over publisher-specified location.
- Fixed a rare crash when layout params are available but the parent view is null.
-
Features
- Height-based constants have been added to banners and medium rectangles. Call
MoPubView#setAdSize(MoPubAdSize)
before loading an ad or pass in the ad size toMoPubView#loadAd(MoPubAdSize)
to request an ad of a particular height. See [https://developers.mopub.com/publishers/android/banner/] for more information. - Deprecated skyscraper and leaderboard ad formats. Leaderboards can now be made by setting the
MoPubView
ad size toMoPubAdSize.HEIGHT_90
. - Renamed the MRect ad format as Medium Rectangle.
- Upgraded Robolectric dependency to 4.3.
- Updated the icon for the sample app.
- Sample app now has visible callbacks.
- VAST Videos now play with
device
orientation by default. - The background for interstitials is now black. The background for banners and medium rectangles remain transparent.
- Height-based constants have been added to banners and medium rectangles. Call
-
Bug Fixes
- Improved the look and feel of the sample app on tablets.
- Fixed warnings in the
build.gradle
file. - Improved test run speed.
- Improved the VAST video selection logic.
- Bug Fixes
- Handle
WebViewClient#onRenderProcessGone
for API 26+ devices so WebView crashes do not take the entire process with it. This only affects MoPub WebViews, and all WebViews in the application must handle this call in order for the process to not be killed.
- Handle
-
Features
- Impression Level Revenue Data - a data object that includes revenue information associated with each impression.
- Verizon Ads SDK now supported as a mediated network.
- Upgraded Gradle dependency to 5.4.1
- Upgraded Robolectric dependency to 4.2.1.
- Upgraded com.android.tools.build:gradle to 3.4.0.
- Sample app improvements.
-
Bug Fixes
- Handle empty impression trackers in VAST.
- Improved impression handling when MoPubView is reattached to the screen.
-
Features
- Enabled debug logging when using a debug Google Advertising ID (one that ends with "10ca1ad1abe1").
- Upgraded ExoPlayer dependency to 2.9.5.
- Upgraded MoPub-Volley dependency to 2.1.0.
-
Bug Fixes
- Banners no longer refresh when they are expanded. They will resume refreshing when the expanded view is closed.
- Setting orientation on an expanded banner no longer locks the orientation after the expanded view is closed.
- Improved click detection.
- Catch
MissingWebViewPackageException
inConsentDialogLayoutWebView
. - Reduce ANRs by removing synchronization from
Networking#getUserAgent(Context)
.
-
Features
- Advanced Bidding automatically initializes. See https://developers.mopub.com/docs/android/initialization/ for more information about initialization.
- GDPR legitimate interest API now available; publishers may opt into allowing supported networks to collect user information on the basis of legitimate interest.
- Improved logging from the SDK. Set the log level with
SdkConfiguration.Builder#withLogLevel(LogLevel)
in initialization to change the logging granularity. - Upgraded Gradle dependency to 4.8
- Upgraded Android Plugin dependency to 3.2.0
-
Bug Fixes
- Addresses an ANR when requesting an ad immediately after initialization.
- MRAID isReady is now called after the load is finished instead of when the ad is shown.
- Bug Fixes
- Fixed bug with the internal state of rewarded video when the video fails to play.
- Fixed bug where initialization complete is called multiple times.
- Fixed Google Advertising ID fetching logic.
- Marked
gdprApplies
as nullable - Added cleartextTrafficPermitted="true" to Android Sample App.
- Fixed bug where
rewardedAdsLoaders.markPlayed()
was fired beforeonRewardedVideoClosed()
. - Added
adDidFail
callback to!isNetworkAvailable()
inAdViewController
.
- Upgraded target SDK version to 28 and support libraries to 28.0.0.
- Upgraded ExoPlayer dependency to 2.8.3.
- Moved
AdvancedBiddingInitializationAsyncTask
andRefreshAdvertisingInfoAsyncTask
to the parallel executor. - MRAID
isViewable
now more closely follows our impression tracking instead of the ad being marked viewable as soon as it loads. - Bug fixes.
- This release includes the foundation work for SDK to receive optimized responses for multiple placements from the waterfall. This effort will reduce the number of server roundtrips and minimize the ad response latency.
- Upgraded ExoPlayer dependency to 2.8.2.
- Upgraded recommended Google Play Services dependency to 15.0.1.
- Upgraded target sdk version to 27 and support libraries to 27.1.1.
- Upgraded Gradle dependency to 4.4.
- Upgraded Android Plugin dependency to 3.1.3.
- Upgraded test dependencies Powermock to 1.6.6 and Robolectric to 3.8.
- Bug Fixes.
- SDK initialization is required for ads to load. Ad requests will fail unless MoPub is initialized.
MoPub#isSdkInitialized()
now more accurately reflects whether or not MoPub is initialized. This method now returns true after theSdkInitializationListener#onInitializationFinished()
callback instead of immediately.- Bug fixes.
- Upgraded Moat dependency to 2.4.5.
- Banners now only refresh after an impression is made.
- Added
PersonalInfoManager.forceGdprApplies()
in order to let MoPub know that this app should always apply GDPR rules. - Loading MoPub's consent dialog is only possible when GDPR rules applies to the app.
- Bug fixes.
- General Data Protection Regulation (GDPR) update to support a way for publishers to determine GDPR applicability and to obtain and manage consent from users in European Economic Area, the United Kingdom, or Switzerland to serve personalized ads.
- New SDK initialization method to initialize consent management and rewarded video ad networks. Required for receiving personalized ads. In future versions of the SDK, initialization will be required to receive ads.
- Updated network stack to MoPub-Volley-2.0.0.
- Updated ad requests to use POST instead of GET.
- All communication with MoPub servers is now made via HTTPS.
- Upgraded Gradle dependency to 4.3.1.
- Upgraded Moat dependency to 2.4.1. This fixes the AAPT2 manifest merge error.
- Fixed a viewability bug for video ads where ViewGroups were not being properly added to the list of known obstructions.
- We are formally separating network adapters from our MoPub SDK. This is to enable an independent release cadence resulting in faster updates and certification cycles. New mediation location is accessible here.
We have also added an additional tool, making it easy for publishers to get up and running with the mediation integration. Check out https://developers.mopub.com/docs/mediation/integrate/ and integration instructions at https://developers.mopub.com/docs/android/integrating-networks/. - Bug fixes.
- Updated Facebook Audience Network adapters to 4.26.1.
- Updated Flurry adapters to 8.1.0.
- Updated Millennial rewarded ads adapters to 6.6.1.
- Fixed a potential crash for native video ads when attempting to blur the last video frame.
- Fixed a duplicate on loaded callback for some rewarded ads.
- Updated the SDK compile version to 26. Android API 26 artifacts live in the new Google maven repository
maven { url 'https://maven.google.com' }
. See this article for more information about using Android API 26. - Fixed MoPub in-app browser's back and forward button icons.
- Updated AdMob adapters to 11.4.0.
- Updated Chartboost adapters to 7.0.1.
- Updated Facebook Audience Network adapters to 4.26.0.
- Updated Millennial to 6.6.1.
- Updated TapJoy adapters to 11.11.0.
- Updated Unity Ads adapters to 2.1.1.
- Updated Vungle adapters to 5.3.0.
- Bug fixes.
- Rewarded Ads can now send up optional custom data through the server completion url. See
MoPubRewardedVideos#showRewardedVideo(String, String)
. - Updated Facebook native adapter to ignore clicks on whitespace as per Facebook policy.
- Fixed issue where null javascript was being passed to AVID video sessions.
- Added support for viewability measurement from IAS (AVID library) and Moat.
- Important: New dependencies were included in this release; please update your
build.gradle
's repositories block to includemaven { url "https://s3.amazonaws.com/moat-sdk-builds" }
. Note that the AVID library is provided on JCenter, so no additional steps must be taken -- it will be included automatically. - To disable this feature, see note below on Disabling Viewability Measurement.
- Important: New dependencies were included in this release; please update your
- Interstitials are now loaded offscreen instead of in a separate WebView.
- Rewarded Videos have a new init method. See
MoPubRewardedVideos.initializeRewardedVideo(Activity, List<Class<? extends CustomEventRewardedVideo>>, MediationSettings...)
. Pass in a list of networks to initialize, and MoPub will initialize those networks with the settings from the previous ad request, persisted across app close. - Upgraded our ExoPlayer dependency to 2.4.4.
- Bug fixes
MoPub v4.16 SDK integrates technology from our partners Integral Ad Science, Inc. (“IAS”) and Moat, Inc. (“Moat”) in order to support viewability measurement and other proprietary reporting that IAS and Moat provide to their advertiser and publisher clients. You have the option to remove or disable this technology by following the opt-out instructions below.
If you do not remove or disable IAS's and/or Moat’s technology in accordance with these instructions, you agree that IAS's privacy policy and license and Moat’s privacy policy, terms, and license, respectively, apply to your integration of these partners' technologies into your application.
There are a few options for opting out of viewability measurement:
Normally, to add the MoPub SDK to your app via JCenter, your build.gradle
would contain:
dependencies {
compile('com.mopub:mopub-sdk:4.16.0@aar') {
transitive = true
}
}
Update to the following to exclude one or both viewability vendors:
dependencies {
compile('com.mopub:mopub-sdk:4.16.0@aar') {
transitive = true
exclude module: 'libAvid-mopub' // To exclude AVID
exclude module: 'moat-mobile-app-kit' // To exclude Moat
}
}
Navigate to the gradle.properties
file in your home directory (e.g. ~/.gradle/gradle.properties
) and include one or both of these lines to opt out of viewability measurement for AVID and/or Moat.
mopub.avidEnabled=false
mopub.moatEnabled=false
If you would like to opt out of viewability measurement but do not want to modify the MoPub SDK, a function is provided for your convenience. At any point, call MoPub.disableViewability(vendor);
. This method can can be called with any of the enum values available in ExternalViewabilitySessionManager.ViewabilityVendor
: AVID
will disable AVID but leave Moat enabled, MOAT
will disable Moat but leave AVID enabled, and ALL
will disable all viewability measurement.
- The SDK now sends Advertising ID on Amazon devices when appropriate.
- Fixed issue with Charles proxy in sample app for API 24+.
- Bug fixes.
- Rewarded Ad reward callback
onRewardedVideoCompleted(Set<String>, MoPubReward)
is also triggered now on the client for server-side rewarding. - Added click callback for Rewarded Ads.
- Any implementors of
MoPubRewardedVideoListener
will now need to also implementMoPubRewardedVideoListener#onRewardedVideoClicked(String)
.
- Any implementors of
- MoPub Ads now expire after 4 hours of being unused.
- Interstitial and Rewarded ads served by MoPub will expire 4 hours after successfully loading, triggering a load failure with the new
EXPIRED
MoPubErrorCode
. - Cached Native Ad Placer ads now also expire in 4 hours.
- Interstitial and Rewarded ads served by MoPub will expire 4 hours after successfully loading, triggering a load failure with the new
- Improved logging when attempting to show an ad that is not ready.
- Updated build tools version to 25.0.2.
- Bug fixes.
- Updated AdColony Custom Events.
- Updated Unity Custom Events.
- Added AdMob Custom Events:
- Native:
GooglePlayServicesAdRenderer
andGooglePlayServicesNative
- Rewarded Video:
GooglePlayServicesRewardedVideo
- Native:
- Bug fixes.
- Updated minimum supported Android API version to 16+ (Jelly Bean).
- New required Activity declaration in
AndroidManifest
, please add:
<activity android:name="com.mopub.mobileads.RewardedMraidActivity"
android:configChanges="keyboardHidden|orientation|screenSize"/>
- Added support for rich media in rewarded video inventory.
- Bug fixes:
- Fixed incorrectly forwarded lifecycle events
onStop()
andonDestroy()
inMoPubLifeCycleManager
for rewarded rich media ads. - Prevented MoPub-related crashes due to system-level WebView updates while the app is running.
- Allow video playback in
reverseLandscape
orientation (in addition to previously supportedlandscape
orientation). - Fixed crash caused by invalid VAST absolute tracker values.
- Fixed incorrectly forwarded lifecycle events
- Added a workaround for an Android bug where Lollipop devices (Android 5.1.1, API level 22) and lower incorrectly handle SSL connections using Server Name Identification.
- Rewarded video
load()
calls now do not load another rewarded video with the same ad unit id while one is already loading or loaded. - Moved the VAST video start tracker to immediately after the video starts (was 2 seconds after the video started).
- Bug fixes.
- Added and updated mediated network versions
- Added Flurry version 6.5.0. All Flurry adapters can be found in the corresponding
extras
directory (/extras/src/com/mopub/mobileads
for banners and interstitials,/extras/src/com/mopub/nativeads
for native).- All Flurry ad formats must include:
FlurryAgentWrapper
- Banners:
FlurryCustomEventBanner
- Interstitial:
FlurryCustomEventInterstitial
- Native:
FlurryCustomEventNative
,FlurryBaseNativeAd
,FlurryNativeAdRenderer
, andFlurryViewBinder
- All Flurry ad formats must include:
- Certified Facebook Audience Network version 4.15.0
- Certified Tapjoy version 11.8.2
- Certified Millennial Media version 6.3.0
- Certified Vungle version 4.0.2
- Added Flurry version 6.5.0. All Flurry adapters can be found in the corresponding
- Fixed intermittent
IllegalStateException
for MRAID creatives attemping to retrieve getRootView() on unattached Views. - Updated
mopub-sample
's exampleproguard.cfg
to properly retain methods called only via reflection.
- Removed the full SDK bundle.
- Removed Eclipse support.
- Removed InMobi custom events from extras.
- Deprecated rewarded video calls from
MoPub.java
and moved them toMoPubRewardedVideos.java
.- For example,
MoPub#loadRewardedVideo
is deprecated in favor ofMoPubRewardedVideos#loadRewardedVideo
.
- For example,
- Bug fixes.
Modular SDK
- Added the ability to specify which ad formats to include as dependencies (to decrease the overall footprint of the MoPub SDK in your app).
- Default behavior remains unchanged and includes access to all ad formats.
- Note: Maven builds from source are currently unstable and will be reinstated in a future release. Maven developers can still pull the MoPub SDK AAR from JCenter.
- Changed the behavior of
MoPubInterstitial#load()
while an interstitial is loading or has been successfully loaded. Previously, this would discard the currently-caching or cached interstitial -- now the interstitial will be unaffected and will remain in the cache. MoPubInterstitial
s can now be shown only once per successful ad load.- Modified a number of Native Ads APIs (manual integration) to accept Context instead of Activity. Affected classes/methods include:
MoPubNative
,AdapterHelper
,CustomEventNative#loadNativeAd()
, andMoPubAdRenderer#createAdView()
.
- Fixed deeplink bug.
- Rewarded video server-side currency rewarding (Beta).
- Enhanced Android intent handling.
- Enhanced caching logic for HTML and MRAID interstitials. Resource-heavy interstitials will now render more quickly when MoPubInterstitial#show() is called.
- Certified Chartboost version 6.4.1
- Certified Tapjoy version 11.5.1
- Updated ExoPlayer dependency from r1.4.2 to r1.5.6; courtesy @talklittle. Removed references to READ_EXTERNAL_STORAGE permission.
- Rewarded video support from the MoPub Marketplace (Beta)
- Miscellaneous bug fixes.
- Fixed deeplink bug where host must be present in URL.
- Updated permission model to be compatible with Android 6.0 (API level 23).
- Enhancements and bug fixes for video ads.
- Enhancements and bug fixes for VAST video ads.
- Support for mediating Facebook Native Video ads.
- Mediated Facebook Native Ads now display the AdChoices icon.
- Support for Facebook SDK 4.8.1
-
A number of Native Ad classes now require
Activity
instances instead ofContext
. Most users should be unaffected by this change, and it fixes a crash caused by handling themes incorrectly. The following classes are affected:CustomEventNative
and its implementations includingMoPubCustomEventNative
.MoPubAdAdapter
andMoPubRecyclerAdapter
.MoPubAdRenderer
and its implementations.MoPubStreamAdPlacer
MoPubNative
NativeAd
andNativeAdSource
NativeAdViewHelper
-
Vungle's ad adapters have been updated for their 3.3.0 SDK.
-
Tapjoy adapters for interstitials and rewarded video are included for their 11.2.2 SDK.
-
The Play Services adapters have been tested with Play Services 7.8.0.
Version 4.0.0 includes a number of improvements to our Native Ads systems under the hood. This means a few changes for publishers integrating the ads. The Native Ads Integration Guide describes all the steps you'll need to integrate 4.0.0.
Native Ads Changes
MoPubNativeAdRenderer
has been replaced byMoPubStaticNativeRenderer
- When requesting ads using
MoPubNative
, you must instantiate and register aMoPubStaticNativeAdRenderer
. See the Integration Document for more details. NativeResponse
has been replaced withNativeAd
NativeAd
has a new API that supports creating and renderingView
s for Native Ads.#createAdView
returns aView
that can hold data for theNativeAd
#renderAdView
will populate theView
with ad data.- Other lifecycle methods from
NativeResponse
remain:#prepare
,#clear
,#destroy
- The process of writing new
CustomEventNative
instances has changed. These changes will support more dynamic, flexible, and attractive Native Ad formats in the future. All bundled native Custom Event files have been updated to use the new API.
Removed Old Code
- Removed legacy banner/interestitial listeners, deprecated in 1.11
- Removed legacy custom event implementation ("custom event methods") deprecated in 1.10
- Android M Support - Replaced usage of the now-deprecated HttpClient with HttpURLConnection.
- Rewarded Video Mediation is now Generally Available. We provide support for Unity Ads, Chartboost, Vungle, and Ad Colony rewarded video.
- Privacy Information Icon is now available for native ads. You should add this view to your ViewBinder. See the example in the MoPub Sample app.
- Updated Millennial Media support to 6.0.0, including updates to the
MillennialBanner.java
andMillennialInterstitial.java
custom events. - Added mediation for Millennial Media native ads:
MillennialNative.java
, located in the native extras directory of the SDK (/extras/src/com/mopub/nativeads
).
- VAST UI improvements and bug fixes.
- Pause trackers no longer fire when the ad is skipped.
- Improved retrieval of blurred video frame when there is no companion ad.
- Added com.mopub:mopub-sdk AAR to jCenter.
- Bug Fixes:
- Fixed a NullPointerException in CacheService on devices with low storage space.
- Improved redirect loading for in-app browser.
- Added VAST 3.0 standard support for video ads.
- Improved video player UX.
- Added RecyclerView support for native ads. See the integration guide.
- Improved deep link handling.
- Bug Fixes:
- MRAID video interstitials now play automatically when displayed on Jellybean MR1 and newer.
- MRAID relative assets are correctly rendered.
- MoPubLog no longer duplicates some messages.
- Fixed erroneous output of DeviceUtils.getScreenOrientationFromRotationAndOrientation().
- Updated Chartboost support to 5.3.0. This introduces a new shared class called ChartboostShared. If you are using Chartboost Custom Native Networks you will need to include this class in your build along with ChartboostInterstitial.
-
Updated GooglePlayServices custom events to depend on the Google Play Services
play-services-ads 7.0.0
API. -
Vungle support updated to SDK 3.3.3.
-
Updated InMobi and Greystripe custom events to accept application IDs from the MoPub UI.
- For InMobi:
{"app_id" : "YOUR_INMOBI_APP_ID"}
- For Greystripe:
{"GUID" : "YOUR GREYSTRIPE_GUID"}
- For InMobi:
-
Added toasts to the MoPub Sample App for ad load failures due to no connection.
-
Fixed a bug in processing VAST progress trackers in a VAST wrapper tag.
-
Fixed a bug where ad refresh times could be incorrect when an ad request was not filled.
-
Updated the following dependencies:
- support-v4 AAR to 22.0.0
- support-annotations JAR to 22.0.0
- Android Maven Plugin to 4.2.0
- Bug Fix Fixed a compile error in FacebookBanner.java
- Facebook Update Updated supported Facebook Audience Network version to 3.23.1
- Bug fix Fixed a bug where interstitials could leak memory; Fixes issue #153
- VAST Video Updated the VAST video player to support Progress events.
- Updated Volley version to 1.1.0.
- Dependency changes in Maven and Gradle. No new dependencies have been added, but your build script will need to change slightly to include JCenter. See our Getting Started Guide for complete instructions.
- Security Improvement: removed the @JavascriptInterface annotation for WebViews.
- Fixed a bug where video playback would sometimes fail to stop when an ad was dismissed.
- Fixed a bug where it was not possible to disable ad refresh; Fixes issue #148
- Fixed a null pointer exception in AdViewController; Fixes issue #150
- Volley networking stack MoPub for Android now uses Google's Volley library for HTTP requests. You will need to add our bundled Volley JAR (available at
mopub-sdk/libs/mopub-volley-1.0.0.jar
) as a compile-time dependency. See instructions in our integration page. - Updated Vungle Support Certified the
VungleInterstitial
custom event against Vungle SDK 3.2.2 - VAST Video Bug Fixes
- Fixed inability to parse VAST tags referencing URLs that contain 3rd party macros
- VAST videos no longer fire completion trackers upon video playback error
- Added support for the
mopubnativebrowser://
click-destination scheme for Native, MRAID, and VAST ads (it was already supported for HTML ads). Links of this type (e.g.mopubnativebrowser://navigate?url=http%3A%2F%2Fwww.mopub.com
) will open the specified URL in the device's default browser, rather than in MoPub's in-app browser.
-
MRAID 2.0 Support - The MoPub SDK is now compliant with the MRAID 2.0 specification to enable rich media ads in banners and interstitial ad units. Learn more about MRAID from the IAB.
-
Location Polling Updates - Changed the interaction between application- and device-provided location data: more recent location data is now always used (in the past, application-provided location data was always preferred).
As before, you may still disable MoPub SDK's location polling by calling
MoPub.setLocationAwareness(LocationAwareness.DISABLED)
. -
Updated Chartboost SDK Updated the
ChartboostInterstitial
custom event to support Chartboost SDK 5.0.4 -
Android Support Annotations Introduced a dependency on android-support-annotations.jar to support code analysis of
@Nullable
and@NonNull
annotations.
- Bug Fix Fixes a bug in fetching the Google Advertising ID from Google Play Services.
- Bug Fix Fixes a bug in processing certain HTTP headers for Native Ads.
- Updated SDK License Visit http://www.mopub.com/legal/sdk-license-agreement/ for details.
- Bug Fixes
- Updated Facebook SDK Compatibility to 3.18.1 Provided Custom Events for Facebook Banners, Interstitials and Native Ads (included in the extras/ folder) are now compatible with the latest SDK release from Facebook (3.18.1).
- Updated API for Native Ads Custom Event writers If you are mediating Facebook or InMobi native ads, this change requires you to copy FacebookNative.java and InMobiNative.java custom events from the extras/ folder to com.mopub.nativeads package for compatibility.
- Location Settings are now SDK-wide
- Calls to
MoPubView#setLocationAwareness
andMoPubInterstial#setLocationAwareness
are deprecated in favor ofMoPub#setLocationAwareness
- Calls to
MoPubView#setLocationPrecision
andMoPubInterstitial#setLocationPrecision
are deprecated in favor ofMoPub#setLocationPrecision
- Calls to any of these methods have the effect of setting location awareness and precision globally for the SDK
- Calls to
- Build target SDK is now API Level 19. If you are building the MoPub SDK from source, modify your dependencies to reference Android 4.4.2, API Level 19. This does not affect the minimum device API level, which remains at API Level 9.
- Source-level support for Gradle projects. The SDK source now includes a build.gradle file you can use to build source as part of your Gradle project.
- The SDK now uses Play Services 5.0.89
- Bug fixes:
- Millennial Interstitial caching now properly handles request failures
- Fixed bug preventing native ads from loading after a request failure
- Minimum Android version now at API Level 9. To use the new SDK, your app must run on Android 2.3.1 (Version 9, Gingerbread) or higher.
- Simplified APIs for inserting native ads. See Native Ads Integration for details.
- Automatic ad caching for smooth scrolling. For native ads, the SDK will now automatically pre-load ads, resulting in smoother scrolling.
- Performance improvements The SDK now makes more efficient use of memory for image caching and avoids allocating temporary objects while scrolling, resulting in fewer garbage collections.
- Sample app improvements. An improved sample app allows saving ad unit IDs for testing.
- Bug fixes:
- Banner auto-refresh is now properly re-enabled when resuming your app.
- Improved impression tracking for Native Ads Impression tracking for native ads is now more accurate and more efficient.
- Streamlined Maven Build and Dependencies MoPub's Android SDK now depends on the Android v4 Support Library shipped with the Android Build tools. The MoPub Sample App also depends on Google Play Services to use the Android Advertising ID. We recommend building against Play Services in your app as well. For integration instructions, see the getting started page.
- Removed AdMob Custom Events and JAR AdMob's SDK is deprecated by Google and the APIs have been moved to Google Play Services. Existing AdMob adunits will now invoke the appropriate Google Play Services custom event. Developers must update their integration to use the Google Play Services custom events located in the extras folder by August 1.
- Updated Third-Party Network Compatibility MoPub's provided Custom Events (included in the extras/ folder) are now compatible with the latest SDK releases from Millennial Media (5.3.0), Vungle (3.1.0), InMobi (4.4.1) and Google Play Services (5.0.77).
- Fixed intermittent NullPointerException in MoPubNative#requestNativeAd; fixes [Github issue #97] (https://github.com/mopub/mopub-android-sdk/issues/97)
- Fixed an issue where MRAID interstitials could be not be closed.
- Native ads mediation release; integration instructions and documentation are available on our help page. Added custom event native implementations to the native extras directory of the SDK (
/extras/src/com/mopub/nativeads
), with initial support for the following networks:- Facebook Audience Network (
FacebookNative.java
) - InMobi Native Ads (
InMobiNative.java
)
- Facebook Audience Network (
- Native ads content filtering: Added the ability to specify which native ad elements you want to receive from the MoPub Marketplace to optimize bandwidth use and download only required assets, via
RequestParameters.Builder#desiredAssets(…)
. This feature only works for the six standard Marketplace assets, found inRequestParameters.NativeAdAsset
. Any additional elements added in direct sold ads will always be sent down in the extras. - Added star rating information to the
NativeResponse
object, viaNativeResponse#getStarRating()
. This method returns aDouble
corresponding to an app's rating on a 5-star scale. - VAST video quartile and completion trackers now always include the user-agent
- Ensured that banners never autorefresh until they have been loaded at least once
- Added custom events for Facebook ads.
FacebookBanner
andFacebookInterstitial
can be found in the extras directory of the SDK (/extras/src/com/mopub/mobileads
). For more information, please see the help page for integrating third party ad networks. - Significant improvements to video ads
- Added overlay including a "Learn More" button, video length, and time left until the video may be skipped
- Added support for companion banners (shown upon video completion)
- Added Logcat warnings (and Toasts for debug builds) in cases where all necessary Activity permissions haven't been added to the
AndroidManifest
- Fixed cases where VAST Video Interstitials were failing to fire
InterstitialAdListener
callbacks; fixes GitHub issue #78 - Simplified click tracking logic for HTML ads
- Native Ads public release; integration instructions and documentation available on our support website
- Changed minimum supported Android version to Froyo (Android 2.2, API level 8)
- Added support for Google Play Services advertising identifier
- Renamed the
com.mopub.mobileads.MraidBrowser
Activity tocom.mopub.common.MoPubBrowser
.-
Important Note: This change requires a modification to the
AndroidManifest
. The updated set of requisite activity permissions are as follows:
-
- Upgraded the bundled
android-support-v4
library to r19.1.- Note for Maven users: Newer versions of the
android-support-v4
artifact are unavailable on Maven central, so we have included a small script to update the version in your local artifact repository. Please navigate to themopub-sdk
directory, and runscripts/mavenize_support_library
.
- Note for Maven users: Newer versions of the
- Restricted use of methods and fields that require API 4+ (
WebView#removeJavascriptInterface
andConnectivityManager
's connection types)
- Added safeguards to prevent two different
MoPubInterstitial
objects from listening in on one other's lifecycle callbacks - Disabled Javascript loading into
destroy()
edWebView
s; fixes GitHub issue #62 - Fixed an
IllegalArgumentException
resulting from VAST videos with malformed redirect tags - MRAID ads that utilize
mraid.open()
now correctly record a click event - Added missing
FLAG_ACTIVITY_NEW_TASK
toVastVideoView
's intent creation; fixes part of GitHub issue #56
- Updated InMobi custom events to support InMobi SDK 4.0.3+ only
- MRAID viewable property now correctly updates on viewability change
MraidView
properly handles null schemes; fixes GitHub issue #63- Internal disk LRU cache correctly hashes keys when checking for existing files
- Fixed bug that caused clicks to not be recorded in the MoPub UI (introduced in 1.17.1)
- Added custom events for Google Play Services.
GooglePlayServicesBanner
andGooglePlayServicesInterstitial
can be found in the extras directory of the SDK (/extras/src/com/mopub/mobileads
) - Resolved issues with missing annotations on
addJavascriptInterface
whentargetSdkVersion
is set to API level 17 or above - Updated MoPub sample application to allow in-app text entry of ad unit IDs
- Support for VAST 2.0 video playback via MoPub Marketplace
- Short videos (less than 15 seconds) autoplay and and are unskippable
- Longer videos autoplay and are skippable after 5 seconds
- Note: The video cache can use up to 100 MB of internal storage. For developers sensitive to storage constraints, this value may be changed in
VastVideoInterstitial.CACHE_MAX_SIZE
.
- Updated InMobi custom event support to 4.0.0
- Added custom events for video ad network mediation, which can be found in the extras directory of the SDK (
/extras/src/com/mopub/mobileads/
)- Added the
AdColonyInterstitial
custom event - Added the
VungleInterstitial
custom event - Note: Virtual currency callbacks (v4vc) are not supported for the above ad networks
- Added the
- Enabled deeplinking via custom URIs in ad creatives
- All
WebView
s are removed from their parents beforedestroy()
; fixes GitHub issue #38 - Removed previously-deprecated
HTML5AdView
- Improved creative controls
- Creative flagging
- Allows users to report certain inappropriate ad experiences directly to MoPub with a special gesture
- User must swipe back and forth at least four times in the ad view to flag a creative
- Swipes must cover more than 1/3 of the ad width and should be completely horizontal
- Only enabled for direct sold, Marketplace, and server-to-server networks ads
- Creatives that attempt to auto-redirect are now blocked; ads cannot redirect without user interaction
- Javascript alert, confirm, and prompt dialogs are blocked
- Creative flagging
- Improved responsiveness of
showInterstitial()
forHtmlInterstitial
s andMraidInterstitial
s by pre-rendering HTML content - Simplified internal construction and handling of
WebView
s by removingWebViewPool
and its subclasses - Updated mraid.getVersion() to return 2.0
- Removed
WebSettings.setPluginsEnabled()
so the SDK builds against Android API 18; fixes GitHub issue #28 - AdMob banners are now removed from the view hierarchy before they are destroyed; fixes the reopened GitHub issue #23
- Prevent ads from launching system features, such as a browser view, until the user has interacted with the ad.
- Made the SDK more resilient to creatives that improperly use the
mopubnativebrowser://
scheme; fixes GitHub issue #36
- Allowed Facebook Support to be disabled optionally with
setFacebookSupported(false)
:- Use
MoPubInterstitial.setFacebookSupported(false);
for interstitials - Use
MoPubView.setFacebookSupported(false);
for banners - Note: the
setFacebookSupported(false)
method call must come beforeloadAd()
- Note: facebook support is on by default
- Use
- Changed banner refresh default to be 60 seconds when requests timed out
- Fixed edge case in Millennial Media ad fetch failure when there is no inventory; fixes GitHub issue #18
- Fixed a bug where redirect URLs were malformed, causing the native browser to not render ads
- Updated Millennial Media jar to 5.1.0
- Updated Greystripe custom event support to 2.3.0
- Fixed MRAID 2.0
storePicture
command's messaging when a picture either fails to download or fails to save to device - Expanded MRAID 2.0
createCalendarEvent
command to support both minute- and second-level granularity
- Made the SDK more resilient to unexpected Flash creatives
- Updated documentation to remove the requirement for certain AndroidManifest permissions
- Fixed minor bug with MRAID 2.0
storePicture
command where the user sees a false download completed message
Includes support for ads in the MRAID 2.0 format. MRAID 2.0 allows advertisers to create ads with rich media functionality, including adding calendar events, storing pictures and playing videos in the native video player. To learn more about MRAID 2.0, read our help article.
- Added the following MRAID 2.0 features:
createCalendarEvent
(Android 4.0 and above),playVideo
,storePicture
, andsupports
- Hardware Acceleration is now enabled by default for
MraidInterstitial
s on Android 4.0 and above - Ensured that Cursors in
FacebookKeywordProvider
are always closed properly; fixes GitHub issue #8 - Added tracking parameter to InMobi ad requests; fixes GitHub issue #15
- Banner WebViews are now removed from the view hierarchy before they are destroyed; fixes GitHub issue #23
To correctly display ads that ask the user to save a picture (storePicture ads), you need to make the following change to AndroidManifest.xml:
- Add the
WRITE_EXTERNAL_STORAGE
permission. Note: Adding the permission is optional. If the permission is not added, we will not deliver any store picture ads to the users' devices. All other features will remain functional without the new permission.
To allow users to play videos using the native video player:
- Declare activity
com.mopub.mobileads.MraidVideoPlayerActivity
. This activity is required to support playing videos in the native player and we strongly recommend adding it.
- Wait until after loaded interstitials are shown to report an impression
- Remove phantom impression tracking from interstitials
- Remove extra whitespace from Millennial banner ads
- Added
onInterstitialClicked()
notification toInterstitialAdListener
- Provide default implementations for
BannerAdListener
andInterstitialAdListener
- Provided improved support for Android Unity by moving all project resources (including layouts, javascript, images, and values) into source
- Removed reference to TYPE_DUMMY in AdUrlGenerator because it is not available in earlier versions of Android; fixes GitHub issue #3
- Fixed NPE in AdUrlGenerator when WiFi is off and Airplane mode is on; fixes GitHub issue #5
MraidInterstitial
s now properly notifyInterstitialAdListener
when they are shown and dismissed
- Updated Millennial support to Millennial Media SDK version 5.0.1
- Relaxed access modifiers for
CustomEventBanner
andCustomEventInterstitial
- Removed extraneous display call in
MillennialInterstitial
custom event - Fixed potential NPE in
AdView
's loadUrl() - Deprecated
HTML5AdView
after fixing some compilation issues
- Moved all Android code and documentation to its own repository: mopub-android-sdk
- Updated Millennial support to Millennial Media SDK version 5.0
- Support for Millennial Media SDK 5.0.1 is ready and will be released when the new Milllennial SDK becomes available
- Added
GoogleAdMobBanner
,GoogleAdMobInterstitial
,MillennialBanner
, andMillennialInterstitial
custom event classes - Removed obsolete native network adapters
- Added timeout for third-party networks (10 seconds for banners and 30 seconds for interstitials)
- Added more data signals (application version, connection type, and location accuracy)
- Chartboost custom event now automatically parses server data
- Added support for Millennial Media SDK 5.0
- Initial support for data signals (connectivity and carrier)
- Deprecated multiple
MoPubView
event listener interfaces in favor of a unifiedMoPubView.BannerAdListener
interface - Deprecated
MoPubInterstitial
listener interface in favor of a newMoPubInterstitial.InterstitialAdListener
interface - Added "shown" and "dismissed" listener methods to
MoPubInterstitial.InterstitialAdListener
interface - Fixed a NullPointerException in
MoPubInterstitial
for waterfalls containing multiple custom events - Fixed a NullPointerException when tracking impressions for native network SDKs
- Fixed issue causing
MoPubView
to left-align HTML banners - Fixed issue causing incorrect return value for
isReady
when usingMoPubInterstitial
and custom events
- Introduced custom event classes
- Improved error logging during
AdFetch
- Fixed view resource ID conflicts in
MraidDisplayController
- Fixed issue in which un-implemented custom events could disrupt the mediation waterfall
- Added ability to force refresh ad units
- Added testing accessors to
MoPubView
andMoPubInterstitial
- Updated to correctly reflect MRAID capabilities in ad request
- Updated to perform
HttpClient
shutdown on background thread
- Added support for the Facebook ads test program
- Updated the Millennial adapters to support SDK version 4.6.0
- Fixed a crash resulting from following market:// links when Google Play is not installed
- Added in-app browser support for more Google Play redirect styles
- Added exponential backoff on ad server failure
- Included new ad unit IDs for sample ads in SimpleAdsDemo
- Removed extraneous image files
- Added support for Millennial Media leaderboard ads
- Improved click experience by directing clicks to an in-app browser
- Fixed errors loading mraid.js from disk on Android 4.0+
- Added
ThreadPoolExecutor
for AsyncTasks on Android 4.0+ - Fixed incorrect failover behavior for Custom Native Network banners
- Added support for Millennial Media SDK 4.5.5
- Fixed ANR relating to synchronization in
LoadUrlTask
- Fixed IllegalArgumentExceptions when creating HttpGet objects with malformed URLs
- Fixed some NullPointerExceptions in the AdMob and Millennial native adapters
- Fixed issues in which third-party adapters might not properly fail over
- Fixed a crash caused by unregistering non-existent broadcast receivers
- Fixed handling of potential SecurityExceptions from network connectivity checks
- Exposed keyword APIs for interstitials
- Fixed click-tracking for custom:// and other non-http intents
- Added support for custom events
- Added network connectivity check before loading an ad
- Added
OnAdPresentedOverlay
listener methods