このガイドでは、Google Mobile Ads SDK でメディエーションを使用して、Meta Audience Network から広告を読み込んで表示し、入札の統合を行う方法について説明します。ここでは、Meta Audience Network を広告ユニットのメディエーション構成に追加する方法と、Meta Audience Network とアダプターをアプリに統合する方法について説明します。 Flutter
サポートされている統合と広告フォーマット
Meta Audience Network の AdMob メディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 単価設定 | |
| ウォーターフォール 1 | |
| フォーマット | |
| バナー | |
| インタースティシャル | |
| 特典 | |
| リワード インタースティシャル | |
1 Meta Audience Network は 2021 年に入札のみになりました。
要件
- 最新の Google Mobile Ads SDK
- Flutter 3.7.0 以降
- Android にデプロイするには
- Android API レベル 21 以降
- iOS にデプロイするには
- iOS デプロイ ターゲットが 10.0 以降
- 通常、最新の Meta Audience Network SDK を使用するには、最新バージョンの Xcode が必要です。
- Google Mobile Ads SDK で構成された動作する Flutter プロジェクト。詳しくは、使ってみるをご覧ください。
- メディエーションのスタートガイドの手順を完了していること
ステップ 1: Meta Audience Network の管理画面で設定を行う
ビジネス マネージャーの開始ページに登録してログインします。
[始める]、[新しいアカウントを作成] の順にクリックします。
必須項目にビジネスの詳細を入力し、[次へ] をクリックします。
プロパティを作成する
必要な情報を入力すると、アプリのプロパティを作成するよう求められます。アプリのプロパティの名前を入力し、[次へ] をクリックします。
次に、収益化するプラットフォームを選択します。
アプリの詳細を追加し、[次へ] をクリックします。
Android
iOS
[新しいお支払いアカウントを追加] をクリックして、お支払いアカウントを設定します。支払い情報を入力するための新しいページにリダイレクトされます。必要な情報を入力し、[次へ] をクリックします。
メディエーション プラットフォームとして [Google AdMob] を選択し、[プレースメントを作成] をクリックします。
フォーマットを選択し、フォームに記入して [作成] をクリックします。
プレースメント ID をメモしておきます。
[完了] をクリックします。
テストモードをオンにする
Meta Audience Network のテスト広告を有効にする方法について詳しくは、Audience Network の実装テストガイドをご覧ください。
ステップ 2: AdMob UI で Meta Audience Network のデマンドを設定する
広告ユニットのメディエーション設定を行う
GDPR と米国の州規制の広告パートナー リストに Facebook を追加
GDPR 設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の GDPR と米国の州規制の広告パートナー リストに Meta を追加します。
ステップ 3: Meta Audience Network SDK とアダプターをインポートする
pub.dev による統合
パッケージの pubspec.yaml ファイルに、最新バージョンのMeta Audience Network SDK とアダプタを含む次の依存関係を追加します。
dependencies:
gma_mediation_meta: ^1.0.0
手動による統合
Meta Audience Network 用の Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（とその内容）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。
dependencies:
gma_mediation_meta:
path: path/to/local/package
ステップ 4: Meta Audience Network SDK にプライバシー設定を実装する
EU ユーザーの同意と GDPR
Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域（EEA）のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受領、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。
GDPR と Meta 広告について詳しくは、Meta のガイダンスをご覧ください。
米国のプライバシー関連州法
米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。
カリフォルニア州に居住するユーザーについては、Meta のデータ処理オプションを確認してください。
ステップ 5: 必要なコードを追加する
Android
Meta Audience Network の統合に追加のコードは必要ありません。
iOS
SKAdNetwork の統合
Meta Audience Network のドキュメントに沿って、SKAdNetwork ID をプロジェクトの Info.plist ファイルに追加します。
広告トラッキングが有効
iOS 14 以降を対象に開発する場合は、Meta Audience Network の広告トラッキング フラグを設定する手順をご覧ください。
ステップ 6: 実装をテストする
テスト広告を有効にする
必ず AdMob にテストデバイスを登録し、Meta Audience Network の UI でテストモードを有効にします。
テスト広告を確認する
Meta Audience Network からテスト広告が配信されていることを確認するには、広告インスペクタで Meta Audience Network（入札）広告ソースを使用して単一の広告ソースのテストを有効にします。
省略可能なステップ
Android 9 のキャッシュ
Android
Android 9（API レベル 28）以降、クリアテキストのサポートがデフォルトで無効になっています。これは、Meta Audience Network SDK のメディア キャッシュ機能に影響し、ユーザー エクスペリエンスと広告収益に影響する可能性があります。Meta のドキュメントに沿って、アプリのネットワーク セキュリティ構成を更新します。
iOS
iOS との統合には適用されません。
エラーコード
アダプターがオーディエンス ネットワークから広告を受信できない場合は、次のクラスの ResponseInfo を使用して、広告レスポンスから根本的なエラーを確認できます。
Android
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
広告の読み込みに失敗したときに Meta Audience Network アダプタからスローされるコードとそれに付随するメッセージは次のとおりです。
Android
| エラーコード | 理由 |
|---|---|
| 101 | サーバー パラメータが無効です（プレースメント ID が指定されていないなど）。 |
| 102 | リクエストされた広告サイズが、Meta Audience Network でサポートされているバナーサイズと一致しません。 |
| 103 | パブリッシャーは、Activity コンテキストで広告をリクエストする必要があります。 |
| 104 | Meta Audience Network SDK を初期化できませんでした。 |
| 105 | パブリッシャーが統合型ネイティブ広告をリクエストしていない。 |
| 106 | 読み込まれたネイティブ広告が、想定していたオブジェクトと異なります。 |
| 107 | 使用されている Context オブジェクトが無効です。 |
| 108 | 読み込まれた広告に、必須のネイティブ広告アセットがありません。 |
| 109 | 入札ペイロードからネイティブ広告を作成できませんでした。 |
| 110 | Meta Audience Network SDK がインタースティシャル広告/リワード広告を表示できませんでした。 |
| 111 | Meta Audience Network の AdView オブジェクトの作成時にスローされる例外。 |
| 1000-9999 | Meta Audience Network から SDK 固有のエラーが返された。詳しくは、Meta Audience Network のドキュメントをご覧ください。 |
iOS
| エラーコード | 理由 |
|---|---|
| 101 | サーバー パラメータが無効です（プレースメント ID が指定されていないなど）。 |
| 102 | リクエストされた広告サイズが、Meta Audience Network でサポートされているバナーサイズと一致しません。 |
| 103 | Meta Audience Network 広告オブジェクトの初期化に失敗しました。 |
| 104 | Meta Audience Network SDK がインタースティシャル広告/リワード広告を表示できませんでした。 |
| 105 | バナー広告のルートビュー コントローラは nil です。 |
| 106 | Meta Audience Network SDK を初期化できませんでした。 |
| 1000-9999 | Meta Audience Network から SDK 固有のエラーが返された。詳しくは、Meta Audience Network のドキュメントをご覧ください。 |
Meta Audience Network Flutter メディエーション アダプタの変更履歴
次のバージョン
- Google Mobile Ads Flutter プラグインのバージョン 5.2.0 を使って作成、テストしています。
1.1.0
- Meta Android アダプター バージョン 6.17.0.0 との互換性を確認済み
- Meta iOS アダプタ バージョン 6.15.2.0 との互換性が確認されました
- Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テスト済み。
1.0.1
- ホスト プラットフォームとの適切な互換性分析を可能にする dart クラスを追加
- Meta Android アダプター バージョン 6.17.0.0 との互換性を確認済み
- Meta iOS アダプター バージョン 6.15.0.0 との互換性が確認済み
- Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テスト済み。
1.0.0
- 初回リリース。
- Meta Android アダプター バージョン 6.17.0.0 との互換性を確認済み
- Meta iOS アダプター バージョン 6.15.0.0 との互換性が確認済み
- Google Mobile Ads Flutter プラグイン バージョン 5.0.0 でビルド、テスト済み。