> ## 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 ファイルの追加 [Adropコンソール](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`キーがある場合は、新たに追加せず配列（``）の項目のみマージしてください。同じキーを2つ置くと、iOSは最初の配列のみを使用します。 SKAdNetworkItemsの全リストとApp IDの発行についてはAdropにお問い合わせください。 *** ## 初期化 `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初期化が必要 | 詳細なエラーコードは[リファレンス](/ja/sdk/ios/reference)を参照してください。 *** ## 目次バナー広告の実装ネイティブ広告の実装インタースティシャル広告の実装リワード広告の実装ポップアップ広告の実装スプラッシュ広告の実装 WebViewでウェブ広告を表示 GDPR/CCPA同意管理ユーザー属性とコンテキストターゲティングクラス、デリゲート、エラーコードサンプルリポジトリ