> ## Documentation Index > Fetch the complete documentation index at: https://guide.daro.so/llms.txt > Use this file to discover all available pages before exploring further. # Getting Started > Integrate the DARO iOS SDK into your app. An Ad Unit defines an ad placement and format in your app. For the DARO 2.0.1 SDK, copy the **Ad Unit Key** from the updated dashboard. This is different from the app’s Integration Key. API parameters such as `adUnitId`, `unitId`, and `key`, and example placeholders such as `YOUR_AD_UNIT_ID`, keep their names but take that Ad Unit’s Ad Unit Key. Existing integrations using Ad Unit IDs remain supported. Do not confuse reporting or callback identifiers with the key for a new integration. ## Before You Begin Check requirements before integration. ### Requirements * iOS 13.0 or higher * Xcode 26 or higher Verify [app-ads.txt setup](https://guide.daro.so/en/app-ads-txt-settings) before proceeding. *** ## Install the SDK Install the DARO 2.0.1 SDK with CocoaPods or Swift Package Manager (SPM). If your app uses the legacy SDK (before 2.0.0), follow the [iOS migration guide](/en/sdk-integration-v2/ios_new/migration-guide) first. One SDK supports all ad formats. Use `import Daro` in Swift and `DaroObjCBridge` in Objective-C. Add the dependency to your app target in the Podfile. ```ruby theme={null} target 'YourApp' do pod 'DaroAds', '2.0.1' end ``` For Objective-C, install `DaroObjCBridge` at the same version instead of `DaroAds`. Add this hook to the same Podfile. If a `post_install` block already exists, add the four lines inside that block instead of creating another one. ```ruby theme={null} post_install do |installer| hook = Dir.glob(File.expand_path('Pods/*/**/Scripts/daro_integration_key.rb', __dir__)).first raise '[Daro] INTEGRATION KEY hook not found' unless hook require hook Daro::IntegrationKey.install!(installer) end ``` Add the Integration Key issued by the dashboard to the **source `Info.plist` used by your app target**. ```xml theme={null} DaroIntegrationKey YOUR_INTEGRATION_KEY ``` Create an actual `Info.plist` file and point the app target's **Build Settings > Info.plist File (`INFOPLIST_FILE`)** to it. The hook does not support targets that only use an automatically generated Info.plist. If Debug and Release use different files, add the key to each file. Install the SDK and apply the required app settings: ```bash theme={null} pod install --repo-update ``` Run `pod install` again whenever the Integration Key changes. Resolve any hook errors before building your app. In Xcode, open **File > Add Package Dependencies…**, enter this URL, and select version `2.0.1`. ```text theme={null} https://github.com/delightroom/daro-ios-sdk.git ``` Add the `DaroAds` product for Swift or `DaroObjCBridgeAds` for Objective-C to your app target. For a `Package.swift` declaration: ```swift theme={null} dependencies: [ .package( url: "https://github.com/delightroom/daro-ios-sdk.git", exact: "2.0.1" ), ], targets: [ .target( name: "YourApp", dependencies: [ .product(name: "DaroAds", package: "daro-ios-sdk"), ] ), ] ``` SPM does not run the Integration Key configuration tool automatically. Download and extract the [matching SDK ZIP](https://github.com/delightroom/daro-ios-sdk/releases/download/v2.0.1/Daro.xcframework.zip). Use the included `Scripts/daro` tool. Add the following to the **source `Info.plist` used by your app target**. Create an actual file and point **Build Settings > Info.plist File (`INFOPLIST_FILE`)** to it. ```xml theme={null} DaroIntegrationKey YOUR_INTEGRATION_KEY ``` From the extracted directory, run this command with the path to your app's source `Info.plist`: ```bash theme={null} ./Scripts/daro platform-key --plist "/path/to/YourApp/Info.plist" --inject ``` Build the app after the command succeeds. Run it for each file if Debug and Release use different files, and run it again whenever the Integration Key changes. Do not add this command to an app build phase or run it against the built app's Info.plist. Apply the configuration to the project source before building. For both Swift and Objective-C, add `-ObjC` to the app target's **Build Settings > Other Linker Flags (`OTHER_LDFLAGS`)**. See [Other Linker Flags](#other-linker-flags). *** ## Configure Your App Complete Integration Key configuration using your installation method above. Add the following `SKAdNetworkItems` to the app's Info.plist manually. ``` SKAdNetworkItems SKAdNetworkIdentifier cstr6suwn9.skadnetwork SKAdNetworkIdentifier 4fzdc2evr5.skadnetwork SKAdNetworkIdentifier 4pfyvq9l8r.skadnetwork SKAdNetworkIdentifier 2fnua5tdw4.skadnetwork SKAdNetworkIdentifier ydx93a7ass.skadnetwork SKAdNetworkIdentifier 5a6flpkh64.skadnetwork SKAdNetworkIdentifier p78axxw29g.skadnetwork SKAdNetworkIdentifier v72qych5uu.skadnetwork SKAdNetworkIdentifier ludvb6z3bs.skadnetwork SKAdNetworkIdentifier cp8zw746q7.skadnetwork SKAdNetworkIdentifier 3sh42y64q3.skadnetwork SKAdNetworkIdentifier c6k4g5qg8m.skadnetwork SKAdNetworkIdentifier s39g8k73mm.skadnetwork SKAdNetworkIdentifier 3qy4746246.skadnetwork SKAdNetworkIdentifier f38h382jlk.skadnetwork SKAdNetworkIdentifier hs6bdukanm.skadnetwork SKAdNetworkIdentifier v4nxqhlyqp.skadnetwork SKAdNetworkIdentifier wzmmz9fp6w.skadnetwork SKAdNetworkIdentifier yclnxrl5pm.skadnetwork SKAdNetworkIdentifier t38b2kh725.skadnetwork SKAdNetworkIdentifier 7ug5zh24hu.skadnetwork SKAdNetworkIdentifier gta9lk7p23.skadnetwork SKAdNetworkIdentifier vutu7akeur.skadnetwork SKAdNetworkIdentifier y5ghdn5j9k.skadnetwork SKAdNetworkIdentifier n6fk4nfna4.skadnetwork SKAdNetworkIdentifier v9wttpbfk9.skadnetwork SKAdNetworkIdentifier n38lu8286q.skadnetwork SKAdNetworkIdentifier 47vhws6wlr.skadnetwork SKAdNetworkIdentifier kbd757ywx3.skadnetwork SKAdNetworkIdentifier 9t245vhmpl.skadnetwork SKAdNetworkIdentifier eh6m2bh4zr.skadnetwork SKAdNetworkIdentifier a2p9lx4jpn.skadnetwork SKAdNetworkIdentifier 22mmun2rn5.skadnetwork SKAdNetworkIdentifier 4468km3ulz.skadnetwork SKAdNetworkIdentifier 2u9pt9hc89.skadnetwork SKAdNetworkIdentifier 8s468mfl3y.skadnetwork SKAdNetworkIdentifier klf5c3l5u5.skadnetwork SKAdNetworkIdentifier ppxm28t8ap.skadnetwork SKAdNetworkIdentifier ecpz2srf59.skadnetwork SKAdNetworkIdentifier uw77j35x4d.skadnetwork SKAdNetworkIdentifier pwa73g5rt2.skadnetwork SKAdNetworkIdentifier mlmmfzh3r3.skadnetwork SKAdNetworkIdentifier 578prtvx9j.skadnetwork SKAdNetworkIdentifier 4dzt52r2t5.skadnetwork SKAdNetworkIdentifier e5fvkxwrpn.skadnetwork SKAdNetworkIdentifier 8c4e2ghe7u.skadnetwork SKAdNetworkIdentifier zq492l623r.skadnetwork SKAdNetworkIdentifier 3rd42ekr43.skadnetwork SKAdNetworkIdentifier 3qcr597p9d.skadnetwork SKAdNetworkIdentifier mj797d8u6f.skadnetwork SKAdNetworkIdentifier 55644vm79v.skadnetwork SKAdNetworkIdentifier 6yxyv74ff7.skadnetwork SKAdNetworkIdentifier 55y65gfgn7.skadnetwork SKAdNetworkIdentifier cwn433xbcr.skadnetwork SKAdNetworkIdentifier nu4557a4je.skadnetwork SKAdNetworkIdentifier w7jznl3r6g.skadnetwork SKAdNetworkIdentifier 577p5t736z.skadnetwork SKAdNetworkIdentifier 6rd35atwn8.skadnetwork SKAdNetworkIdentifier 7bxrt786m8.skadnetwork SKAdNetworkIdentifier 7fbxrn65az.skadnetwork SKAdNetworkIdentifier dt3cjx1a9i.skadnetwork SKAdNetworkIdentifier fz2k2k5tej.skadnetwork SKAdNetworkIdentifier jk2fsx2rgz.skadnetwork SKAdNetworkIdentifier r8lj5b58b5.skadnetwork SKAdNetworkIdentifier tmhh9296z4.skadnetwork SKAdNetworkIdentifier k6y4y55b64.skadnetwork SKAdNetworkIdentifier qwpu75vrh2.skadnetwork SKAdNetworkIdentifier 252b5q8x7y.skadnetwork SKAdNetworkIdentifier 4mn522wn87.skadnetwork SKAdNetworkIdentifier 7fmhfwg9en.skadnetwork SKAdNetworkIdentifier 8r8llnkz5a.skadnetwork SKAdNetworkIdentifier dbu4b84rxf.skadnetwork SKAdNetworkIdentifier dkc879ngq3.skadnetwork SKAdNetworkIdentifier f7s53z58qe.skadnetwork SKAdNetworkIdentifier g6gcrrvk4p.skadnetwork SKAdNetworkIdentifier gta8lk7p23.skadnetwork SKAdNetworkIdentifier krvm3zuq6h.skadnetwork SKAdNetworkIdentifier lr83yxwka7.skadnetwork SKAdNetworkIdentifier qu637u8glc.skadnetwork SKAdNetworkIdentifier s69wq72ugq.skadnetwork SKAdNetworkIdentifier v79kvwwj4g.skadnetwork SKAdNetworkIdentifier vhf287vqwu.skadnetwork SKAdNetworkIdentifier x5l83yy675.skadnetwork SKAdNetworkIdentifier x8jxxk4ff5.skadnetwork SKAdNetworkIdentifier x8uqf25wch.skadnetwork SKAdNetworkIdentifier xga6mpmplv.skadnetwork SKAdNetworkIdentifier ln5gz23vtd.skadnetwork SKAdNetworkIdentifier z959bm4gru.skadnetwork SKAdNetworkIdentifier 238da6jt44.skadnetwork SKAdNetworkIdentifier 24t9a8vw3c.skadnetwork SKAdNetworkIdentifier 24zw6aqk47.skadnetwork SKAdNetworkIdentifier 275upjj5gd.skadnetwork SKAdNetworkIdentifier 294l99pt4k.skadnetwork SKAdNetworkIdentifier 32z4fx6l9h.skadnetwork SKAdNetworkIdentifier 3l6bd9hu43.skadnetwork SKAdNetworkIdentifier 424m5254lk.skadnetwork SKAdNetworkIdentifier 44jx6755aq.skadnetwork SKAdNetworkIdentifier 44n7hlldy6.skadnetwork SKAdNetworkIdentifier 488r3q3dtq.skadnetwork SKAdNetworkIdentifier 4w7y6s5ca2.skadnetwork SKAdNetworkIdentifier 523jb4fst2.skadnetwork SKAdNetworkIdentifier 52fl2v3hgk.skadnetwork SKAdNetworkIdentifier 54nzkqm89y.skadnetwork SKAdNetworkIdentifier 5f5u5tfb26.skadnetwork SKAdNetworkIdentifier 5l3tpt7t6e.skadnetwork SKAdNetworkIdentifier 5lm9lj6jb7.skadnetwork SKAdNetworkIdentifier 5tjdwbrq8w.skadnetwork SKAdNetworkIdentifier 6964rsfnh4.skadnetwork SKAdNetworkIdentifier 6g9af3uyq4.skadnetwork SKAdNetworkIdentifier 6p4ks3rnbw.skadnetwork SKAdNetworkIdentifier 6v7lgmsu45.skadnetwork SKAdNetworkIdentifier 6xzpu9s2p8.skadnetwork SKAdNetworkIdentifier 737z793b9f.skadnetwork SKAdNetworkIdentifier 74b6s63p6l.skadnetwork SKAdNetworkIdentifier 77y3x8wds4.skadnetwork SKAdNetworkIdentifier 7953jerfzd.skadnetwork SKAdNetworkIdentifier 79pbpufp6p.skadnetwork SKAdNetworkIdentifier 7rz58n8ntl.skadnetwork SKAdNetworkIdentifier 84993kbrcf.skadnetwork SKAdNetworkIdentifier 87u5trcl3r.skadnetwork SKAdNetworkIdentifier 89z7zv988g.skadnetwork SKAdNetworkIdentifier 8m87ys6875.skadnetwork SKAdNetworkIdentifier 97r2b46745.skadnetwork SKAdNetworkIdentifier 9b89h5y424.skadnetwork SKAdNetworkIdentifier 9g2aggbj52.skadnetwork SKAdNetworkIdentifier 9nlqeag3gk.skadnetwork SKAdNetworkIdentifier 9rd848q2bz.skadnetwork SKAdNetworkIdentifier 9vvzujtq5s.skadnetwork SKAdNetworkIdentifier 9yg77x724h.skadnetwork SKAdNetworkIdentifier a7xqa6mtl2.skadnetwork SKAdNetworkIdentifier a8cz6cu7e5.skadnetwork SKAdNetworkIdentifier apzhy3va96.skadnetwork SKAdNetworkIdentifier av6w8kgt66.skadnetwork SKAdNetworkIdentifier b9bk5wbcq9.skadnetwork SKAdNetworkIdentifier bvpn9ufa9b.skadnetwork SKAdNetworkIdentifier bxvub5ada5.skadnetwork SKAdNetworkIdentifier c3frkrj4fj.skadnetwork SKAdNetworkIdentifier ce8ybjwass.skadnetwork SKAdNetworkIdentifier cg4yq2srnc.skadnetwork SKAdNetworkIdentifier cj5566h2ga.skadnetwork SKAdNetworkIdentifier cs644xg564.skadnetwork SKAdNetworkIdentifier dzg6xy7pwj.skadnetwork SKAdNetworkIdentifier ejvt5qm6ak.skadnetwork SKAdNetworkIdentifier f2zub97jtl.skadnetwork SKAdNetworkIdentifier f73kdq92p3.skadnetwork SKAdNetworkIdentifier feyaarzu9v.skadnetwork SKAdNetworkIdentifier fq6vru337s.skadnetwork SKAdNetworkIdentifier g28c52eehv.skadnetwork SKAdNetworkIdentifier g2y4y55b64.skadnetwork SKAdNetworkIdentifier ggvn48r87g.skadnetwork SKAdNetworkIdentifier glqzh8vgby.skadnetwork SKAdNetworkIdentifier gvmwg8q7h5.skadnetwork SKAdNetworkIdentifier h65wbv5k3f.skadnetwork SKAdNetworkIdentifier hb56zgv37p.skadnetwork SKAdNetworkIdentifier hdw39hrw9y.skadnetwork SKAdNetworkIdentifier hjevpa356n.skadnetwork SKAdNetworkIdentifier k674qkevps.skadnetwork SKAdNetworkIdentifier kbmxgpxpgc.skadnetwork SKAdNetworkIdentifier m297p6643m.skadnetwork SKAdNetworkIdentifier m5mvw97r93.skadnetwork SKAdNetworkIdentifier m8dbw4sv7c.skadnetwork SKAdNetworkIdentifier mls7yz5dvl.skadnetwork SKAdNetworkIdentifier mp6xlyr22a.skadnetwork SKAdNetworkIdentifier mqn7fxpca7.skadnetwork SKAdNetworkIdentifier mtkv5xtk9e.skadnetwork SKAdNetworkIdentifier n66cz3y3bx.skadnetwork SKAdNetworkIdentifier n9x2a789qt.skadnetwork SKAdNetworkIdentifier ns5j362hk7.skadnetwork SKAdNetworkIdentifier nzq8sh4pbs.skadnetwork SKAdNetworkIdentifier p4ybsjem3u.skadnetwork SKAdNetworkIdentifier prcb7njmu6.skadnetwork SKAdNetworkIdentifier pu4na253f3.skadnetwork SKAdNetworkIdentifier pwdxu55a5a.skadnetwork SKAdNetworkIdentifier qqp299437r.skadnetwork SKAdNetworkIdentifier r45fhb6rf7.skadnetwork SKAdNetworkIdentifier rvh3l7un93.skadnetwork SKAdNetworkIdentifier rx5hdcabgc.skadnetwork SKAdNetworkIdentifier sczv5946wb.skadnetwork SKAdNetworkIdentifier su67r6k2v3.skadnetwork SKAdNetworkIdentifier t6d3zquu66.skadnetwork SKAdNetworkIdentifier tl55sbb4fm.skadnetwork SKAdNetworkIdentifier tvvz7th9br.skadnetwork SKAdNetworkIdentifier u679fj5vs4.skadnetwork SKAdNetworkIdentifier vcra2ehyfk.skadnetwork SKAdNetworkIdentifier w9q455wk68.skadnetwork SKAdNetworkIdentifier wg4vff78zm.skadnetwork SKAdNetworkIdentifier x2jnk7ly8j.skadnetwork SKAdNetworkIdentifier x44k69ngh6.skadnetwork SKAdNetworkIdentifier x8yj322td6.skadnetwork SKAdNetworkIdentifier xy9t38ct57.skadnetwork SKAdNetworkIdentifier y45688jllp.skadnetwork SKAdNetworkIdentifier yrqqpx2mcb.skadnetwork SKAdNetworkIdentifier z24wtl6j62.skadnetwork SKAdNetworkIdentifier z4gj7hsk7h.skadnetwork SKAdNetworkIdentifier zmvfpc5aq8.skadnetwork ``` Copy `SKAdNetworkItems` from Info.plist to your app's Info.plist. Required for ad demand sources to receive conversion performance reports. Significantly affects ad performance. ### Other Linker Flags **When `-ObjC` is required** You **must** add `-ObjC` to your app target's **Build Settings > Other Linker Flags (`OTHER_LDFLAGS`)** if any of the following applies: * Objective-C project * Swift project integrating `DaroAds` or `DaroObjCBridgeAds` via Swift Package Manager (required so ad demand adapters are detected at runtime) Without this flag, the SDK may not work correctly or some ad demand sources will fail to load. Follow these steps in Xcode project settings: 1. Select your project file in Xcode 2. Select the **Build Settings** tab 3. Search for "Other Linker Flags" 4. Add `-ObjC` to **Other Linker Flags** *** ## Initialize SDK **Important: Load Ads After Initialization** Load all ads after SDK initialization completes. Requesting ads before initialization may prevent proper display. Add to your app's `AppDelegate` file: ```swift theme={null} import Daro func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool { // Start SDK DaroAds.shared.initialized { error in if let error { print("Daro SDK initialization error : \(error)") } else { print("Daro SDK initialized successfully") } } // (Optional) Set user ID DaroAds.shared.userId = "user_id" // (Optional) Set log level DaroAds.shared.logLevel = .debug // .off, .error, .debug return true } ``` ```objc theme={null} #import #import - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // (Optional) Set user ID - recommended before SDK initialization [DaroObjCAds shared].userId = @"user_id"; // (Optional) Set log level - recommended before SDK initialization [DaroObjCAds shared].logLevel = DaroObjCLogLevelDebug; // Off, Error, Debug // Start SDK [[DaroObjCAds shared] initializeWithCompletion:^(NSError * _Nullable error) { if (error) { NSLog(@"Daro SDK initialized error: %@", error); } else { NSLog(@"Daro SDK initialized successfully"); } }]; return YES; } ``` ### Preventing currentWindow Crashes **currentWindow-Related Crashes in Some Ad SDKs** Some ad SDKs may throw `unrecognized selector sent to instance` exceptions when accessing `UIApplication.shared.delegate.window`. This occurs when the AppDelegate doesn't have a window property defined in SceneDelegate or SwiftUI environments. Add the following variable to your AppDelegate to prevent this issue: ```swift theme={null} @main class AppDelegate: UIResponder, UIApplicationDelegate { var window: UIWindow? // ... rest of your code } ``` ```objc theme={null} @interface AppDelegate : UIResponder @property (nonatomic, strong) UIWindow *window; @end ``` ### Log Level DARO SDK supports the following log levels: * `.off` / `Off`: No log output * `.error` / `Error`: Only error logs * `.debug` / `Debug`: All log output (recommended during development) ```swift theme={null} DaroAds.shared.logLevel = .debug ``` ```objc theme={null} [DaroObjCAds shared].logLevel = DaroObjCLogLevelDebug; ``` ### Set User ID Set `userId` property if your app requires user identification. Value sends with all ad requests. ```swift theme={null} DaroAds.shared.userId = "user_id" ``` ```objc theme={null} [DaroObjCAds shared].userId = @"user_id"; ``` ### App Mute Setting For app open, banner, interstitial, rewarded, and native ad formats, you can use the `setAppMuted` method to inform the DARO SDK that the app volume has been muted. ```swift theme={null} // Mute app DaroAds.shared.setAppMuted(true) // Unmute app DaroAds.shared.setAppMuted(false) ``` ```objc theme={null} // Mute app [[DaroObjCAds shared] setAppMuted:YES]; // Unmute app [[DaroObjCAds shared] setAppMuted:NO]; ``` Native ads apply the mute state to video playback at load time. Call `setAppMuted` before loading native ads. **App Mute Usage Precautions** When app mute is enabled, some video ad creatives that cannot play while muted may be excluded from ad requests, which can slightly reduce the ad pool and affect revenue. *** ## Precautions **Location-Based Background Updates** Apps using location-based background updates that display ads on first screen must implement additional handling to load and display ads when app becomes active. See: [Handling Location Updates in the Background](https://developer.apple.com/documentation/corelocation/handling-location-updates-in-the-background)