Meta Audience Network を入札と統合する

[プラットフォームを選択]: Android（ベータ版） New-selected Android iOS Unity Flutter

このガイドでは、GMA Next-Gen SDK を使用して AdMob メディエーションで Meta Audience Network の広告を読み込んで表示する方法を、入札の統合を含めて説明します。また、広告ユニットのメディエーション設定に Meta Audience Network を追加する方法と、Meta Audience Network SDK とアダプタを Android アプリに統合する方法についても取り上げます。

サポートされている統合と広告フォーマット

Meta Audience Network のメディエーション アダプタには、次の機能があります。

統合
入札単価
ウォーターフォール  1
フォーマット
Banner 2
インタースティシャル
リワード
リワード インタースティシャル
ネイティブ

1 Meta Audience Network は 入札のみ に 2021 年になりました。
2 Meta Audience Network は、アンカー付きのインライン アダプティブ バナーをサポートしていません。

要件

  • 最新の GMA Next-Gen SDK

  • メディエーション スタートガイドの手順を完了していること

  • Android API レベル 24 以降

ステップ 1: Meta Audience Network の管理画面で構成を設定する

ビジネス マネージャーのスタート ページに登録してログインします。

[スタート] をクリックし、[新しいアカウントを作成] をクリックします。

必須項目にビジネスの詳細を入力し、[次へ] をクリックします。

プロパティを作成する

必要な情報を入力すると、アプリのプロパティを作成するよう求められます。アプリのプロパティの名前を入力し、[次へ] をクリックします。

次に、収益化するプラットフォームを選択します。

アプリの詳細を追加し、[次へ] をクリックします。

[新しい支払いアカウントを追加] をクリックして、支払いアカウントを設定します。支払い情報を入力するための新しいページにリダイレクトされます。必要な詳細情報を入力し、[次へ] をクリックします。

[メディエーション プラットフォーム] として [Google AdMob] を選択し、[配置を作成] をクリックします。

フォーマットを選択し、フォームに記入して [作成] をクリックします。

配置 ID をメモしておきます。

[完了] をクリックします。

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、アプリの app-ads.txt ファイルを設定します。

Meta Audience Network に app-ads.txt を実装するには、app-ads.txt で認証された販売者を識別するをご覧ください。

テストモードをオンにする

Meta Audience Network のテスト広告を有効にする方法について詳しくは、Audience Network の実装をテストする ガイドをご覧ください。

ステップ 2: AdMob の管理画面で Meta Audience Network のデマンドを設定する

広告ユニットのメディエーション設定を構成する

広告ユニットのメディエーション設定に Meta Audience Network を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更する既存のメディエーション グループがある場合は、 そのメディエーション グループの名前をクリックして編集し、 [広告のソースとして Meta Audience Network を追加する]に進みます。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] をクリックします。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、 メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

広告ユニット カードに選択した広告ユニットが表示されます。

広告のソースとして Meta Audience Network を追加する


