Unity Changelog
Version 4.9.0 (2024-03-21) 🔗
The following new dependencies are added:
"com.chartboost.unity.threading": "1.0.0"
"com.chartboost.unity.utilities": "1.0.0"
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.
API Changes:
- Added Fullscreen Ad related events to
IChartboostMediationFullscreenAdobject. - Marked events in
ChartboostMediationFullscreenAdLoadRequestas deprecated. Use events fromIChartboostMediationFullscreenAdinstead.
Version 4.8.0 (2024-02-08) 🔗
The following ad networks have been deprecated:
- AdColony
- TapJoy
- Yahoo
Improvements:
- New Chartboost Mediation Unity SDK demo app.
Bug Fixes:
- Fixed an issue with incorrect order of callbacks when
ContinueWithOnMainThreadTask extension is used. - Fixed an issue where
CustomDatawould always be null for iOS fullscreen placements. - Fixed an issue where
SKAdNetworkutilities would fail to account for JSON parsing issues. - Fixed an issue where
AdapterWindowsutilities would fail to account for deprecated ad networks.
Version 4.7.0 (2023-11-14) 🔗
Chartboost Mediation Unity SDK 4.7.0 is the last release for 2023. As such, we strive to make as many improvements and bug fixes as possible. However, there are a few breaking changes with this release in preperation for an easier transition to Chartboost Mediation 5.X in 2024.
Improvements:
- Added
AdaptersInfodata class to Chartboost Mediation Unity SDK. Integrated ad adapter information can be fetched usingChartboostMediation.AdaptersInfo. - Added per partner consent API. Ad partner consent can be set individually utilizing the new consent API.
Adapters.cshas been deprecated and replaced byPartners.cs.- Added
ContainerSizeproperty to the newIChartboostMediationBannerView, allowing developers to get the size of the banner container. - Added a setter to
ChartboostMediationSettingswhich allow developers to set their own instance of the scriptable object. - Converted hard coded strings into constants across the codebase.
- Editor Windows
AdaptersandSettingshave been modularized and can be enabled or disabled as needed. - Added a main thread task continuation extension. Please use this if you would like to call asynchronous APIs from a synchronous code and want to handle results.
- Added distribution of package through Nuget.
The following improvements will cause breaking changes:
ChartboostMediationUnityBannerAdEventhas been modified and now passes the associated instance into delegates as a parameter.- Moved
ChartboostMediationFullscreenAdLoadResult.csfromChartboost.ResultstoChartboost.Requestsnamespace. - Removed
Chartboost.Resultsnamespace.
Bug Fixes:
- Fixed compiler warnings for deprecated API calls on all platforms. Compiler flag
-warnaserrorhas been added to test projects to avoid future similar issues. - Updated Usage of Getting Screen Scale on iOS 17+.
UIScreen.Main.Scalehas been deprecated. - Fixed the issue on Android where banner ads utilizing the new
BannerView APIwould always load on thetop-leftlocation regardless of the selected location.
Version 4.6.0 (2023-10-12) 🔗
Improvements:
- Added a new
ChartboostMediationBannerViewAPI for banner ads which supports adaptive banners. - Added a new
ChartboostMediationUnityBannerAdAPI which allows creating and loading of banner ads using Unity gameobjects. - EDM updated to version 1.2.177.
Bug Fixes:
- Initialization on unsupported platform now triggers
DidStartwith error. - Logger.Logerror now calls Debug.Logerror instead of Debug.Log.
API Changes:
- Marked
ChartboostMediationBannerAdas deprecated. UseChartboostMediationBannerViewinstead.
Version 4.5.0 (2023-08-31) 🔗
- Fixed a typo in ad-adapters.md
- Updated native dependencies to support native SDKs for Chartboost Mediation SDK.
Version 4.4.0 (2023-07-27) 🔗
Improvements:
- Added new SDK initialization method
ChartboostMediation.StartWithOptions. - Fixed garbage collection ad disposal and invalidation logic.
- Changed
ChartboostMediation.UnexpectedSystemErrorDidOccurto be sent into the Unity main-thread. - Added a new
EditorWindowandSettingsWindow.csto unify the Chartboost Mediation integration into a single location. It can be accessed through the menu itemChartboost Mediation/Configure. The following feature improvements can be enabled through the new settings window:- Added build postprocessing capabilities to automatically add
GADApplicationIdentifiertoInfo.plist. - Added build postprocessing capabilities to disable bitcode for XCode projects.
- Added build preprocessing capabilities to automatically add
com.google.android.gms.ads.APPLICATION_IDto theAndroidManifest.xml. - Added build preprocessing capabilities to automatically add
applovin.sdk.keyto theAndroidManifest.xml.
- Added build postprocessing capabilities to automatically add
API Changes:
- Marked
ChartboostMediationPartnersenum as deprecated. UseChartboostMediation.StartWithOptionsinstead.
Version 4.3.0 (2023-06-22) 🔗
Improvements:
- Added support for Rewarded Interstitials. This is available via
ChartboostMediation.LoadFullscreenAd()and supported only in the latest adapters. Please check each adapter’s changelog to confirm which partners support rewarded interstitials. - Added new
ChartboostMediationFullscreenAdAPIs which combine and improve the interstitial and rewarded ad APIs. Previous interstitial and rewarded ad APIs are now deprecated. - Added
LineItemNameandLineItemIdtoBidInfo. - 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.
Bug Fixes:
- Added newly released networks into partner kill switch enum.
Version 4.2.3 (2023-05-18) 🔗
Bug Fixes:
- Fixed an issue with Unity-iOS Rewarded Ads hanging onto the ad instances for too long, potentially causing duplicate callback events.
Version 4.2.2 (2023-05-10) 🔗
Improvements:
- Updated AdaptersWindow.cs to utilize a more comprehensive JSON schema for better handling of network dependency changes.
Bug Fixes:
- Fixed an issue with InMobi SDK dependencies not being properly defined due to versioning differences.
Version 4.2.1 (2023-05-05) 🔗
Bug Fixes:
- Fixed an issue where package information failed to load if projects had a large amount of packages.
- Fixed an issue where main SDK dependency could not be generated through UPM implementation.
Version 4.2.0 (2023-05-04) 🔗
Added:
- Editor Window,
AdaptersWindow.cs, for Chartboost Mediation adapters handling. For capabilities, see below:- Ad Adapters are now decoupled from the Chartboost Mediation UPM package.
- Ad Adapters can be fetched, selected, and upgraded through the new Adapters Window.
Adapters Windowcan be accessed through theChartboost Mediation/Adaptersmenu.- Public C# API is available to automate tasks such as upgrading, adding, loading, and saving Ad Adapter selections.
- Adapters information is automatically fetched on startup and manually through the Adapters Window.
Improvements:
- Fixed standardized error reporting of
ChartboostMediationErrorcomponents in iOS.
API Changes:
- Marked
ChartboostMediationIntegrationChecker.csas deprecated. Please utilizeAdaptersWindow.csinstead.
Version 4.1.0 (2023-03-30) 🔗
Improvements:
- Simplified AppId & AppSignature accessors in
ChartboostMediationSettings. - Added
TestModecall toChartboostMediation.cs. - Made Chartboost Mediation errors readable from iOS native layer to Unity.
- Refactored native bridge projects to follow rebranding and newer APIs.
- Fixed usage of placements for unsupported platforms.
- Updated documentation with AdMob and AppLovin AndroidManifest special cases.
Bug Fixes:
- Fixed placements
clearLoadedin native implementations to return void instead of boolean. - Fixed an issue for iOS banners crashing on removal.
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:
- Revamped Helium delegates & callbacks API. (more details to come soon.)
- Added optional PostProcessor to simplify
SKAdNetworkintegration process. - Refactored Ad Placement objects so they return empty values in unsupported platforms.
- Cleanup and Refactoring of iOS Dependencies; native SDKs are now explicitly stated.
- Fixed LogError method in HeliumExternal.
- Banners
ClearLoadedmethod no longer returns a boolean value. - Removed
rewardparameter from Reward callback since value was not being utilized. - Minimum iOS version changed to 12.0
Deletions:
-
Removed obsolete APIs in
HeliumSettings.csnew accessors are available.
API Changes & Rebranding: -
New npm package distribution under
com.chartboost.mediation -
Namespace
Heliumdeprecated and replaced withChartboost. -
HeliumIntegrationCheckerdeprecated and replaced withChartboostMediationIntegration Checker. -
HeliumErrorremoved and replaced with descriptivestringvalues. -
HeliumBidInforenamed toBidInfo -
Delegates have been renamed from
HeliumtoChartboostMediation: -
ChartboostMediationPlacementLoadEventadded, it provides bid info on load. -
HeliumRewardEventconverted to standardChartboostMediationPlacementEvent. -
HeliumBidEventmerged into Load delegate mentioned above. -
HeliumInterstitialAdrenamed toChartboostMediationInterstitialAd -
HeliumRewardedAdrenamed toChartboostMediationRewardedAd -
HeliumBannerAdrenamed toChartboostMediationBannerAd -
HeliumBannerAdSizerenamed toChartboostMediationBannerAdSize -
HeliumBannerAdScreenLocationrenamed toChartboostMediationBannerAdScreenLocation -
HeliumSettingsrenamed withChartboostMediationSettings -
HeliumPartnersrenamed toChartboostMediationPartners
For details on how to migrate from Helium 3.X to Chartboost Mediation 4.0.0, visit the corresponding documentation.
Android Migration from 3.x to 4.0.0
iOS Migration from 3.x to 4.0.0
Unity Migration from 3.x to 4.0.0
Version 3.3.2 (2023-01-26) 🔗
Bug Fixes:
- Downgraded Yahoo 1.3.0 to Verizon 1.14.0.
Version 3.3.1 (2022-12-06) 🔗
Bug Fixes:
- Updated FAN Dependency from 6.9.0 to 6.12.0
Version 3.3.0 (2022-12-01) 🔗
Improvements:
- Refactoring of HeliumSettings Scriptable Object API.
- Network Kill Switch.
- Provide a Publisher API for Partner Initialization Metrics.
Bug Fixes:
NullReferenceExceptionafter initialization without callback subscription.- Credentials warning spamming
- Detect Misconfigured Unity setup & utility methods.
Version 3.2.0 (2022-10-20) 🔗
Improvements:
- Converted Android Java bridge to Kotlin.
Documentation:
- Improved UnityAds integration guide and requirements.
Version 3.1.0 (2022-09-15) 🔗
Improvements:
- Removed proguard for Android/Unity integration.
Bug Fixes:
- Clear Ad requests return proper clear status. Banners always return true when cleared
Version 3.0.0 (2022-08-18) 🔗
Improvements:
- Unity Package Manager distribution of the Helium SDK.
- Helium Unity APIs updated to follow Unity/C# standard coding conventions.
- Banner API updated from a load-show to a load-only paradigm.
- Helium impression events are now separate from partner network impression events.
- Sequential waterfall ad loading for all ad formats.
- Removal of UnitySendMessage callbacks for proper Native callbacks on Android & iOS
HeliumBannerAdShowremoved. Banners are ready to show upon successful load.ReadyToShowremoved since it is no longer necessary.
HeliumSDKDidShowBannercallback removed since it is no longer necessary.- Added the following callbacks for when Helium determines an ad to be visible on screen.
DidRecordImpressionInterstitialDidRecordImpressionRewardedDidRecordImpressionBanner
Bug Fixes:
- Ad load requests to the native Helium SDKs are dispatched to a background thread.