このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを介して InMobi の広告を読み込んで表示する方法について説明します。ウォーターフォールと入札の両方の統合について説明します。InMobi を広告ユニットのメディエーション構成に追加する方法と、InMobi SDK とアダプターを Flutter アプリに統合する方法について説明します。
サポートされている統合と広告フォーマット
統合 | |
---|---|
単価設定 | 1 |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
ネイティブ | 2 |
1 入札の統合はオープンベータ版です。
2 ウォーターフォール メディエーションでのみサポートされます。
要件
- 最新の Google Mobile Ads SDK
- Flutter 3.7.0 以降
- [入札の場合]: サポートされているすべての広告フォーマットを入札に統合するには、Google Mobile Ads Mediation Plugin for InMobi 4.5.0 以降(最新バージョンを推奨)を使用します。
- Android にデプロイするには
- Android API レベル 21 以降
- iOS にデプロイするには
- iOS デプロイ ターゲットが 10.0 以降
- Google Mobile Ads SDK で構成された動作する Flutter プロジェクト。詳細については、スタートガイドをご覧ください。
- メディエーションのスタートガイドを完了していること
ステップ 1: InMobi UI で設定を行う
InMobi アカウントを登録します。アカウントを作成する際は、[Google Open Bidding で InMobi SSP を使用する] オプションをオフのままにします。
アカウントの確認が完了したら、ログインします。
アプリを追加
アプリを InMobi ダッシュボードに追加するには、[広告枠] > [広告枠の設定] をクリックします。
[広告枠を追加] をクリックし、プルダウン メニューから [モバイルアプリ] チャネルを選択します。
検索バーに公開済みのアプリストアの URL を入力し、自動入力された結果からアプリを選択します。[続行] をクリックします。
アプリが公開されていない場合は、[手動でリンク] をクリックして、必要な情報を入力します。[続行] をクリックします。
[アプリとウェブサイトのコンプライアンス] の設定を確認し、[プレースメントを保存して作成] をクリックします。
プレースメント
インベントリを設定すると、プレースメント作成ワークフローにリダイレクトされます。
単価設定
広告ユニットの種類を選択します。[プレースメント名] に入力し、[オーディエンス入札] と [パートナー] のそれぞれで [オン] と [Google Open Bidding] を選択し、フォームの残りを入力します。完了したら、[プレースメントを作成] をクリックします。
滝
広告ユニットの種類を選択します。次に、プレースメント名を入力し、[オーディエンス入札] で [オフ] を選択し、フォームの残りの部分を入力します。完了したら、[プレースメントを作成] をクリックします。
プレースメントが作成されると、その詳細が表示されます。プレースメント ID をメモします。これは、AdMob 広告ユニットの設定に使用されます。
アカウント ID
InMobi アカウント ID は、[財務 > お支払い設定 > お支払い情報] で確認できます。
InMobi Reporting API キーを確認する
単価設定
この手順は、入札の統合では必要ありません。
滝
[マイ アカウント] > [アカウント設定] に移動します。[API キー] タブに移動し、[API キーを生成する] をクリックします。
キーが必要なユーザーのメールアドレスを選択し、[API キーを生成する] をクリックします。API キーとユーザー名/ログイン名を含むファイルが生成されます。
すべてのユーザーの API キーを生成できるのは、アカウントのパブリッシャー管理者のみです。以前に生成した API キーを忘れた場合は、[API キー] タブでメールにカーソルを合わせ、API キーをリセットします。
テストモードをオンにする
すべてのライブ インプレッションまたは特定のテストデバイスでのみ、プレースメントのテストモードを有効にします。
ステップ 2: AdMob の管理画面で InMobi デマンドを設定する
広告ユニットのメディエーション設定を構成する
GDPR と米国の州規制の広告パートナー リストに InMobi を追加
GDPR 設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の GDPR と米国の州規制の広告パートナー リストに InMobi を追加します。
ステップ 3: InMobi SDK とアダプタをインポートする
pub.dev による統合
パッケージの pubspec.yaml
ファイルに、最新バージョンの InMobi SDK とアダプタを含む次の依存関係を追加します。
dependencies:
gma_mediation_inmobi: ^1.0.0
手動による統合
InMobi 用の Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ(とその内容)を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml
ファイルでプラグインを参照します。
dependencies:
gma_mediation_inmobi:
path: path/to/local/package
ステップ 4: InMobi SDK にプライバシー設定を実装する
EU ユーザーの同意と GDPR
Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域(EEA)のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則(GDPR)の要件が反映されています。同意を求める際は、個人データを収集、受領、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。
InMobi 向け Google Mobile Ads メディエーション プラグインは、InMobi SDK への同意情報の渡しをサポートしていません。
米国のプライバシー関連州法
米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。
InMobi 向け Google Mobile Ads メディエーション プラグインは、InMobi SDK への同意情報の渡しをサポートしていません。
ステップ 5: 必要な追加コードを追加する
Android
InMobi の統合に追加のコードは必要ありません。
iOS
SKAdNetwork の統合
InMobi のドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist
ファイルに追加します。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob にテストデバイスを登録し、InMobi 管理画面でテストモードを有効にしてください。
テスト広告を確認する
InMobi からテスト広告が配信されていることを確認するには、広告インスペクタで InMobi(入札)と InMobi(ウォーターフォール)の広告ソースを使用して、単一の広告ソースのテストを有効にします。
省略可能なステップ
Android
権限
最適なパフォーマンスを得るため、InMobi では、アプリの AndroidManifest.xml
ファイルに次のオプションの権限を追加することをおすすめします。
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
必要に応じて、これらの権限を Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml
ファイルに追加できます。
iOS
iOS の統合に追加の手順は必要ありません。
エラーコード
アダプターが InMobi から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo
を使用して、広告レスポンスの根本的なエラーを確認できます。
Android
com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter
iOS
GADMAdapterInMobi
GADMediationAdapterInMobi
広告の読み込みに失敗したときに InMobi アダプタによってスローされるコードとそれに付随するメッセージは次のとおりです。
Android
エラーコード | 理由 |
---|---|
0-99 | InMobi SDK エラー。詳しくは、コードをご覧ください。 |
100 | AdMob 管理画面で設定された InMobi サーバー パラメータが存在しないか、無効です。 |
101 | InMobi SDK を初期化できませんでした。 |
102 | リクエストされた広告サイズが、InMobi でサポートされているバナーサイズと一致しません。 |
103 | 広告リクエストが統合型ネイティブ広告リクエストではない。 |
104 | InMobi SDK を初期化せずに InMobi 広告をリクエストしようとしました。理論上、これは発生しないはずです。アダプタは InMobi 広告をリクエストする前に InMobi SDK を初期化するためです。 |
105 | InMobi の広告はまだ表示できる状態ではありません。 |
106 | InMobi で広告を表示できませんでした。 |
107 | InMobi から、必須のアセットがないネイティブ広告が返されました。 |
108 | InMobi のネイティブ広告の画像アセットに、形式の正しくない URL が含まれています。 |
109 | アダプターが InMobi のネイティブ広告の画像アセットをダウンロードできませんでした。 |
iOS
エラーコード | 理由 |
---|---|
101 | AdMob 管理画面で設定された InMobi サーバー パラメータが存在しない、または無効です。 |
102 | InMobi アダプターは、リクエストされた広告フォーマットをサポートしていません。 |
103 | このネットワーク構成では、InMobi 広告がすでに読み込まれています。 |
その他 | InMobi SDK からエラーが返されました。詳しくは、IMRequestStatus.h をご覧ください。 |
InMobi Flutter メディエーション アダプタの変更履歴
次のバージョン
- Google Mobile Ads Flutter プラグイン バージョン 5.2.0 でビルド、テスト済み。
1.1.0
- InMobi Android アダプター バージョン 10.7.5.0 との互換性が確認されました。
- InMobi iOS アダプター バージョン 10.7.5.0 との互換性が確認されました。
- Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テスト済み。
1.0.0
- 初回リリース。
- InMobi Android アダプター バージョン 10.6.7.1 との互換性が確認されました。
- InMobi iOS アダプター バージョン 10.7.2.0 との互換性を確認しました。
- Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テスト済み。