> ## 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. # はじめに > FlutterアプリにAdrop SDKを連携する方法をご案内します。 ## 概要 Adrop Flutter SDKを使用すると、Flutterアプリでさまざまな広告フォーマットを簡単に連携できます。 ### サポート広告フォーマット | フォーマット | 説明 | | ------------ | -------------------- | | バナー広告 | 画面の一部に表示される長方形の広告 | | ネイティブ広告 | アプリコンテンツと自然に調和する広告 | | インタースティシャル広告 | 全画面を覆う広告 | | リワード広告 | 報酬を提供する全画面広告 | | ポップアップ広告 | ポップアップ形式で表示される広告 | | スプラッシュ広告 | アプリ起動時にロゴと一緒に表示される広告 | *** ## 要件 ### Flutter * Flutter SDK **3.3.0** 以上 * Dart SDK **2.18.0** 以上 ### Android * API レベル **23** (Android 6.0) 以上 * `compileSdkVersion` **34** * Kotlin **2.1.0** 以上 * Gradle **8.7** 以上 * Jetpack (AndroidX) 使用 ### iOS * iOS **13.0** 以上 * Swift **5.0** 以上 *** ## インストール ### 1. パッケージのインストールプロジェクトディレクトリで次のコマンドを実行します。 ```bash theme={null} flutter pub add adrop_ads_flutter ``` ### 2. Androidの設定 `android/settings.gradle.kts`にバックフィル広告リポジトリを追加します。 ```kotlin android/settings.gradle.kts theme={null} dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() maven { url = uri("https://artifact.bytedance.com/repository/pangle") } } } ``` `android/app/build.gradle`にバックフィル依存関係を追加します。 ```gradle android/app/build.gradle theme={null} dependencies { implementation 'io.adrop:adrop-ads-backfill:1.11.2' } ``` `android/app/src/main/AndroidManifest.xml`にバックフィルApp IDを追加します。 ```xml android/app/src/main/AndroidManifest.xml theme={null}

