Last Updated on
July 15, 2022
The Chartboost SDK runs only on devices with iOS version 10.0 or higher, iPhone 5 or later, iPod 6th generation or later, and iPad 4th generation or later.
startWithAppId must always be called during hard and soft bootups within the first few seconds of your app launching, regardless of any other actions or user interaction within your app.
Publishers should call the addDataUseConsent API from the Chartboost SDK and pass in the appropriate consent value for GDPR and CCPA. Publishers are required as part of Terms of Service to obtain the consent from their users before Chartboost will process any personal data and pass it to the Chartboost SDK via the above method. This method should be called before startWithAppId if possible.
Learn more about privacy methods here and Behavioral Targeting here.
The easiest way to download and link the Chartboost SDK to your project is to use CocoaPods. You just need to open your project’s Podfile and add this line:
pod 'ChartboostSDK'
Then run this from the command line:
pod install --repo-update
Make sure to check CocoaPods’ documentation if you are new to it. If you choose this option you should skip to step 4.
Download and drop ChartboostSDK.xcframework into your Xcode project. Mark it as Do Not Embed. If your project is pure Objective-C, you can add a Swift file or add the following settings to import the swift libraries.
If your project is targeting an iOS version earlier than 12.4, set Build Settings > Always Embed Swift Standard Libraries to YES. PRO TIP: Checkmark the Copy items if needed option. This creates a local copy of the framework for your project, which keeps your project organized.
This is a new required step for iOS 14 integrations.
Add a new dictionary with Chartboost’s SKAdNetworkIdentifier value f38h382jlk.skadnetwork as well as additional identifiers of other Chartboost Demand Partners to the SKAdNetworkItems array in your Info.plist.
The full list of Chartboost required SKAdNetwork IDs can be found here in XML and JSON formats.
PRO TIP: We recommend enabling warning level logs in order to have our most up-to-date SKAdNetwork ID list.
See our iOS 14 Preparation page to learn more.
startWithAppId must always be called during hard and soft bootups within the first few seconds of your app launching, regardless of any other actions or user interaction within your app.
Publishers should call the addDataUseConsent API from the Chartboost SDK and pass in the appropriate value for whether consent exists, does not exist, or is unknown. Publishers are required as part of Terms of Service to obtain the consent from their users before Chartboost will process any personal data and pass it to the Chartboost SDK via the above method. This method should be called before startWithAppId if possible.
Chartboost App ID is a unique App identifier in our systems, therefore it is required to use a different Chartboost App ID per each app.
Interstitial ads need to be cached before being displayed. Use the method [interstitial cache]; to cache an interstitial ad.
Once the interstitial ad is cached you can display it using the method [interstitial showFromViewController:self];.
To make the interstitial ad show, first create it (detailed here) then call the ad method.
Learn more about iOS Chartboost delegate methods here.
Rewarded ads need to be cached before being displayed. Use the method [rewarded cache]; to cache a rewarded ad.
Once the rewarded ad is cached you can display it using the method [rewarded showFromViewController:self];.
To make the rewarded ad show, first create it (detailed here) then call the ad method.
Learn more about iOS Chartboost delegate methods here.
Banner ads need to be cached before being displayed. Use the method [banner cache]; to cache a banner ad.
To make the banner ad show, first create it (detailed here), and then call the ad method.
w00t! You just integrated the Chartboost SDK into your app!
Now you can start a campaign
Last Updated on July 12, 2022