# Android Changelog

Refer to [Integrate Network SDKs](/en/mediation/integrate/android/integrate-network-sdks/) for the latest Android Mediation SDK.

## 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)`](https://s3.amazonaws.com/reference.docs/mediation/android/4.8.0/-helium/com.chartboost.heliumsdk.ad/-helium-banner-ad-listener/index.html) 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`](https://chartboost.github.io/chartboost-mediation-android-sdk/4.6.0/-helium/com.chartboost.heliumsdk.ad/-helium-banner-ad/-helium-banner-size/index.html?query=class%20HeliumBannerSize) for options.
- Added `onAdViewAdded(placementName: String, child: View?)` to `HeliumBannerAdListener`.

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` in `onAdCached()` no longer returns values with extra quotes.


## Version 4.4.1 _(2023-08-03)_

Bug Fixes:

- Fix missing `onAdImpressionRecorded` call in `ChartboostMediationFullscreenAd`. 



## Version 4.4.0 _(2023-07-27)_

Bug Fixes:

- Fixed an issue that prevented setting `customData` for the recently introduced `ChartboostMediationFullscreenAd`.



## 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` and `line_item_id` to `winningBidInfo`.
- 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](/en/mediation/integrate/android/migration-from-3x-to-4x/) for the full partner list and more information on how to use the new adapters.
- Removed the hard-coded `Partner` list.
- Renamed `HeliumError` to `ChartboostMediationAdException` 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 the `HeliumFullscreenAdListener`.
- Unified the bid win and load callback into one `onAdCached` callback for `HeliumBannerAdListener` and `HeliumFullscreenAdListener`.
- Moved the `loadId` from the return value of `load()` to their respective listeners’ `onAdCached()`.
- `clearAd()` and `clearLoaded()` methods no longer return a value.
- Removed `onBackPressed()` from `HeliumSdk`.

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 take `HeliumInitializationOptions` with a `Set<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 to `clearAd`
    - `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`, and `HeliumRewardedAdListener` now have `didRecordImpression(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 your `build.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()`, and `didShow()`.
- 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+_