# Get Started on iOS ## Before You Begin 1. [Create and set up your Chartboost account](/en/monetization/get-started/). 2. Download and review the [Chartboost Sample App](https://github.com/ChartBoost/ios-sdk-example)

Note: Due to Apple's sound architecture, managing audio when displaying ads that reproduce sound via WKWebView or AVPlayer can result in audio overlap. Since iOS perceives the application and the SDK as the same audio source, simultaneous playback of the ad's audio track and the application's can occur.

Therefore, we recommend that developers implement the necessary logic to pause the application's audio playback before the ad starts and resume it once it has concluded. This handling allows for a more fluid and coherent user experience.

## Minimum Supported Development Tools | Software | Version | | -------- | ------- | | Minimum Supported iOS Version | 11.0 | | Minimum Xcode Version | 16.0 | | Swift | 5.5+ | ## Import the Chartboost Framework The `ChartboostSDK.xcframework` needs to be imported into your Xcode project. This can be done via Swift Package Manager, CocoaPods, or manually. ### Swift Package Manager The Chartboost Monetization SDK is distributed as a binary framework via [Swift Package Manager](https://www.swift.org/documentation/package-manager/). **Using Xcode:** 1. In Xcode, select **File > Add Package Dependencies…**. 2. Enter the package repository URL: `https://github.com/ChartBoost/chartboost-monetization-ios-sdk` 3. Add the `ChartboostSDK` library product to your app target. **Using a `Package.swift` manifest:** Add the package to your `dependencies`, then add the `ChartboostSDK` product to the target that uses it: ```swift dependencies: [ .package(url: "https://github.com/ChartBoost/chartboost-monetization-ios-sdk", from: "9.13.0"), ], targets: [ .target( name: "YourTarget", dependencies: [ .product(name: "ChartboostSDK", package: "chartboost-monetization-ios-sdk"), ] ), ], ```

Note: The -ObjC linker flag is required (see Setting Up Chartboost SDK, step 1, below). When integrating with Swift Package Manager it must be added to your app target's Other Linker Flags manually.

### CocoaPods 1. Download and install [CocoaPods](https://guides.cocoapods.org/using/getting-started.html). 2. Open your project’s **Podfile** and add the line `pod 'ChartboostSDK'`. 3. Run `pod install --repo-update` from the command line. For more information on using CocoaPods, refer to [CocoaPods’ documentation](https://guides.cocoapods.org/using/using-cocoapods). ### Manual Import 1. Download the [iOS Chartboost SDK](https://s3.amazonaws.com/chartboost/sdk/9.13.0/Chartboost-iOS-9.13.0.zip). 2. Unzip the file. Then drag and drop the `ChartboostSDK.xcframework` folder into your Xcode project. 3. Mark it as **Do Not Embed**. 4. Drop the `ChartboostSDKResources.bundle` file and add it into the **Build Phases > Copy Bundle Resources** section. 5. If your project is pure Objective-C, you can add a Swift file or add the following settings to import the swift libraries. 1. **Add Build Settings** > **Search Paths** >** Library search paths** `$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME) $(SDKROOT)/usr/lib/swift` 2. **Add Build Settings** > **Linking** > **Runpath search paths**` /usr/lib/swift` If your project is targeting an iOS version 12.4 or earlier, set **Build Settings** > **Always Embed Swift Standard Libraries** to **YES**.

Pro Tip: Checkmark the Copy items if needed option to create a local copy of the framework for your project. This will help keep your project organized.

## Setting Up Chartboost SDK #### 1. Add value `-ObjC` in **Other Linker Flags** under your project’s **Build Settings** for both **Debug** and **Release**. #### 2. 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`. - This is a new required step for iOS 14 integrations. See [iOS 14 Preparation](/en/monetization/integrate/ios/upgrading-the-sdk/) to learn more. - The full list of Chartboost required `SKAdNetwork` IDs can be found here in [XML](https://a3.chartboost.com/skadnetworkids.xml) and [JSON](https://a3.chartboost.com/skadnetworkids.json) formats. - We recommend enabling warning-level logs in order to have our most up-to-date `SKAdNetwork ID` list. ```xml SKAdNetworkItems SKAdNetworkIdentifier f38h382jlk.skadnetwork ``` #### 3. Add the following import header to your `AppDelegate.m` file:

```
import ChartboostSDK
```
```
#import <ChartboostSDK/Chartboost.h>
```

#### 4. Initialize Chartboost in your `didFinishLaunchingWithOptions` method. - `start(withAppID:appSignature:completion:)` must always be called on bootup, regardless of any other actions your app takes. - 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 by the Terms of Service to obtain consent from their users before Chartboost can process any personal data and pass it to the Chartboost SDK via the above method. This method should be called before `start(withAppID:appSignature:completion:)` if possible. Review our [privacy methods](/en/monetization/integrate/ios/sdk-privacy-methods/) and [behavioral targeting](/en/faq/coppa/) documentation for more information.

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        Chartboost.start(withAppID: "YOUR_CHARTBOOST_APP_ID",
                         appSignature: "YOUR_CHARTBOOST_APP_SIGNATURE") { error in
                            let vc = self.window?.rootViewController as? ViewController
                            vc?.log(message: error == nil ? "Chartboost initialized successfully!" : "Chartboost failed to initialize.")
        }
        return true
    }

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
// Initialize the Chartboost library    
    [Chartboost startWithAppID:@"YOUR_CHARTBOOST_APP_ID"
        appSignature:@"YOUR_CHARTBOOST_APP_SIGNATURE"
        completion:^(CHBStartError * _Nullable error) {
        if (error) { 
            NSLog(@"Chartboost SDK initialization finished with error %@", error); 
        } else { 
            NSLog(@"Chartboost SDK initialization finished with success"); 
        } 
        }]; 
    return YES; 
}

#### 5. Add your app ID and app signature. - Replace `YOUR_CHARTBOOST_APP_ID` and `YOUR_CHARTBOOST_APP_SIGNATURE` with your app ID and app signature - 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** #### 6. (If applicable) Add Google EDM dependencies for Unity To ensure iOS resources are embedded correctly on SDK versions prior to 9.11.0, Apps built on Unity should add the Chartboost Monetization iOS SDK to all targets in their Google EDM dependencies for their Unity plugin using the following snippet: ``. ## To Show a Static or Video Interstitial Ad 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]`;:

```
    interstitial.show(from: self)
```

    [interstitial showFromViewController:self]; 

## To Show a Rewarded Video Ad 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]`:

```
    rewarded.show(from: self)
```

    [rewarded showFromViewController:self]; 

## To Show a Banner Ad Banner ads need to be cached before being displayed. Use the following method to cache a banner ad:

```
banner.cache()
```
```
[banner cache]; 
```

Then, use the following method to show a banner ad:

```
banner.show(from: self)
```
```
[banner showFromViewController:self];
```

## Testing Your SDK Integration 1. Build and run your project from Xcode on a device or Simulator. 2. Use [Test Mode](/en/monetization/charles-web-proxy/) to see if test ads show up. ## SDK Configuration Methods These methods will allow you to access Chartboost SDK functionality and settings. ``` // Control how much information is logged in the console + (void)setLoggingLevel:(CBLoggingLevel)loggingLevel; ```