Download & integrate the Chartboost SDK for Unity

Version 8.2.1 (July 7th, 2021) (current version)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 8.4.2
• Android: Version 8.2.1
• Chartboost supports iOS 9 and Android 5.0.
• Chartboost supports Unity 2017 and above.

Version 8.1.0 (July 10th, 2020) (current version)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 8.2.0
• Android: Version 8.1.0
• Chartboost supports iOS 9 and Android 5.0.
• Chartboost supports Unity 2017 and above.
• Features & Improvements:
• New API for handling GDPR and CCPA: Chartboost.addDataUseConsent().

Version 7.3.0 (Oct 25th, 2018)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.3.0
• Android: Version 7.3.0

The Chartboost SDK requires API level 16 (Android OS 4.1) or higher.

Features & Improvements:

• New API for handling GDPR – void setPIDataUseConsent(CBPIDataUseConsent consent);.
• API restrictDataCollection has been deprecated.
• The process for importing the Google Play Services Library for Android project has changed. Refer to Step 2 of the Unity SDK Integration instructions for importing the Google Play Services Library via the separate “Play Services Resolver” plugin.

Version 7.2.0 (May 3, 2018)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.2.0
• Android: Version 7.2.0

The Chartboost SDK requires API level 16 (Android OS 4.1) or higher.

Features & Improvements:

• Added support GDPR consent.
• Added ability to mute ads in iOS.

Version 7.1.0 (Apr. 2, 2018)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.1.2
• Android: Version 7.1.0

The Chartboost SDK requires API level 16 (Android OS 4.1) or higher.

Features & Improvements:

• Enabled Moat viewability technology to allow serving of brand-based ads.

Unity Fixes:

• Updated support messaging.
• Updated from deprecated UnityPlayerNativeActivity class to UnityPlayerActivity.
• Updated Android minSDKVersion from 9 to 16.

Version 7.0.2 (Mar. 7, 2018)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.1.2
• Android: Version 7.0.1

Unity Fixes:

• didDismissInterstitial delegate no longer fires early.