[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[Meta Audience Network] を選択します。

[パートナー契約への署名手順] をクリックし、 [入札パートナーシップを設定] して Meta Audience Network と連携します。



[確認して同意する] をクリックし、[続行] をクリックします。



Meta Audience Network のマッピングがすでにある場合は、 それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。



次に、前のセクションで取得した [配置 ID] を入力します。[完了] をクリックします。

GDPR と米国の州規制の広告パートナー リストに Meta を追加する

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに Meta を追加します。

ステップ 3: Meta Audience Network SDK とアダプタをインポートする

アプリレベルの gradle ファイルに、次の実装の依存関係と構成を追加します。

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:facebook:6.21.0.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:facebook:6.21.0.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手動による統合

  • Android 用の Meta Audience Network SDK の最新バージョンをダウンロードします。 AudienceNetwork/bin フォルダにある AudienceNetwork.aar を解凍し、プロジェクトに追加します。

  • Google の Maven リポジトリで Meta Audience Network アダプタ アーティファクト に移動します。最新バージョンを選択し、Meta Audience Network アダプタの .aar ファイルをダウンロードして、プロジェクトに追加します。

ステップ 4: Meta Audience Network SDK にプライバシー設定を実装する

Google の EU ユーザーの同意ポリシーに準拠する には、欧州経済領域（EEA）、英国、スイスの ユーザーに対して特定の情報を開示し、法律で 義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告の パーソナライズを目的とした個人データの収集、共有、使用について ユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

Meta は IAB Europe のグローバル ベンダー リスト（GVL）に登録されていません。 代わりに、追加の同意 技術仕様を使用する必要があります。詳しくは、 追加の同意のコンポーネントをご覧ください。追加同意の仕様は、IAB Europe の透明性と同意に関するフレームワーク（TCF）バージョン 2 と連携して動作します。この仕様により、パブリッシャー様は、同意管理プラットフォーム（CMP）やパートナーとともに、Google の広告技術プロバイダ（ATP）リストに掲載されているものの、IAB Europe GVL にまだ登録されていない企業について、補足的な同意シグナルを収集して送信できます。

GDPR と Meta 広告に関するMeta のドキュメント のガイダンスに沿って対応してください。

米国のプライバシー関連州法

米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。

カリフォルニア州在住のユーザーのデータ処理オプションに関する Meta のドキュメント のガイダンスに沿って対応してください。

ステップ 5: 必要なコードを追加する

Meta Audience Network の統合には追加のコードは必要ありません。

ステップ 6: 実装をテストする

テスト広告を有効にする

AdMob 用のテストデバイスを登録し、Meta Audience Network の管理画面でテストモードを有効にしてください。

テスト広告を確認する

Meta Audience Network からテスト広告を受信していることを確認するには、 Meta Audience Network（入札） の広告のソースを使用して、広告インスペクタで 単一の広告ソースのテスト を有効にします。

省略可能なステップ

ネイティブ広告

一部の Meta Audience Network ネイティブ広告 アセットは、Google ネイティブ広告アセットに一対一でマッピングされません。このようなアセットは、NativeAd の getExtras() メソッドを介してバンドルでパブリッシャーに返されます。 アダプタは、次のアセットの受け渡しをサポートしています。

リクエスト パラメータと値
FacebookMediationAdapter.KEY_ID 文字列 。ネイティブ広告の一意の ID
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET 文字列 。広告のソーシャル コンテキスト

これらのアセットを抽出する方法を示すコード例を次に示します。

例:

Kotlin 

val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
  var socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
  // ...
}

Java 

Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
    String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
    // ...
}

MediaView を使用せずに Meta Audience Network ネイティブ広告を使用する

Meta Audience Network のネイティブ広告フォーマットでは、 MediaView アセットのレンダリングが必要です。そのアセットなしでネイティブ広告をレンダリングする場合は、 Meta Audience Network's ネイティブ バナー 広告フォーマットを使用してください。

代わりに Meta Audience Network のネイティブ バナー広告を使用するには、Meta Audience Network を設定するときに Native Banner フォーマットを選択する必要があります。アダプタは、対応するネイティブ広告フォーマットを自動的に読み込みます。

広告レンダリング

Audience Network アダプタは、ネイティブ広告を NativeAd オブジェクトとして返します。次の ネイティブ広告フィールドに値を設定します 。 NativeAd

フィールド Meta Audience Network アダプタによって設定
広告見出し
画像 1
本文
アプリアイコン
行動を促すフレーズ
広告主名
評価
ストア
価格

1 Meta Audience Network アダプタは、ネイティブ広告のメイン画像アセットへの直接アクセスを提供しません。代わりに、アダプタは MediaView に動画または画像を設定します。

インプレッションとクリック トラッキング

次の表に、GMA Next-Gen SDK でネイティブ広告のインプレッションとクリックが記録されるタイミングを示します。GMA Next-Gen SDK

表示回数の記録 クリックの記録
画面上の Meta Audience Network ネイティブ広告アセットの 1 ピクセル + アセット レンダリングの要件 Meta Audience Network SDK コールバック

Meta Audience Network では、インプレッションが有効と見なされるための特定のアセット レンダリング要件があります。これは、Meta Audience Network を設定するときに [ネイティブ] または [ネイティブ バナー] フォーマットを選択したかどうかによって異なります。

Meta Audience Network ネイティブ フォーマット 必須アセット 必要なレンダリング クラス
ネイティブ メディアビュー MediaView
ネイティブ バナー アプリアイコン ImageView

Android 9 でのキャッシュ保存

Android 9（API レベル 28）以降では、 クリアテキストのサポートがデフォルトで無効になっています。 これにより、Meta Audience Network SDK のメディア キャッシュ保存の機能に影響が生じ、ユーザー エクスペリエンスや広告収入に影響する可能性があります。Meta のドキュメントに沿って、アプリのネットワーク セキュリティ構成を更新します。

エラーコード

アダプタが Audience Network から広告を受け取れない場合は、 次のクラスの ResponseInfo.getAdSourceResponses() を使用して、広告レスポンスからエラーの詳細を確認できます。

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

広告の読み込みに失敗した場合に Audience Network アダプタがスローするコードとメッセージは次のとおりです。

エラーコード 理由
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 の ドキュメント をご覧ください。