> ## 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. # 시작하기 > iOS 프로젝트에 Adrop SDK를 연동하는 방법을 안내합니다. ## 개요 Adrop iOS SDK를 사용하여 다양한 광고 포맷을 앱에 표시할 수 있습니다. ### 지원 광고 포맷 | 포맷 | 설명 | | -------- | ----------------------- | | **배너** | 화면의 일부 영역에 표시되는 직사각형 광고 | | **네이티브** | 앱 UI에 맞게 커스터마이징 가능한 광고 | | **전면** | 화면 전체를 덮는 전면 광고 | | **보상형** | 시청 완료 시 보상을 제공하는 동영상 광고 | | **팝업** | 특정 시점에 팝업으로 표시되는 광고 | | **스플래시** | 앱 시작 시 로고와 함께 표시되는 광고 | ### 요구 사항 * iOS 13.0 이상 * Xcode 14.1 이상 * Swift 5.0 이상 *** ## 사전 준비 ### 1. adrop\_service.json 파일 추가 [애드컨트롤 콘솔](https://console.adrop.io) > **Admin** > **App** 에서 `adrop_service.json` 파일을 다운로드합니다. 다운로드한 파일을 Xcode 프로젝트 루트에 추가합니다. 파일 추가 시 **모든 타겟이 선택**되어 있는지 확인합니다. `adrop_service.json` 파일이 없으면 SDK가 정상 동작하지 않습니다. ### 2. 유닛 ID 확인 콘솔의 **Ad Unit** 탭에서 광고 지면에 해당하는 유닛 ID를 확인합니다. *** ## 설치 ### Swift Package Manager (권장) 1. Xcode에서 **File > Add Package Dependencies...** 선택 2. 패키지 URL 입력: ``` https://github.com/OpenRhapsody/adrop-ads-pod ``` 3. **Add Package** 클릭 백필 광고를 사용하려면 추가 패키지를 등록하세요: ``` https://github.com/OpenRhapsody/adrop-ads-backfill-pod ``` ### CocoaPods 1. Podfile이 없으면 생성: ```bash theme={null} pod init ``` 2. Podfile에 추가: ```ruby title="Podfile" theme={null} pod 'AdropAds' pod 'AdropAdsBackfill' ``` 3. 설치: ```bash theme={null} pod install --repo-update ``` 4. `.xcworkspace` 파일로 프로젝트 열기 ### Info.plist 설정 백필 광고를 위해 `Info.plist`에 다음 설정을 추가합니다: * **GADApplicationIdentifier**: 백필 광고용 App ID * **SKAdNetworkItems**: 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 ``` 기존 Info.plist에 이미 `SKAdNetworkItems` 키가 있다면 새로 추가하지 말고 배열(``) 항목만 병합하세요. 동일 키를 두 번 두면 iOS는 첫 번째 배열만 사용합니다. 전체 SKAdNetworkItems 목록과 App ID 발급은 에이드랍에 문의해주세요. *** ## 초기화 `AppDelegate`의 `application(_:didFinishLaunchingWithOptions:)`에서 SDK를 초기화합니다. ```swift Swift (UIKit) theme={null} import AdropAds @main class AppDelegate: UIResponder, UIApplicationDelegate { func application( _ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? ) -> Bool { // 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 { // 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 { // SDK 초기화 [Adrop initializeWithProduction:NO useInAppBrowser:NO targetCountries:@[]]; [Adrop setTheme:AdropThemeAuto]; return YES; } @end ``` ### 초기화 파라미터 | 파라미터 | 타입 | 기본값 | 설명 | | ----------------- | ----------- | ------- | --------------------------------------------- | | `production` | `Bool` | `false` | 프로덕션 모드 여부. 배포 시 `true`로 설정 | | `targetCountries` | `[String]?` | `nil` | 타겟 국가 코드 목록 (ISO 3166 alpha-2). `nil`이면 모든 국가 | | `useInAppBrowser` | `Bool` | `false` | 인앱 브라우저 사용 여부 | 배포 전 반드시 `production: true`로 설정하세요. `false`로 배포하면 광고가 노출되지 않습니다. *** ## 사용자 설정 ### UID 설정 타겟팅 광고를 위해 사용자 식별자를 설정합니다. ```swift Swift theme={null} Adrop.setUID("user_123") ``` ```objc Objective-C theme={null} [Adrop setUID:@"user_123"]; ``` 타겟팅 광고가 정상 동작하려면 광고 지면 진입 전에 UID를 설정하세요. ### 테마 설정 다크 모드를 지원하는 광고를 위해 테마를 설정합니다. `initialize()` 호출 후 설정해야 합니다. ```swift Swift theme={null} // 라이트 모드 Adrop.setTheme(.light) // 다크 모드 Adrop.setTheme(.dark) // 시스템 설정 따르기 (권장) Adrop.setTheme(.auto) ``` ```objc Objective-C theme={null} // 라이트 모드 [Adrop setTheme:AdropThemeLight]; // 다크 모드 [Adrop setTheme:AdropThemeDark]; // 시스템 설정 따르기 (권장) [Adrop setTheme:AdropThemeAuto]; ``` `auto` 모드는 시스템 다크 모드 설정을 자동으로 감지합니다. 테마가 변경되면 스플래시 광고 캐시가 자동으로 초기화됩니다. *** ## WebView 지원 `WKWebView`를 등록하여 WebView 내에서 웹 광고를 표시할 수 있습니다. ```swift Swift theme={null} import WebKit import AdropAds Adrop.registerWebView(webView) ``` ```objc Objective-C theme={null} @import AdropAds; [Adrop registerWebView:webView]; ``` `Adrop.sdkVersion`을 사용하여 현재 SDK 버전을 확인할 수 있습니다. *** ## 딥링크 처리 외부 링크를 통해 앱이 실행된 경우 딥링크를 처리합니다. ```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; } ``` *** ## 테스트 유닛 ID 개발 중에는 테스트 유닛 ID를 사용하세요. 프로덕션 배포 전 실제 유닛 ID로 교체해야 합니다. ### 배너 광고 | 포맷 | 테스트 유닛 ID | | ------------- | --------------------------------------- | | 배너 (320x50) | `PUBLIC_TEST_UNIT_ID_320_50` | | 배너 (320x100) | `PUBLIC_TEST_UNIT_ID_320_100` | | 캐러셀 배너 | `PUBLIC_TEST_UNIT_ID_CAROUSEL` | | 배너 비디오 (16:9) | `PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_16_9` | | 배너 비디오 (9:16) | `PUBLIC_TEST_UNIT_ID_BANNER_VIDEO_9_16` | ### 네이티브 광고 | 포맷 | 테스트 유닛 ID | | --------------- | --------------------------------------- | | 네이티브 (이미지) | `PUBLIC_TEST_UNIT_ID_NATIVE` | | 네이티브 비디오 (16:9) | `PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_16_9` | | 네이티브 비디오 (9:16) | `PUBLIC_TEST_UNIT_ID_NATIVE_VIDEO_9_16` | ### 전면/보상형 광고 | 포맷 | 테스트 유닛 ID | | --- | ---------------------------------- | | 전면 | `PUBLIC_TEST_UNIT_ID_INTERSTITIAL` | | 보상형 | `PUBLIC_TEST_UNIT_ID_REWARDED` | ### 팝업 광고 | 포맷 | 테스트 유닛 ID | | ---------------- | --------------------------------------------- | | 팝업 (하단) | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM` | | 팝업 (중앙) | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER` | | 팝업 비디오 하단 (16:9) | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_16_9` | | 팝업 비디오 하단 (9:16) | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM_VIDEO_9_16` | | 팝업 비디오 중앙 (16:9) | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_16_9` | | 팝업 비디오 중앙 (9:16) | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER_VIDEO_9_16` | ### 스플래시 광고 | 포맷 | 테스트 유닛 ID | | ---- | ---------------------------- | | 스플래시 | `PUBLIC_TEST_UNIT_ID_SPLASH` | *** ## 에러 코드 광고 로드 실패 시 반환되는 주요 에러 코드입니다. | 에러 코드 | 설명 | | ------------------------- | ------------ | | `ERROR_CODE_AD_NO_FILL` | 노출 가능한 광고 없음 | | `ERROR_CODE_NETWORK` | 네트워크 연결 실패 | | `ERROR_CODE_INVALID_UNIT` | 잘못된 유닛 ID | | `ERROR_CODE_INITIALIZE` | SDK 초기화 필요 | 자세한 에러 코드는 [레퍼런스](/ko/sdk/ios/reference)를 참조하세요. *** ## 목차 배너 광고 구현하기 네이티브 광고 구현하기 전면 광고 구현하기 보상형 광고 구현하기 팝업 광고 구현하기 스플래시 광고 구현하기 WebView에서 웹 광고 표시 GDPR/CCPA 동의 관리 사용자 속성 및 문맥 타겟팅 클래스, Delegate, 에러 코드 예제 레포지토리