Version 7.0.1 (Dec. 15, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.0.4
• Android: Version 7.0.1

Unity Fixes:

• Project can now be built with the “Gradle (New)” setting.

Version 7.0.0 (Sep. 15, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 7.0.1
• Android: Version 7.0.0

Unity Fixes:

• Updated conditional compilations to include Unity 2017.
• Fixed issue with age gate not being shown in iOS.

Version 6.6.4 (August 8, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.3
• Android: Version 6.6.3

Unity Fixes:

• Fixed compile issue with Unity 2017.1

Version 6.6.3 (May 8, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.3
• Android: Version 6.6.3

Unity Fixes:

• Removed duplicate .jar file.

Version 6.6.2 (Apr. 4, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.2
• Android: Version 6.6.3

Features & Improvements:

• Removed references to MoreApps.

Version 6.6.1 (Jan. 12, 2017)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.1
• Android: Version 6.6.1

Features & Improvements:

• Added AerServ to mediation enumeration.

iOS Features & Improvements:

• Updated the underlying headers and shared lib for the Unity iOS plugin.

Version 6.6.0 (Nov. 30, 2016)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.6.0
• Android: Version 6.6.1

Important: iOS 6 is no longer supported. iOS 7.0 is the minimum supported iOS version. iOS Features:

• Added support for AerServ mediation.

iOS Fixes:

• Black background image no longer appears during video playback.
• App no longer freezes when backgrounding right after video playback.
• MoreApps respects the status bar app settings.

iOS Improvements:

• Improved rendering performance when rotating an ad.

Android Features:

• Added support for AerServ mediation.
• Added support for Heyzap mediation.

Android Improvements:

• Added reasoning for certain app permissions in the manifest.
• Reduced DEX method count by 606 in com.chartboost and 629 overall.

Android Fixes:

• MoreApps page no longer fail to show when the loading bar is enabled.
• didShow delegate is no longer called when an ad is not shown.
• Device identifiers updated on every request.
• Fixed an issue with close button placement.
• Optimized template parameter replacement.
• Cached ads are no longer shared between activities.
• Fixed a NullPointerException when backgrounding the app.
• Fixed issues with ironSource mediation.
• Fixed issues with DT FairBid/DT Exchange mediation.
• Fixed issues with Corona mediation rewarded video.

closeImpression() functionality has been deprecated.

Version 6.5.1 (Sept. 29, 2016)

This version of the Unity SDK includes the following native SDKs:

• iOS: Version 6.5.2
• Android: Version 6.5.1

Android Fixes:

• Tilting the screen during an ad no longer changes app orientation incorrectly.

iOS Fixes:

• Fixed a bug that could display defects on ads when the app loses and regains focus.

Version 6.5.0 (Sept. 22, 2016)

iOS 6 is no longer supported. The minimum supported version is iOS 7.0.

This version of the Unity SDK includes the following native SDKs:

• Android: Version 6.5.1
• iOS: Version 6.5.1

Unity Features & Fixes

• Deprecated Android methods have been removed; please see Android notes below.
• Added HyprMX as a CBMediation value.

Android Features

• Chartboost SDK now uses network compression for improved performance.

Android Improvements

• void setFrameworkVersion() has been deprecated. Please use void setChartboostWrapperVersion() to set wrapper version.
• Added new mediation enum value HyprMX.
• Error codes are more accurate and descriptive.
• Previously deprecated methods and classes now removed:
• ChartboostActivity class
• boolean getIgnoreErrors()
• void setIgnoreErrors(boolean ignoreErrors)
• void didPassAgeGate(boolean pass)
• void setShouldPauseClickForConfirmation(boolean shouldPause)
• void clearCache()
• void setFramework (final CBFramework framework)
• boolean getImpressionsUseActivities()
• void setImpressionsUseActivities(final boolean impressionsUseActivities)
• void didPauseClickForConfirmation()
• void didPauseClickForConfirmation(Activity activity)

Android Fixes

• Invalid server responses no longer accepted as valid
• Fixed an issue with the back button not calling the dismiss/close delegates.
• Cached ads will no longer fail to show.
• SDK will no longer keep 0 byte files in cache when a download fails.
• Video ads no longer stay paused after maximizing a minimized app.

iOS Features

• Networking stack has been upgraded to AFNetworking 3.0.
• Added features to help support iOS changes to limit of ad tracking.
• iOS 10 compatibility.

iOS Fixes

• Fixed IFV reporting bug.
• Fixed bug that could retain a bad ad unit in the cache.
• Fixed bug that could send an inaccurate list of local videos to the server.
• Changed timeout for bad ad units to 3 seconds to avoid excessive loading bar wait time.

Version 6.4.5 (June 30, 2016)

This version of the Unity SDK includes the following native SDKs:

• Android: Version 6.4.2
• iOS: Version 6.4.6

Android Features

• The Chartboost Android SDK no longer supports the age gate feature. API methods related to age gate are being deprecated and will be removed in a future release.
• Publishers only: All Chartboost ads are now shown using CBImpressionActivity. You must add CBImpressionActivity to your AndroidManifest.xml file, like this:<activity android:name="com.chartboost.sdk.CBImpressionActivity"
                                 android:excludeFromRecents="true"
                                 android:hardwareAccelerated="true"
                                 android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
                             android:configChanges="keyboardHidden|orientation|screenSize" />Note: Make sure hardware acceleration is added and enabled when declaring the CBImpressionActivity in the manifest.

Android Fixes

• Media loading is now more efficient.
• Memory usage on devices has been optimized.
• Video download is now more efficient.
• Fixed ConcurrentModificationException occurring in some devices.
• Fixed issue with video playback when backgrounding.
• Fixed IMPRESSION_ALREADY_VISIBLE error.

iOS Fixes

• Fixed Native Ads crash when clicking.
• Fixed intermitent issue when plugging or unplugging headphones.
• Fixed several threading issues leading to a EXC_BAD_ACCESS KERN_INVALID_ADDRESS error.

Version 6.4.4 (May 5, 2016)

Fixes:

• Various bug fixes.

Version 6.4.2 (April 7, 2016)

Fixes:

• Various bug fixes.

Version 6.4.1 (Mar. 29, 2016)

Fixes:

• Various bug fixes.

Version 6.4.0 (Mar. 14, 2016)

• With this SDK we will begin rolling out a brand new Chartboost Video experience, specially tailored for games. Upgrade now!
• We’ve also improved key features like video caching, memory management, and data usage for optimal SDK performance.

Features & Improvements

• Added a retry mechanism for downloading failed assets.
• iOS: Calls to ‘cacheInterstitial’ and ‘cacheRewarded’ have been optimized to require less memory.
• iOS: Interstitials will now fail gracefully instead of showing with missing assets.
• iOS: Closing the “loading” view has moved to the main thread.
• Android: Cached impressions on soft bootups are invalidated if any shared assets are deleted.
• Android: Fixed issues causing “Could Not Delete Cache Entry for key” log message on startup.

Version 6.3.0 (Feb. 16, 2016)

Upgrade now to get ready for the new Chartboost Video V2 experience, rolling out in Q1. Features & Improvements:

• Android: Older devices in the networking library no longer crash on occasion.
• Android: MoreApps rotation issue has been resolved.
• Android: Removed “Could Not Delete Cache Entry for key” notification from logs.
• Android: Fixed “Internal_Create can only be called from the main thread” warning.
• iOS: Certain network request failures no longer cause a crash.

Version 6.2.0 (Jan. 25, 2016)

Features & Improvements:

• Added didInitialize() delegate callback to notify when the SDK is initialized and ready to use.
• Android: Screen no longer turns black on occasion when playing videos.
• Android: Chartboost impressions no longer have a translucent view behind them.
• Android: Improved handling of views when the app is minimized after clicking an ad.
• Android: More efficient handling of cached assets now reduces network usage.
• Android: InPlay now triggers the failure delegate on failure.
• iOS: Blank ads no longer appear when the device is rotated into an unsupported orientation.
• iOS: App no longer crashes on startup when CoreData does not initialize (frequently occurred if device was out of memory).
• iOS: Fixed a rare crash that occurred when reopening the app after an ad is displayed.

Version 6.0.2 (Oct. 29, 2015)

Features & Improvements:

• Video experience rebuilt from the ground up.
• Android: Android 6.0 Marshmallow Features support.
• Ensure your Android project targets API Level 23 (However, “minimum” SDK can still target API Level 9).
• iOS: Supports Bitcode submissions for iOS 9.
• iOS: Removed deprecated Chartboost Newsfeed product.
• setMediation now uses enumerated constants for partners.
• Android: Required to ensure compatibility with Android 6.0 devices: Ensure your Android project builds and compiles against API Level 23
• Android: Updated AndroidManifest.xml to include com.chartboost.sdk.CBImpressionActivity
• Android: New recommended permission android.permission.READ_PHONE_STATE allows the SDK to handle calls interrupting video playback during videos.
• Android: No longer attempting to destroy already-destroyed Chartboost instances.
• iOS: cacheRewardedVideo no longer stops audio of the playing video.
• iOS: Removing headphones during the rewarded video confirmation screen no longer starts the video.
• iOS: Accepting or declining a phone call during the rewarded video confirmation screen no longer starts the video.

Version 5.5.3 (Aug. 5, 2015)

Features & Improvements:

• Android: Fixed a crash in the retry event system.

Version 5.5.1 (Jul. 16, 2015)

Features & Improvements:

• We temporarily pulled v5.5.1 to address a crash bug when retrying events in airplane mode.
• iOS: Fixed bug that prevented InPlay button response in example app included in SDK download package.
• iOS: Fixed an issue that crashed or hung the SDK while detecting jailbroken device status during initialization.

Version 5.5.0 (Jun. 29, 2015)

Compatible only with iOS 6.0+. If you need compatibility with older iOS versions, contact us!Features & Improvements:

• iOS: AFNetworking library updated to version 2.5.4.
• iOS: Rewarded videos no longer need to wait until the video prefetch is complete before showing an existing video.
• Added a Chartboost.Create() method that will create a Chartboost gameObject if one does not already exist. It is no longer necessary to drag one into the first scene as long – as you call this method at least once.
• The Chartboost gameObject no longer creates a second instance if one already exists.
• Fixed InPlay UI bug in sample app in Unity plugin download package.
• Android: Age gate now properly blocks video ads between the didPauseClickForConfirmation call and the successful didPassAgeGate response.
• Android: Optimized the Chartboost.cs onGUI() call to reduce memory allocations per frame.
• Android: Removed an unnecessary video prefetch call.
• Android: Fixed bug that caused Chartboost activity leaking in some cases.
• Android: Prevented MoreApps page loading screen from displaying before static interstitial and rewarded video ads.
• Android: Corrected time zone format in reporting from devices running Android OS version 4.1 and older.
• iOS: Fixed bug that prevented video ads from resuming/being dismissed after incoming phone calls.
• iOS: Corrected video prefetch behavior to prevent unwanted deletions of video ads prior to /show calls.
• iOS: Fixed bug that prevented proper caching of new MoreApps page data after /more/show call.
• iOS: Suppressed erroneous CoreData Unable to load class named 'CBHTTPRequestEntity' warning message.

Version 5.4.1 (Jun. 4, 2015)

Features & Improvements:

• Android: Fixed bug that caused Chartboost media files to appear in the Gallery app.

Version 5.4.0 (Jun. 1, 2015)

Features & Improvements:

• Added a ChartboostExample UI that shows delegate logs and cache states and lets you set various other – including age gate – options.
• Added CBCLickError enums for the didFailToRecordClick delegate.
• Android: Added IAP button to sample project included with SDK download.
• Android: Added error logging for all network calls.
• Android: Fixed bug causing ads to disappear on rotation while using activities.
• Android: Rewarded video pre-roll screen now properly displays after home key input.
• Android: Fixed null pointer exception that occurred when initializing Chartboost and making calls on different threads.
• Android: Fixed rare bug that prevented video prefetching under certain circumstances.

Version 5.3.0 (May 7, 2015)

Features & Improvements:

• Native Chartboost SDKs now send the version of the Unity wrapper SDK along with every request.
• Added Weeby to available frameworks.
• iOS: Added "rooted_device":true or "rooted_device":false to /api/install call REQUEST body to detect jailbroken devices.
• iOS: Fixed issue that stalled video playback after declined phone calls.

Version 5.2.1 (Apr. 13, 2015)

Features & Improvements:

• Fixed issue that caused CoreData crash on first bootup.
• Corrected symbol collision with third-party SDKs on audioRouteChangeListenerCallback
• Corrected symbol collision with third-party SDKs on MakeStringCopy
• Fixed bug preventing MoreApps page resize on device orientation change.
• Resolved Unity 5 Xcode build problem.

Version 5.2.0 (Apr. 6, 2015)

Features & Improvements:

• iOS: Added a developer-facing function, closeImpression, to force-close any visible impression or loading view.
• iOS: Added a new method to CBAnalytics, trackInAppPurchaseEventWithString, that acts like the trackInAppPurchaseEvent but takes a string instead of raw receipt data to allow frameworks to pass in base64-encoded receipts.
• iOS: Added new Core Data-backed persistence layer for the Chartboost request manager.
• Updated Amazon IAP library to v2.0.
• PIA Level Tracking available in CBAnalytics (contact your account manager or Support for information about Level Tracking).
• Improved SDK batch requests for an endpoint to cut down on outgoing network requests. Only enabled for Level Tracking.
• iOS: The receipt parameter to Chartboost.trackInAppAppleStorePurchaseEvent() is now assumed to be a base64-encoded string. Added a method to the example app to demonstrate this.
• iOS: Rewarded and interstitial video ads will now pause and disappear so players can complete age gate selections and reappear and resume after user input.
• iOS: Fixed issue that paused rewarded video and video interstitial playback when headphones were unplugged.
• iOS: didFailToLoadRewardedVideo delegate method now fires if rewarded video is requested before prefetching finishes.
• iOS: Fixed bug preventing loading view from displaying in a timely manner when setShouldDisplayLoadingViewForMoreApps was set to YES
• Android: Fixed bug preventing SDK from showing additional ads when setImpressionsUseActivities was enabled and previous ads were dismissed too quickly.
• Android: Resolved Chartboost Android SDK v5.1.3 bug that fired VIDEO_UNAVAILABLE error even when hasRewardedVideo returned true.
• Android: Fixed Chartboost Android SDK v5.1.3 bug that caused occasional crashes after interstitial views.
• Android: Fixed Chartboost Android SDK v5.1.1 bug that caused crashes when back button was pressed after interstitial views.
• Android: Removed all exceptions thrown from the SDK.
• Android: Fixed issue preventing /api/install calls on every bootup.
• Android: Fullscreen videos now properly extend to screen edges.

Version 5.1.4 (Mar. 17, 2015)

Features & Improvements:

• Fully compatible with Unity 5.0.
• Unity-built Android games: SDK now blocks UI clicks behind Chartboost ads.
• Fixed bug firing duplicate showInterstitial and showRewardedVideo calls in Unity-built Android games.
• Fixed bug affecting iOS Rewarded Video close buttons when videos shown on bootup.

Version 5.1.3 (Mar. 11, 2015)

Features & Improvements:

• Added a new setStatusBarBehavior method to control how fullscreen video ads interact with iOS’s status bar.
• Added the location parameter, when available, to click, show, completed-view, and other relevant network requests.
• Fixed bug causing force quitting on back press when no ad was shown.
• Fixed Android bug preventing didDismissInterstitial and didDismissRewardedVideo from firing
• Corrected debug message in CBManifestEditor.cs.
• Fixed iOS issue causing duplicate SDK calls to creative URLs.
• iOS: Max ads/hour setting is now respected when campaigns are configured to show one ad per hour and auto-caching is enabled.
• Fixed iOS bug that fired didDismissInterstitial or didDismissRewardedVideo during click events.
• Fixed iOS bug that prevented didClickInterstitial from firing on interstitial video clicks.
• Corrected iOS fullscreen video close button placement; close buttons no longer appear behind the iOS status bar.
• Resolved issue preventing didCacheInterstitial from firing when an ad was already cached at the same location.

Version 5.1.2 (Feb. 23, 2015)

Features & Improvements:

• Android: Added support for full-screen videos.
• Android: Fixed DevKit engine issue preventing rewarded video playback after device returns from sleep.
• Android: Fixed bug causing video crashes on crash exception.
• Android: Resolved issue preventing clicks from dismissing rewarded/interstitial video ads.
• Android: Corrected video download button alignment.

Version 5.1.1 (Jan. 19, 2015)

Features & Improvements:

• iOS: Added global flag to disable request retries by default (configurable in CBConfig).
• iOS: Fixed multithreaded crashes.
• iOS: Fixed silent failure when requesting assets with wrong orientation (now trackable via a CBLoadError)
• iOS: InPlay data can now be cached at multiple Named Locations.
• iOS: Added orientation information to api/click and video/complete calls to facilitate better analytics.
• iOS: Removed hardcoded affiliate token from SDK; now pulled from server.
• iOS: Added example use of isAnyViewVisible delegate method to sample project (included in SDK download package).
• iOS: Added InPlay button to Chartboost example app (included in SDK download package).

Version 5.1.0 (Dec. 10, 2014)

Features & Improvements:

• Fixed race condition between video actions on replay.
• Improved interaction between video ads and App Sheet.
• Fixed bug causing interstitial video close buttons to appear at incorrect time on portrait orientation devices.
• Fixed rare rewarded video bug causing play failures/autoplays when previous video was dismissed instead of watched.
• Resolved issues preventing api/config and api/install calls from firing on soft bootups.
• Fixed bug causing video close buttons to clip video ads in corner.
• Fixed various memory pressure, concurrency crashes.
• Fixed bug executing api/track on older devices.
• Corrected iPhone 6/6+ rotation problem causing video to display off screen.
• Corrected/updated error code enums.
• Fixed bug preventing MoreApps loading view from appearing on devices with slow connections.
• Fixed CBAnalytics crash in event of invalid NSDecimalNumber receipt.
• Fixed issue pushing age gate behind MoreApps view.
• Fixed bug allowing Unity App Sheets to rotate in single-orientation apps.
• Added armv7s architecture support.
• Fixed CBAppCall crash occurring after apps opened via deep link without resource path.
• Fixed race condition causing SKStoreProductViewController crash.
• Fixed video interstitial NullPointerException crash in Android SDK 5.0.3.
• Fixed Unity v5.0 and v5.0.2 bug preventing MoreApps pages from loading.
• Fixed bug preventing passing of custom_id callbacks parameter.
• Fixed Android video bug displaying black screen after receipt of invalid reward/get, interstitial/get responses.
• Fixed rare rewarded video bug that froze app if pre-roll popup was dismissed after player watched one video.
• Added new framework tracking values for Cordova and CocoonJS.
• Added new API to check for Chartboost UI visibility.
• Delegate callbacks for click and close now sent after impression closed or clicked.
• Delayed autocache call execution for better performance.

Version 5.0.3 (Oct. 1, 2014)

Features & Improvements:

• Bug fixes and stability improvements.

Version 5.0.2 (Sep. 12, 2014)

Features & Improvements:

• Higher eCPM for Android.
• Bug fixes and stability improvements.

Version 5.0.1 (Sep. 9, 2014)

Features & Improvements:

• Improved compatibility with various third party packages.
• Critical bug fixes and stability improvements.
• Post processing will remove legacy Chartboost files.

Version 5.0.0 (Sep. 4, 2014)

Features & Improvements:

• Chartboost Video released.
• Initialization now handled by the SDK to simplify the integration and decrease possible issues post launch.
• Easier setup and control of AppID/AppSignature pairs.
• namespace Chartboost renamed to namespace ChartboostSDK
• null or () no longer accepted as a location; you can pass in CBLocation.Default instead.
• All locations are now passed in via the CBLocation class.
• MoreApps calls now use locations public static void showMoreApps(CBLocation location)
• In app analytics, MoreApps page impressions now count toward total number of impressions.
• Chartboost SDK event names and method signatures have been significantly updated and improved.

Version 4.0.1 (Apr. 23, 2014)

Features & Improvements:

• Fixed crash due to Google Play Services security permission check.

Version 4.0.0 (Apr. 17, 2014)

Features & Improvements:

• Updated Android SDK to 4.0.0 (requires minimum Android OS version 2.3).
• Updated iOS SDK to 4.1 (requires minimum iOS version 5.1).
• Added CBImpressionError parameters to DidFailToLoad EventListener methods.
• Simplified Android plugin does not override main activity — this should eliminate conflicts with other plugins.
• Android plugin can now be initialized almost entirely in code — use the Setup dialog from the File menu and call CBBinding.init(appID, appSignature)
• Android: No longer need to use activities for Chartboost impressions.
• iOS: Removed unused iOS methods.

Version 3.4.0 (Feb. 25, 2014)

Features & Improvements:

• Updated Android SDK to v3.4.0.

Version 3.3.0 (Sep. 30, 2013)

Features & Improvements:

• Merged iOS and Android plugins: now just one almost identical API that intelligently works on both platforms.
• Repackaged all Chartboost C# classes into the namespace Chartboost
• Android: Renamed ChartBoostAndroid to CBBinding and ChartBoostAndroidManager to CBManager
• Android: Fixed issues preventing users from interacting properly with Chartboost interstitials.
• Android: Added ability to customize pause behavior while Chartboost impressions are visible.
• iOS: Renamed ChartBoostBinding to CBBinding and ChartBoostManager to CBManager
• iOS: Updated plugin to avoid possible Xcode build error with Unity 4.2.

‍