このガイドでは、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 管理画面で Meta Audience Network のデマンドを設定する
広告ユニットのメディエーション設定を構成する
GDPR と米国の州規制の広告パートナー リストに Meta を追加
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 の管理画面でテストモードを有効にしてください。
テスト広告を確認する
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 でビルド、テスト済み。