> ## Documentation Index > Fetch the complete documentation index at: https://docs.adrop.io/llms.txt > Use this file to discover all available pages before exploring further. # Getting Started > Guide to integrating Adrop SDK into your iOS project. ## Overview Use the Adrop iOS SDK to display various ad formats in your app. ### Supported Ad Formats | Format | Description | | ---------------- | ---------------------------------------------------- | | **Banner** | Rectangular ads displayed in a portion of the screen | | **Native** | Ads that can be customized to match your app UI | | **Interstitial** | Full-screen ads that cover the entire screen | | **Rewarded** | Video ads that provide rewards upon completion | | **Popup** | Ads displayed as popups at specific moments | | **Splash** | Ads displayed with your logo when the app starts | ### Requirements * iOS 13.0 or higher * Xcode 14.1 or higher * Swift 5.0 or higher *** ## Prerequisites ### 1. Add adrop\_service.json File Download the `adrop_service.json` file from [Ad Control Console](https://console.adrop.io) > **Admin** > **App**. Add the downloaded file to your Xcode project root. When adding the file, ensure that **all targets are selected**. The SDK will not function properly without the `adrop_service.json` file. ### 2. Check Unit ID Check the unit ID for your ad placement in the **Ad Unit** tab of the console. *** ## Installation ### Swift Package Manager (Recommended) 1. In Xcode, select **File > Add Package Dependencies...** 2. Enter the package URL: ``` https://github.com/OpenRhapsody/adrop-ads-pod ``` 3. Click **Add Package** To use backfill ads, add an additional package: ``` https://github.com/OpenRhapsody/adrop-ads-backfill-pod ``` ### CocoaPods 1. Create Podfile if it doesn't exist: ```bash theme={null} pod init ``` 2. Add to Podfile: ```ruby title="Podfile" theme={null} pod 'AdropAds' pod 'AdropAdsBackfill' ``` 3. Install: ```bash theme={null} pod install --repo-update ``` 4. Open the project with `.xcworkspace` file ### Info.plist Configuration Add the following settings to `Info.plist` for backfill ads: * **GADApplicationIdentifier**: App ID for backfill ads * **SKAdNetworkItems**: Required for ad conversion tracking on iOS 14+ ```xml Info.plist theme={null} GADApplicationIdentifier ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy 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 v9wttpbfk9.skadnetwork SKAdNetworkIdentifier lr83yxwka7.skadnetwork SKAdNetworkIdentifier 578prtvx9j.skadnetwork SKAdNetworkIdentifier 7ug5zh24hu.skadnetwork SKAdNetworkIdentifier wg4vff78zm.skadnetwork SKAdNetworkIdentifier mj797d8u6f.skadnetwork SKAdNetworkIdentifier 8s468mfl3y.skadnetwork SKAdNetworkIdentifier 4dzt52r2t5.skadnetwork SKAdNetworkIdentifier vhf287vqwu.skadnetwork SKAdNetworkIdentifier c6k4g5qg8m.skadnetwork SKAdNetworkIdentifier 5tjdwbrq8w.skadnetwork SKAdNetworkIdentifier 294l99pt4k.skadnetwork SKAdNetworkIdentifier mqn7fxpca7.skadnetwork SKAdNetworkIdentifier g6gcrrvk4p.skadnetwork SKAdNetworkIdentifier tl55sbb4fm.skadnetwork SKAdNetworkIdentifier s39g8k73mm.skadnetwork SKAdNetworkIdentifier a2p9lx4jpn.skadnetwork SKAdNetworkIdentifier k6y4y55b64.skadnetwork SKAdNetworkIdentifier 488r3q3dtq.skadnetwork SKAdNetworkIdentifier 9rd848q2bz.skadnetwork SKAdNetworkIdentifier glqzh8vgby.skadnetwork SKAdNetworkIdentifier 5lm9lj6jb7.skadnetwork SKAdNetworkIdentifier 97r2b46745.skadnetwork SKAdNetworkIdentifier zmvfpc5aq8.skadnetwork SKAdNetworkIdentifier 3sh42y64q3.skadnetwork SKAdNetworkIdentifier mlmmfzh3r3.skadnetwork SKAdNetworkIdentifier 3rd42ekr43.skadnetwork SKAdNetworkIdentifier 2u9pt9hc89.skadnetwork SKAdNetworkIdentifier m8dbw4sv7c.skadnetwork SKAdNetworkIdentifier 238da6jt44.skadnetwork SKAdNetworkIdentifier 4468km3ulz.skadnetwork SKAdNetworkIdentifier 4w7y6s5ca2.skadnetwork SKAdNetworkIdentifier a8cz6cu7e5.skadnetwork SKAdNetworkIdentifier 77y3x8wds4.skadnetwork SKAdNetworkIdentifier n9x2a789qt.skadnetwork SKAdNetworkIdentifier hs6bdukanm.skadnetwork SKAdNetworkIdentifier f7s53z58qe.skadnetwork SKAdNetworkIdentifier 9t245vhmpl.skadnetwork SKAdNetworkIdentifier mp6xlyr22a.skadnetwork SKAdNetworkIdentifier prcb7njmu6.skadnetwork SKAdNetworkIdentifier kbd757ywx3.skadnetwork SKAdNetworkIdentifier k674qkevps.skadnetwork SKAdNetworkIdentifier t38b2kh725.skadnetwork SKAdNetworkIdentifier feyaarzu9v.skadnetwork SKAdNetworkIdentifier 5f5u5tfb26.skadnetwork SKAdNetworkIdentifier 424m5254lk.skadnetwork SKAdNetworkIdentifier e5fvkxwrpn.skadnetwork SKAdNetworkIdentifier 3qy4746246.skadnetwork SKAdNetworkIdentifier klf5c3l5u5.skadnetwork SKAdNetworkIdentifier zq492l623r.skadnetwork SKAdNetworkIdentifier 22mmun2rn5.skadnetwork SKAdNetworkIdentifier av6w8kgt66.skadnetwork SKAdNetworkIdentifier v79kvwwj4g.skadnetwork SKAdNetworkIdentifier 44jx6755aq.skadnetwork SKAdNetworkIdentifier 32z4fx6l9h.skadnetwork SKAdNetworkIdentifier w9q455wk68.skadnetwork SKAdNetworkIdentifier xga6mpmplv.skadnetwork SKAdNetworkIdentifier f38h382jlk.skadnetwork SKAdNetworkIdentifier yclnxrl5pm.skadnetwork SKAdNetworkIdentifier x44k69ngh6.skadnetwork SKAdNetworkIdentifier ppxm28t8ap.skadnetwork SKAdNetworkIdentifier f73kdq92p3.skadnetwork SKAdNetworkIdentifier 5l3tpt7t6e.skadnetwork SKAdNetworkIdentifier wzmmz9fp6w.skadnetwork SKAdNetworkIdentifier pwa73g5rt2.skadnetwork SKAdNetworkIdentifier 9nlqeag3gk.skadnetwork SKAdNetworkIdentifier 6yxyv74ff7.skadnetwork SKAdNetworkIdentifier uw77j35x4d.skadnetwork SKAdNetworkIdentifier 54nzkqm89y.skadnetwork SKAdNetworkIdentifier 44n7hlldy6.skadnetwork SKAdNetworkIdentifier 6964rsfnh4.skadnetwork SKAdNetworkIdentifier 6g9af3uyq4.skadnetwork SKAdNetworkIdentifier 6v7lgmsu45.skadnetwork SKAdNetworkIdentifier 7fmhfwg9en.skadnetwork SKAdNetworkIdentifier a7xqa6mtl2.skadnetwork SKAdNetworkIdentifier 84993kbrcf.skadnetwork SKAdNetworkIdentifier bxvub5ada5.skadnetwork SKAdNetworkIdentifier 79pbpufp6p.skadnetwork SKAdNetworkIdentifier 9vvzujtq5s.skadnetwork SKAdNetworkIdentifier 7rz58n8ntl.skadnetwork SKAdNetworkIdentifier 3qcr597p9d.skadnetwork SKAdNetworkIdentifier 737z793b9f.skadnetwork SKAdNetworkIdentifier 89z7zv988g.skadnetwork SKAdNetworkIdentifier c3frkrj4fj.skadnetwork SKAdNetworkIdentifier 275upjj5gd.skadnetwork SKAdNetworkIdentifier 3l6bd9hu43.skadnetwork SKAdNetworkIdentifier 52fl2v3hgk.skadnetwork SKAdNetworkIdentifier 6p4ks3rnbw.skadnetwork SKAdNetworkIdentifier apzhy3va96.skadnetwork SKAdNetworkIdentifier 9b89h5y424.skadnetwork SKAdNetworkIdentifier 523jb4fst2.skadnetwork SKAdNetworkIdentifier b9bk5wbcq9.skadnetwork SKAdNetworkIdentifier cg4yq2srnc.skadnetwork SKAdNetworkIdentifier cj5566h2ga.skadnetwork SKAdNetworkIdentifier 24zw6aqk47.skadnetwork SKAdNetworkIdentifier 74b6s63p6l.skadnetwork SKAdNetworkIdentifier 8m87ys6875.skadnetwork SKAdNetworkIdentifier 24t9a8vw3c.skadnetwork SKAdNetworkIdentifier 6xzpu9s2p8.skadnetwork SKAdNetworkIdentifier cs644xg564.skadnetwork SKAdNetworkIdentifier dbu4b84rxf.skadnetwork SKAdNetworkIdentifier ejvt5qm6ak.skadnetwork SKAdNetworkIdentifier mtkv5xtk9e.skadnetwork SKAdNetworkIdentifier kbmxgpxpgc.skadnetwork SKAdNetworkIdentifier hb56zgv37p.skadnetwork SKAdNetworkIdentifier pwdxu55a5a.skadnetwork SKAdNetworkIdentifier r45fhb6rf7.skadnetwork SKAdNetworkIdentifier t6d3zquu66.skadnetwork SKAdNetworkIdentifier u679fj5vs4.skadnetwork SKAdNetworkIdentifier dzg6xy7pwj.skadnetwork SKAdNetworkIdentifier g28c52eehv.skadnetwork SKAdNetworkIdentifier mls7yz5dvl.skadnetwork SKAdNetworkIdentifier vcra2ehyfk.skadnetwork SKAdNetworkIdentifier rx5hdcabgc.skadnetwork SKAdNetworkIdentifier qwpu75vrh2.skadnetwork SKAdNetworkIdentifier rvh3l7un93.skadnetwork SKAdNetworkIdentifier x5l83yy675.skadnetwork SKAdNetworkIdentifier m5mvw97r93.skadnetwork SKAdNetworkIdentifier xy9t38ct57.skadnetwork SKAdNetworkIdentifier g2y4y55b64.skadnetwork SKAdNetworkIdentifier gta9lk7p23.skadnetwork SKAdNetworkIdentifier n6fk4nfna4.skadnetwork SKAdNetworkIdentifier qu637u8glc.skadnetwork SKAdNetworkIdentifier y5ghdn5j9k.skadnetwork SKAdNetworkIdentifier y45688jllp.skadnetwork SKAdNetworkIdentifier ggvn48r87g.skadnetwork SKAdNetworkIdentifier m297p6643m.skadnetwork SKAdNetworkIdentifier qqp299437r.skadnetwork SKAdNetworkIdentifier hdw39hrw9y.skadnetwork SKAdNetworkIdentifier krvm3zuq6h.skadnetwork SKAdNetworkIdentifier cwn433xbcr.skadnetwork SKAdNetworkIdentifier ns5j362hk7.skadnetwork SKAdNetworkIdentifier su67r6k2v3.skadnetwork SKAdNetworkIdentifier z959bm4gru.skadnetwork SKAdNetworkIdentifier x8uqf25wch.skadnetwork SKAdNetworkIdentifier n38lu8286q.skadnetwork SKAdNetworkIdentifier fz2k2k5tej.skadnetwork SKAdNetworkIdentifier ecpz2srf59.skadnetwork SKAdNetworkIdentifier bvpn9ufa9b.skadnetwork SKAdNetworkIdentifier 6rd35atwn8.skadnetwork SKAdNetworkIdentifier ln5gz23vtd.skadnetwork SKAdNetworkIdentifier tmhh9296z4.skadnetwork SKAdNetworkIdentifier sczv5946wb.skadnetwork SKAdNetworkIdentifier dkc879ngq3.skadnetwork SKAdNetworkIdentifier 87u5trcl3r.skadnetwork SKAdNetworkIdentifier fq6vru337s.skadnetwork SKAdNetworkIdentifier f2zub97jtl.skadnetwork SKAdNetworkIdentifier thzdn4h5nc.adattributionkit SKAdNetworkIdentifier raa6f494kr.adattributionkit SKAdNetworkIdentifier 6lz2ygh3q6.adattributionkit SKAdNetworkIdentifier m2jqnlggk3.adattributionkit SKAdNetworkIdentifier pg7ctvrt6f.adattributionkit SKAdNetworkIdentifier 77y3x8wds4.adattributionkit SKAdNetworkIdentifier 55644vm79v.skadnetwork SKAdNetworkIdentifier nzq8sh4pbs.skadnetwork SKAdNetworkIdentifier 55y65gfgn7.skadnetwork SKAdNetworkIdentifier 252b5q8x7y.skadnetwork SKAdNetworkIdentifier 47vhws6wlr.skadnetwork SKAdNetworkIdentifier 4mn522wn87.skadnetwork SKAdNetworkIdentifier 577p5t736z.skadnetwork SKAdNetworkIdentifier 7953jerfzd.skadnetwork SKAdNetworkIdentifier 7bxrt786m8.skadnetwork SKAdNetworkIdentifier 7fbxrn65az.skadnetwork SKAdNetworkIdentifier 8c4e2ghe7u.skadnetwork SKAdNetworkIdentifier 8r8llnkz5a.skadnetwork SKAdNetworkIdentifier 9yg77x724h.skadnetwork SKAdNetworkIdentifier ce8ybjwass.skadnetwork SKAdNetworkIdentifier dt3cjx1a9i.skadnetwork SKAdNetworkIdentifier eh6m2bh4zr.skadnetwork SKAdNetworkIdentifier gta8lk7p23.skadnetwork SKAdNetworkIdentifier gvmwg8q7h5.skadnetwork SKAdNetworkIdentifier hjevpa356n.skadnetwork SKAdNetworkIdentifier jk2fsx2rgz.skadnetwork SKAdNetworkIdentifier n66cz3y3bx.skadnetwork SKAdNetworkIdentifier pu4na253f3.skadnetwork SKAdNetworkIdentifier r8lj5b58b5.skadnetwork SKAdNetworkIdentifier s69wq72ugq.skadnetwork SKAdNetworkIdentifier v4nxqhlyqp.skadnetwork SKAdNetworkIdentifier vutu7akeur.skadnetwork SKAdNetworkIdentifier z24wtl6j62.skadnetwork SKAdNetworkIdentifier z4gj7hsk7h.skadnetwork SKAdNetworkIdentifier x8jxxk4ff5.skadnetwork SKAdNetworkIdentifier x8yj322td6.skadnetwork ``` If your Info.plist already contains a `SKAdNetworkItems` key, do not add a new one — merge only the array (``) entries. Duplicate keys cause iOS to use only the first array. Please contact Adrop for the full SKAdNetworkItems list and App ID. *** ## Initialization Initialize the SDK in `application(_:didFinishLaunchingWithOptions:)` of your `AppDelegate`. ```swift Swift (UIKit) theme={null} import AdropAds @main class AppDelegate: UIResponder, UIApplicationDelegate { func application( _ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? ) -> Bool { // Initialize SDK Adrop.initialize(production: false, useInAppBrowser: false, targetCountries: []) Adrop.setTheme(.auto) return true } } ``` ```swift Swift (SwiftUI) theme={null} import SwiftUI import AdropAds class AppDelegate: NSObject, UIApplicationDelegate { func application( _ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil ) -> Bool { // Initialize SDK Adrop.initialize(production: false, useInAppBrowser: false, targetCountries: []) Adrop.setTheme(.auto) return true } } @main struct MyApp: App { @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { ContentView() } } } ``` ```objc Objective-C theme={null} @import AdropAds; @implementation AppDelegate - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { // Initialize SDK [Adrop initializeWithProduction:NO useInAppBrowser:NO targetCountries:@[]]; [Adrop setTheme:AdropThemeAuto]; return YES; } @end ``` ### Initialization Parameters | Parameter | Type | Default | Description | | ----------------- | ----------- | ------- | ------------------------------------------------------------------------ | | `production` | `Bool` | `false` | Production mode. Set to `true` when deploying | | `targetCountries` | `[String]?` | `nil` | List of target country codes (ISO 3166 alpha-2). `nil` for all countries | | `useInAppBrowser` | `Bool` | `false` | Whether to use in-app browser | Make sure to set `production: true` before deployment. If deployed with `false`, ads will not be displayed. *** ## User Configuration ### Set UID Set a user identifier for targeted advertising. ```swift Swift theme={null} Adrop.setUID("user_123") ``` ```objc Objective-C theme={null} [Adrop setUID:@"user_123"]; ``` Set the UID before entering the ad placement for targeted ads to work properly. ### Set Theme Set the theme for ads that support dark mode. Must be set after calling `initialize()`. ```swift Swift theme={null} // Light mode Adrop.setTheme(.light) // Dark mode Adrop.setTheme(.dark) // Follow system settings (recommended) Adrop.setTheme(.auto) ``` ```objc Objective-C theme={null} // Light mode [Adrop setTheme:AdropThemeLight]; // Dark mode [Adrop setTheme:AdropThemeDark]; // Follow system settings (recommended) [Adrop setTheme:AdropThemeAuto]; ``` `auto` mode automatically detects system dark mode settings. When the theme changes, the splash ad cache is automatically reset. *** ## WebView Support Register a `WKWebView` to display web ads within a WebView. ```swift Swift theme={null} import WebKit import AdropAds Adrop.registerWebView(webView) ``` ```objc Objective-C theme={null} @import AdropAds; [Adrop registerWebView:webView]; ``` You can check the current SDK version using `Adrop.sdkVersion`. *** ## Deep Link Handling Handle deep links when the app is launched via external links. ```swift Swift (SceneDelegate) theme={null} func scene(_ scene: UIScene, openURLContexts URLContexts: Set) { guard let url = URLContexts.first?.url else { return } Adrop.handleDeepLink(url: url) } ``` ```swift Swift (AppDelegate) theme={null} func application( _ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:] ) -> Bool { Adrop.handleDeepLink(url: url) return true } ``` ```objc Objective-C theme={null} - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary *)options { [Adrop handleDeepLinkWithUrl:url]; return YES; } ``` *** ## Test Unit IDs Use test unit IDs during development. Replace with actual unit IDs before production deployment. ### Banner Ads | Format | Test Unit ID | | ------------------- | --------------------------------------- | | Banner (320x50) | `PUBLIC_TEST_UNIT_ID_320_50` | | Banner (320x100) | `PUBLIC_TEST_UNIT_ID_320_100` | | Carousel Banner | `PUBLIC_TEST_UNIT_ID_CAROUSEL` | | Banner Video (16:9) | `PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_16_9` | | Banner Video (9:16) | `PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_9_16` | ### Native Ads | Format | Test Unit ID | | ------------------- | --------------------------------------- | | Native (Image) | `PUBLIC_TEST_UNIT_ID_NATIVE` | | Native Video (16:9) | `PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_16_9` | | Native Video (9:16) | `PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_9_16` | ### Interstitial/Rewarded Ads | Format | Test Unit ID | | ------------ | ---------------------------------- | | Interstitial | `PUBLIC_TEST_UNIT_ID_INTERSTITIAL` | | Rewarded | `PUBLIC_TEST_UNIT_ID_REWARDED` | ### Popup Ads | Format | Test Unit ID | | ------------------------- | --------------------------------------------- | | Popup (Bottom) | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM` | | Popup (Center) | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER` | | Popup Video Bottom (16:9) | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_16_9` | | Popup Video Bottom (9:16) | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_9_16` | | Popup Video Center (16:9) | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_16_9` | | Popup Video Center (9:16) | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_9_16` | ### Splash Ads | Format | Test Unit ID | | ------ | ---------------------------- | | Splash | `PUBLIC_TEST_UNIT_ID_SPLASH` | *** ## Error Codes Main error codes returned when ad loading fails. | Error Code | Description | | ------------------------- | --------------------------- | | `ERROR_CODE_AD_NO_FILL` | No available ads to display | | `ERROR_CODE_NETWORK` | Network connection failed | | `ERROR_CODE_INVALID_UNIT` | Invalid unit ID | | `ERROR_CODE_INITIALIZE` | SDK initialization required | See [Reference](/sdk/ios/reference) for detailed error codes. *** ## Table of Contents Implementing banner ads Implementing native ads Implementing interstitial ads Implementing rewarded ads Implementing popup ads Implementing splash ads Display web ads in WebView GDPR/CCPA consent management User attributes and contextual targeting Classes, delegates, error codes Example repository