``` App IDの発行についてはAdropにお問い合わせください。 ### 3. iOSの設定 `ios/Podfile`を修正します。 ```ruby ios/Podfile theme={null} use_frameworks! target 'Runner' do # その他の依存関係... # バックフィル広告SDK pod 'adrop-ads-backfill' end ``` Podをインストールします。 ```bash theme={null} cd ios && pod install --repo-update && cd .. ``` ### 4. Info.plistの設定バックフィル広告のために`ios/Runner/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にお問い合わせください。 ### 5. 設定ファイルの追加 #### Android 1. Ad Controlコンソールから **adrop\_service.json** ファイルをダウンロードします。 2. ファイルを`android/app/src/main/assets/`ディレクトリにコピーします。 ``` android/app/src/main/assets/adrop_service.json ``` #### iOS 1. Ad Controlコンソールから **adrop\_service.json** ファイルをダウンロードします。 2. Xcodeでプロジェクトルートにファイルを追加します。 3. すべてのターゲットにファイルを追加するように選択します。 *** ## 初期化アプリ起動時にSDKを初期化します。通常は`main.dart`で呼び出します。 ```dart main.dart theme={null} import 'package:adrop_ads_flutter/adrop_ads_flutter.dart'; void main() { runApp(const MyApp()); } class MyApp extends StatefulWidget { const MyApp({super.key}); @override State createState() => _MyAppState(); } class _MyAppState extends State { @override void initState() { super.initState(); _initializeAdrop(); } Future _initializeAdrop() async { // false: テストモード, true: プロダクションモード await Adrop.initialize(false); } @override Widget build(BuildContext context) { return MaterialApp( home: HomeScreen(), ); } } ``` ### 初期化オプション ```dart theme={null} await Adrop.initialize( production, // bool: プロダクションモードかどうか targetCountries: targetCountries, // List?: ターゲット国コード配列 (オプション) useInAppBrowser: useInAppBrowser // bool?: iOSインアプリブラウザ使用 (オプション) ); ``` **パラメータ** | パラメータ | タイプ | 必須 | 説明 | | ----------------- | -------------- | -- | ----------------------------------- | | `production` | `bool` | Y | `true`: プロダクションモード, `false`: テストモード | | `targetCountries` | `List` | N | 広告を表示する国コード (例: `['KR', 'US']`) | | `useInAppBrowser` | `bool` | N | iOSでインアプリブラウザを使用 (デフォルト: `false`) | **例** ```dart theme={null} // 基本初期化 (テストモード) await Adrop.initialize(false); // プロダクションモード + 特定国ターゲティング await Adrop.initialize(true, targetCountries: ['KR', 'JP', 'US']); // プロダクションモード + iOSインアプリブラウザ使用 await Adrop.initialize(true, useInAppBrowser: true); ``` *** ## テーマ設定広告UIテーマを設定します。 ```dart theme={null} import 'package:adrop_ads_flutter/adrop_ads_flutter.dart'; // テーマ設定 await Adrop.setTheme(AdropTheme.auto); // システム設定に従う await Adrop.setTheme(AdropTheme.light); // ライトモード await Adrop.setTheme(AdropTheme.dark); // ダークモード ``` | テーマ | 説明 | | ------------------ | ---------------- | | `AdropTheme.auto` | システム設定に従って自動切り替え | | `AdropTheme.light` | ライトモード | | `AdropTheme.dark` | ダークモード | *** ## ユーザー識別子の設定ターゲティング広告のためにユーザー識別子(UID)を設定します。 ```dart theme={null} import 'package:adrop_ads_flutter/adrop_ads_flutter.dart'; // ユーザーログイン後 await Adrop.setUID('user_123'); // ログアウト時 await Adrop.setUID(''); ``` UIDはSHA-256でハッシュ化されて送信されます。メール、電話番号などの個人情報を直接渡さないでください。 *** ## テストユニットID 開発およびテスト時に次のテストユニットIDを使用してください。 | フォーマット | テストユニットID | | ------------- | ---------------------------------- | | バナー (320x50) | `PUBLIC_TEST_UNIT_ID_320_50` | | バナー (320x100) | `PUBLIC_TEST_UNIT_ID_320_100` | | ネイティブ | `PUBLIC_TEST_UNIT_ID_NATIVE` | | インタースティシャル | `PUBLIC_TEST_UNIT_ID_INTERSTITIAL` | | リワード | `PUBLIC_TEST_UNIT_ID_REWARDED` | | ポップアップ (下部) | `PUBLIC_TEST_UNIT_ID_POPUP_BOTTOM` | | ポップアップ (中央) | `PUBLIC_TEST_UNIT_ID_POPUP_CENTER` | | スプラッシュ | `PUBLIC_TEST_UNIT_ID_SPLASH` | プロダクション配布前に必ず実際のユニットIDに置き換えてください。 *** ## エラーコード SDKで発生する可能性のあるエラーコードです。 | エラーコード | 説明 | | --------------------------- | ----------- | | `network` | ネットワークエラー | | `internal` | 内部エラー | | `initialize` | SDK初期化エラー | | `invalidUnit` | 無効なユニットID | | `notTargetCountry` | ターゲット国ではない | | `inactive` | 無効化された広告 | | `adNoFill` | 表示する広告がない | | `adLoadDuplicate` | 重複ロードリクエスト | | `adLoading` | ロード進行中 | | `adEmpty` | 空の広告 | | `adShown` | すでに表示された広告 | | `adHideForToday` | 今日は非表示に設定 | | `accountUsageLimitExceeded` | アカウント使用制限超過 | | `adLandscapeUnsupported` | 横モード未対応 | | `backfillNoFill` | バックフィル広告なし | ```dart theme={null} import 'package:adrop_ads_flutter/adrop_ads_flutter.dart'; // エラー処理例 if (errorCode == AdropErrorCode.adNoFill) { debugPrint('表示する広告がありません。'); } ``` *** ## 非推奨クラスのマイグレーション以下のクラスは非推奨（deprecated）となりました。今後のバージョンで削除される予定のため、新しいクラスにマイグレーションしてください。 ### AdropBanner → AdropBannerView `AdropBanner`ウィジェットは非推奨です。`AdropBannerView`にマイグレーションしてください。 ```dart theme={null} // ❌ Deprecated AdropBanner( unitId: 'YOUR_UNIT_ID', onAdropBannerCreated: (controller) { controller.load(); }, onAdReceived: (banner) { }, ); // ✅ 推奨（AdropBannerView） final bannerView = AdropBannerView( unitId: 'YOUR_UNIT_ID', listener: AdropBannerListener( onAdReceived: (unitId, metadata) { }, onAdFailedToReceive: (unitId, errorCode) { }, ), ); bannerView.load(); ``` ### AdropNavigatorObserver (Deprecated) `AdropNavigatorObserver`は非推奨となり、今後のバージョンで削除される予定です。このクラスはもう機能を提供しないため、コードから削除しても問題ありません。 ```dart theme={null} // ❌ Deprecated — 削除可能 MaterialApp( navigatorObservers: [AdropNavigatorObserver()], ); // ✅ AdropNavigatorObserverを削除 MaterialApp( // navigatorObserversからAdropNavigatorObserverを削除 ); ``` *** ## トラブルシューティング ### iOSビルドエラー Swiftバージョンの互換性問題が発生した場合、`ios/Podfile`の`post_install`ブロックに次を追加してください。 ```ruby ios/Podfile theme={null} post_install do |installer| installer.pods_project.targets.each do |target| target.build_configurations.each do |config| config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES' end end end ``` ### Androidビルドエラー Kotlinバージョンが合わない場合、`android/build.gradle`でKotlinバージョンを確認してください。 ```gradle android/build.gradle theme={null} buildscript { ext.kotlin_version = '2.1.0' } ``` *** ## 次のステップバナー広告を実装するネイティブ広告を実装するインタースティシャル広告を実装するリワード広告を実装する WebViewでウェブ広告を表示 GDPR/CCPA同意管理