Android Changelog
Refer to our Chartboost Mediation Adapter Integration Manager for the latest supported partner adapter versions.
Version 5.1.0 (2024-10-03) π
Chartboost Mediation SDKs that have reached their end-of-life will now be disabled. See SDK Deprecation Policy documentation.
Improvements:
- Added support for GPP Sections String (
IABGPP_GppSID
). This is read fromSharedPreferences
and is passed in the auction request.
Version 5.0.0 (2024-08-01) π
Improvements:
- Completed rebranding all APIs from Helium to Chartboost Mediation.
- Initialization of Chartboost Mediation now utilizes Chartboost Core SDK. Please review the Initialize Mediation and Core SDK documentation.
- Privacy and consent signals are now set through Chartboost Core SDK.
- Banners are now named
ChartboostMediationBannerAdView
and optionally use coroutines to load. - Fullscreen ads are now loaded from
ChartboostMediationFullscreenAd
. See Load Ads documentation.
Review our Migration from Mediation 4.x to 5.x documentation for more information.
Version 4.9.1 (2024-05-23) π
Bug Fixes:
- Eliminated a βConcurrentModificationExceptionβ that could occur when setting GDPR.
Version 4.9.0 (2024-03-21) π
Improvements:
- Added support for ad queueing, a new feature that builds upon the existing fullscreen ad experience that allows publishers to queue up multiple fullscreen ads and show them in succession.
Version 4.8.0 (2024-02-08) π
The following ad networks have been deprecated:
- AdColony
- TapJoy
- Yahoo
Improvements:
- Introduced a new overridden callback
HeliumBannerAdListener#onAdCached(placementName: String, loadId: String, winningBidInfo: Map<String, String>, error: ChartboostMediationAdException?, bannerSize: Size)
that provides the size of the banner in dp as provided by the partner. If the size from the partner is not available, this will give back the requested size.
Bug Fixes:
- Fixed a rare crash in
ChartboostMediationAppConfigurationHandler
when initializing in certain circumstances.
Version 4.7.1 (2023-12-05) π
Bug Fixes:
- Removed the
repackageclass
annotation in proguard-rules.pro as to not affect publisher builds. - Initialization will now wait for app set ID retrieval to return a value.
Version 4.7.0 (2023-11-14) π
Improvements:
- Added an API to set consent on a per-partner basis.
Version 4.6.0 (2023-10-12) π
Improvements:
- Introduced Banner APIs that support both Fixed and Adaptive Banner Ad Types. See
HeliumBannerSize
for options. - Added
onAdViewAdded(placementName: String, child: View?)
toHeliumBannerAdListener
.
Bug Fixes:
- Ensure
start
appears on all partner metrics, even on timeout.
Version 4.5.0 (2023-08-31) π
Improvements:
- TCFv2 String is now read from
SharedPreferences
and passed in the auction request. Publishers do not need to take any additional steps.
Bug Fixes:
line_item_name
inonAdCached()
no longer returns values with extra quotes.
Version 4.4.1 (2023-08-03) π
Bug Fixes:
- Fix missing
onAdImpressionRecorded
call inChartboostMediationFullscreenAd
.
Version 4.4.0 (2023-07-27) π
Bug Fixes:
- Fixed an issue that prevented setting
customData
for the recently introducedChartboostMediationFullscreenAd
.
Version 4.3.0 (2023-06-22) π
Improvements:
- Added support for Rewarded Interstitials. This is available via
HeliumSdk.loadFullscreenAd()
and supported only in the latest adapters. Please check each adapterβs changelog to confirm which partners support rewarded interstitials. - Added new
ChartboostMediationFullscreenAd
APIs which combine and improve the interstitial and rewarded ad APIs. Previous interstitial and rewarded ad APIs are now deprecated. - Added
line_item_name
andline_item_id
towinningBidInfo
. - Added the ability to set consent and debug flags before calling
start()
. Only the last change is applied and will only be updated after the SDK has finished initializing.
Version 4.2.0 (2023-05-04) π
Improvements:
- Added support for multiple banner instances with the same Chartboost Mediation placement.
- Added error code
CM_335
to indicate a situation where all items in the waterfall have been exhausted.
Version 4.1.0 (2023-03-23) π
Improvements:
- Added
HeliumSdk.getAdapterInfo()
to get a list of initialized adapters. - Added CM_115 error code for Mediation initialization failure.
- Improved networking to have a more robust server communication layer. This adds Retrofit and some other related dependencies.
- Removed the Event Bus dependency.
Bug Fixes:
- Fixed a bug where a show failure would not allow future loading of a fullscreen placement unless it was cleared.
Version 4.0.2 (2023-03-23) π
Bug Fixes:
- Fixed a parsing issue that caused a crash when unknown keys were present.
Version 4.0.0 (2023-03-02) π
As part of the Marketing teamβs efforts to clearly articulate the use cases and customers we support by being more descriptive with our product branding, Helium is being rebranded as Chartboost Mediation.
Starting in 4.0.0, the Chartboost Mediation brand will be used in place of Helium for new additions. In the coming 4.X releases, the old Helium branding will be deprecated and the new Chartboost Mediation branding will be used to give publishers a smoother transition.
Improvements:
- Renamed the maven dependency to
com.chartboost:chartboost-mediation-sdk
. - Revamped partner adapter APIs. Partner adapters are now open source and hosted on individual git repositories. Review Android Migration from 3.x to 4.0.0 for the full partner list and more information on how to use the new adapters.
- Removed the hard-coded
Partner
list. - Renamed
HeliumError
toChartboostMediationAdException
and added more details to better identify the reason for failures and provide relevant context. - Unified interstitial and rewarded listeners into
HeliumFullscreenAdListener
. - Removed the
reward
parameter from theHeliumFullscreenAdListener
. - Unified the bid win and load callback into one
onAdCached
callback forHeliumBannerAdListener
andHeliumFullscreenAdListener
. - Moved the
loadId
from the return value ofload()
to their respective listenersβonAdCached()
. clearAd()
andclearLoaded()
methods no longer return a value.- Removed
onBackPressed()
fromHeliumSdk
.
Bug Fixes:
- Improve loading and caching ads, especially for banners. There should be fewer issues loading ads concurrently and during auto-refreshing banners.
Version 3.3.2 (2023-01-26) π
Bug Fixes:
- Fixed a bug where some Vungle programmatic ads fail to show when they are concurrently requested with non-programmatic ads.
- Improved error logging in the Vungle adapter.
- Fixed a bug when some networks would fail to fire the partner impression when a banner fails to load following a successful load.
- Downgraded Yahoo 1.3.0 to Verizon 1.14.0.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.8.0
- AdMob: 21.3.0
- AppLovin: 11.5.5
- Chartboost: 9.1.1
- Facebook Audience Network: 6.12.0
- Fyber Marketplace: 8.2.1
- Google bidding: 21.3.0
- InMobi: 10.1.1
- ironSource: 7.2.5
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.4.1
- Vungle: 6.12.0
- Yahoo: 1.14.0
Version 3.3.1 (2023-01-09) π
Bug Fixes:
- Fixed banner auto refresh settings not applying.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.8.0
- AdMob: 21.3.0
- AppLovin: 11.5.5
- Chartboost: 9.1.1
- Facebook Audience Network: 6.12.0
- Fyber Marketplace: 8.2.1
- Google bidding: 21.3.0
- InMobi: 10.1.1
- ironSource: 7.2.5
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.4.1
- Vungle: 6.12.0
- Yahoo: 1.3.0
Version 3.3.0 (2022-12-01) π
Improvements:
- Added ability to not initialize certain partners.
HeliumSdk#start
now can takeHeliumInitializationOptions
with aSet<String>
of skipped partner IDs to not initialize a particular partner. - Added several more metrics around ad lifecycle and initialization.
HeliumSdk#subscribeInitializationResults
for details for which partners initialized and how long it took. - Verified support for Android 13 (API level 33).
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.8.0
- AdMob: 21.3.0
- AppLovin: 11.5.5
- Chartboost: 9.1.1
- Facebook Audience Network: 6.12.0
- Fyber Marketplace: 8.2.1
- Google bidding: 21.3.0
- InMobi: 10.1.1
- ironSource: 7.2.5
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.4.1
- Vungle: 6.12.0
- Yahoo: 1.3.0
Version 3.2.0 (2022-10-20) π
Bug Fixes:
- Fixed potential null pointers when accessing
Ad.bids
.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.7.0
- AdMob: 20.6.0
- AppLovin: 11.3.1
- Chartboost: 8.3.1
- Facebook Audience Network: 6.8.0
- Fyber Marketplace: 8.1.3
- Google Bidding: 20.6.0
- InMobi: 10.0.5
- ironSource: 7.2.1
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.2.1
- Vungle: 6.10.5
- Yahoo: 1.14.0
Version 3.1.0 (2022-09-22) π
Improvements:
- Rate limiting added to all ad requests.
- Removed the usage of proguard for Helium and partner adapters.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.7.0
- AdMob: 20.6.0
- AppLovin: 11.3.1
- Chartboost: 8.3.1
- Facebook Audience Network: 6.8.0
- Fyber Marketplace: 8.1.3
- Google Bidding: 20.6.0
- InMobi: 10.0.5
- ironSource: 7.2.1
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.2.1
- Vungle: 6.10.5
- Yahoo: 1.14.0
Version 3.0.0 (2022-08-18) π
Improvements:
- Banner API updated from a load-show to a load-only paradigm. A summary of the changes is listed below:
HeliumBannerAd
load
now returns the load identifier.clearLoaded
renamed toclearAd
show
removed. Banners are ready to show upon successful load.readyToShow
removed since it is no longer necessary.
HeliumBannerAdListener
didShow
removed since it is no longer necessary.didClose
removed.didReceiveWinningBid
will only be invoked when automatic refresh has been disabled for the banner placement.
- Helium impression events are now separate from partner network impression events.
HeliumBannerAdListener
,HeliumInterstitialAdListener
, andHeliumRewardedAdListener
now havedidRecordImpression(placementName: String)
. These are for Helium impression events.- All ad formats now load their waterfalls in a sequential manner.
Bug Fixes:
- Banner automatic refresh ad loads are now tied to Helium impression events.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.7.0
- AdMob: 20.6.0
- AppLovin: 11.3.1
- Chartboost: 8.3.1
- Facebook Audience Network: 6.8.0
- Fyber Marketplace: 8.1.3
- Google Bidding: 20.6.0
- InMobi: 10.0.5
- ironSource: 7.2.1
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.2.1
- Vungle: 6.10.5
- Yahoo: 1.14.0
Version 2.11.0 (2022-07-07) π
Improvements:
- Improved Keyword targeting support.
Bug Fixes:
- Stop sending JSON
null
values in ILRD, winning bid info, and rewarded callback payloads.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.7.0
- AdMob: 20.6.0
- AppLovin: 11.3.1
- Chartboost: 8.3.1
- Facebook Audience Network: 6.8.0
- Fyber Marketplace: 8.1.3
- InMobi: 10.0.5
- ironSource: 7.2.1
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.0.1
- Vungle: 6.10.5
- Yahoo: 1.14.0
Version 2.10.0 (2022-05-19) π
Improvements:
- Added
setGameEngine(String name, String version)
to HeliumSdk to facilitate sending game engine information for Reserved Keywords Targeting. - All ad listeners now provide their callbacks on the main thread. It is now possible to directly call methods on Views in ad callbacks.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.7.0
- AdMob: 20.6.0
- AppLovin: 11.3.1
- Chartboost: 8.3.1
- Facebook Audience Network: 6.8.0
- Fyber Marketplace: 8.1.3
- InMobi: 10.0.5
- ironSource: 7.2.1
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.0.1
- Vungle: 6.10.5
- Yahoo: 1.14.0
Version 2.9.0 (2022-04-21) π
Improvements:
- Added support for sending keywords to all
HeliumAd
subclasses. - Added
didClick()
to all ad listeners. - Moved Helium to a private maven repository. Please include
maven { url '<https://cboost.jfrog.io/artifactory/helium>' }
in the repositories section of yourbuild.gradle
.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.7.0
- AdMob: 20.6.0
- AppLovin: 11.3.1
- Chartboost: 8.3.1
- Facebook Audience Network: 6.8.0
- Fyber Marketplace: 8.1.3
- InMobi: 10.0.5
- ironSource: 7.2.1
- Mintegral: 16.0.31
- TapJoy: 12.9.1
- UnityAds: 4.0.1
- Vungle: 6.10.5
- Yahoo: 1.14.0
Version 2.8.0 (2022-03-24) π
Improvements:
- Added Yahoo mediation support.
- Banner auto refresh no longer fires
didCache()
,didReceiveWinningBid()
, anddidShow()
. - Banner gravity is now set to
CENTER
. - Banner containers are now transparent.
- AdMob no longer requires an Activity on initialization and load and for banners on show.
Bug Fixes:
- ironSource adapter handles multiple loads better.
This version of the Helium SDK includes support for the following Ad Providers:
- AdColony: 4.7.0
- AdMob: 20.6.0
- AppLovin: 11.2.2
- Chartboost: 8.3.1
- Facebook Audience Network: 6.8.0
- Fyber Marketplace: 8.1.3
- InMobi: 10.0.3
- ironSource: 7.2.1
- Mintegral: 16.0.21
- TapJoy: 12.9.1
- UnityAds: 3.7.5
- Vungle: 6.10.3
- Yahoo: 1.14.0
Version 2.7.1 (2022-03-08) π
Bug Fixes:
- Changing the visibility of a banner before show no longer affects auto refresh.
Version 2.7.0 (2022-03-03) π
Improvements:
- Added support for Android 12L (API 32).
Bug Fixes:
- Not visible banners no longer autorefresh.
clearLoaded()
on a showing banner no longer breaks that banner permanently.
This version of the Helium SDK includes support for the following Ad Providers:
- Chartboost: 8.3.1
- Tapjoy: 12.9.0
- Facebook Audience Network: 6.8.0
- AdColony: 4.6.5
- AdMob: 20.5.0
- Vungle: 6.10.3
- AppLovin: 11.1.2
- UnityAds: 3.7.5
- ironSource: 7.2.0
- Fyber Marketplace: 8.1.2
- InMobi: 10.0.3
- Mintegral: 16.0.11
Version 2.6.0 (2022-02-15) π
Improvements:
- Impression Level Revenue Data support.
- Rewarded callback support.
- Reintroduced
partner_id
to the winning bid information. - Added COPPA settings on
HeliumSdk
.
Bug Fixes:
- Updated the US privacy string to
-
for LSPA for Fyber and Tapjoy. - Resolved a regression in 2.5.1 that lead to the Unity consent prompt to show. The Unity adapter will use the publisher provided consent.
This version of the Helium SDK includes support for the following Ad Providers:
- Chartboost: 8.3.1
- Tapjoy: 12.9.0
- Facebook Audience Network: 6.8.0
- AdColony: 4.6.5
- AdMob: 20.5.0
- Vungle: 6.10.3
- AppLovin: 11.1.2
- UnityAds: 3.7.5
- ironSource: 7.1.14
- Fyber Marketplace: 8.1.2
- InMobi: 10.0.3
- Mintegral: 16.0.11
Version 2.5.1 (2022-02-03) π
Improvements:
- Updated GDPR and CCPA handling for all networks.
Version 2.5.0 (2022-01-14) π
Improvements:
- Banner Support*
- Mintegral Header Bidding support.
- Added Fyber, InMobi, & Mintegral mediated support.
- Updated Partner SDK Dependencies.
- Various improvements and fixes.
*Banner Support is currently supported for the following Ad Providers:
- Chartboost
- Facebook Audience Network
- AdColony
- AdMob
- Vungle
- AppLovin
- Unity Ads
- Fyber
- InMobi
- Mintegral
This version of the Helium SDK includes support for the following Ad Providers:
- Chartboost: 8.3.0
- Tapjoy: 12.8.1
- Facebook Audience Network: 6.8.0
- AdColony: 4.6.5
- AdMob: 20.5.0
- Vungle: 6.10.3
- AppLovin: 10.3.5
- UnityAds: 3.7.5
- ironSource: 7.1.12.2
- Fyber Marketplace: 8.1.0
- InMobi: 10.0.1
- Mintegral: 15.7.21
Version 2.3.2 (2021-12-08) π
Improvements:
- Vungle Support for 6.10.1 & newer.
- Updated Partner SDK Dependencies.
This version of the Helium SDK includes support for the following Ad Providers:
- Chartboost: 8.2.1
- Tapjoy: 12.8.1
- Facebook Audience Network: 6.8.0
- AdColony: 4.6.5
- AdMob: 20.4.0
- Vungle: 6.10.2
- AppLovin: 10.3.5
- UnityAds: 3.7.5
- ironSource: 7.1.12.1
Version 2.3.1 (6-24-2021) π
Improvements:
- Vungle Header Bidding Support.
- Updated Partner SDK Dependencies.
- Helium Adapters will now follow a
d.d.d.d
version format.
This version of the Helium SDK includes support for the following Ad Providers:
- Chartboost: 8.2.1
- Tapjoy: 12.8.1
- Facebook Audience Network: 6.5.0
- AdColony: 4.5.0
- AdMob: 19.7.0
- Vungle: 6.9.1
- AppLovin: 10.3.1
- UnityAds: 3.7.2
- ironSource: 7.1.5.1
Version 2.2.1 (12-18-2020) π
Improvements:
- Chartboost SDK 8.2.0 support.
- Updated Partner SDK Dependencies.
- Updated UnityAds Adapter.
This Helium SDK version supports the following Ad Networks:
- Chartboost: 8.2.0
- Tapjoy: 12.7.1
- Facebook Audience Network: 6.2.0
- AdColony: 4.3.1
- AdMob: 19.6.0
- Vungle: 6.8.1
- AppLovin: 9.14.8
- UnityAds: 3.6.0
- ironSource: 7.0.4.1
Version 2.2.0 (11-20-2020) π
Improvements:
- New clearLoaded API method.
- Various improvements and fixes.
This Helium SDK version supports the following Ad Networks:
- Chartboost: 8.1.0
- Tapjoy: 12.7.1
- Facebook Audience Network: 6.2.0
- AdColony: 4.3.0
- AdMob: 19.5.0
- Vungle: 6.8.1
- AppLovin: 9.14.6
- UnityAds: 3.5.0
- ironSource: 7.0.3.1
Version 2.1.0 (2020-10-02) π
- Added UnityAds and IronSource support.
- Various improvements and fixes.
This Helium SDK version supports the following Ad Networks:
- Chartboost: 8.1.0
- Tapjoy: 12.6.1
- Facebook Audience Network: 5.11.0
- AdColony: 4.2.2
- AdMob: 19.4.0
- Vungle: 6.7.0
- AppLovin: 9.13.4
- UnityAds: 3.4.6
- ironSource: 7.0.1.1
Version 2.0.4 (2020-8-24) π
- Added CCPA, GDPR and User Consent setters.
- Fixed a bug where, after a failed ad load, a placement would become unusable.
- Fixed an issue where Tapjoy would fail to initialize.
- Fixed an issue where Admob would fail to load ads.
- Improved logging for easier debugging and more informative output.
This Helium SDK version supports the following Ad Networks:
- Chartboost: 8.1.0
- Tapjoy: 12.6.1
- Facebook Audience Network: 5.10.1
- AdColony: 4.2.2
- AdMob: 19.4.0
- Vungle: 6.7.0
- AppLovin: 9.13.4
Version 2.0.0 (2020-5-15) π
Improvements:
- Application Context needs to be passed in the Helium SDK:
- Helium SDK no longer requires the inclusion of the lifecycle callbacks.
- SDKs (except for Chartboost) now require their own separate Helium Adapter. See integration instructions.
This Helium SDK version supports the following Ad Networks:
- Chartboost: 8.0.1+
- Tapjoy: 12.4.2+
- Facebook Audience Network: 5.7.1+
- AdColony: 4.1.4+
- AdMob: 19.0.0+
- Vungle: 6.5.2+
- AppLovin: 9.11.5+
Version 1.1.0 (2019-10-29) π
Improvements:
- Added Support for AdColony (see integration docs).
- Added Test Mode for assisting during integration.
- Added Bintray support (see integration docs).
- Chartboost: 7.5.1+
- TapJoy 12.2.0+
- Facebook Audience Network: 5.3+
- AdColony: 3.3.11+
Version 1.0.0 (2019-8-15) π
Improvements:
- Support for Chartboost.
- Support for Tapjoy.
- Support for Facebook Audience Network.
- Support for Interstitial Ads.
- Support for Rewarded Ads.
- Winning bid information.
This Helium SDK version supports the following Ad Networks:
- Chartboost: 7.5.0+
- TapJoy 12.2.0+
- Facebook Audience Network: 5.3+