このガイドでは、GMA Next-Gen SDK を使用して メディエーションで Meta Audience Network の広告を読み込んで表示する方法を、入札の統合を含めて説明します。また、広告ユニットのメディエーション設定に Meta Audience Network を追加する方法と、Meta Audience Network SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
Meta Audience Network のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札単価 | |
| ウォーターフォール 1 | |
| フォーマット | |
| バナー 2 | |
| インタースティシャル | |
| リワード | |
| リワード インタースティシャル | |
| ネイティブ | |
1
Meta Audience Network は、2021 年に入札のみになりました。
2
Meta Audience Network は、アンカー アダプティブ バナーとインライン アダプティブ バナーをサポートしていません。
要件
最新の GMA Next-Gen SDK。
メディエーションのスタートガイドの手順を完了していること
- Android API レベル 24 以降
- Meta Audience Network アダプタ 5.10.0.0 以降(最新バージョンを推奨)
ステップ 1: Meta Audience Network の管理画面で構成を設定する
ビジネス マネージャーのスタートページに登録してログインします。
[始める]、[新しいアカウントを作成] の順にクリックします。

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

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

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

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

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

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

配置 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: アド マネージャーの管理画面で Meta Audience Network のデマンドを設定する
アド マネージャー アカウントにログインします。
セキュア シグナルの共有を有効にする
[管理者] > [全般設定] に移動します。[Ad Exchange アカウントの設定] タブに移動し、[セキュア シグナルの共有] を確認してオンに切り替えます。[保存] をクリックします。

入札リクエストでセキュア シグナルを共有する
[広告枠] > [セキュア シグナル] に移動します。[セキュア シグナル] で、[Facebook] を検索し、[アプリ統合を有効にする] をオンにします。

[保存] をクリックします。
SDK 入札のセキュア シグナルの共有を許可する
[配信] > [デマンド チャネルの設定] に移動します。[デフォルト設定] タブで、[SDK 入札] の [セキュア シグナルの共有を許可する] をオンにします。

[保存] をクリックします。
Meta の入札を設定する
[配信] > [入札者(ビッダー)] に移動し、[SDK 入札に移動] をクリックします。

[新しいビッダー] をクリックします。

ビッダーとして [Meta] を選択します。

[続行] をクリックして、このビッダーの SDK 入札を有効にします。

[完了] をクリックします。
広告ユニットのマッピングを設定する
[配信] > [入札者(ビッダー)] に移動し、[SDK 入札に移動] をクリックします。

Meta Audience Network の会社を選択します。

[広告ユニットのマッピング] タブに移動し、[新しい広告ユニットのマッピング] をクリックします。

[特定の広告ユニット] を選択します。広告ユニットと広告フォーマットを選択します。[広告枠のタイプ] として [モバイルアプリ] を選択し、対象のモバイルアプリを選択します。次に、前のセクションで取得したプレースメント ID を入力します。
アド マネージャーの管理画面でリワード インタースティシャル広告の広告ユニットのマッピングを設定する場合は、[リワード] フォーマットを選択し、リワード インタースティシャル プレースメント ID を使用します。
最後に [保存] をクリックします。

GDPR と米国の州規制の広告パートナー リストに Meta を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに Meta を追加します。
ステップ 3: Meta Audience Network の SDK とアダプタをインポートする
Android Studio の統合(推奨)
アプリレベルの Gradle ファイルに、次の実装依存関係と構成を追加します。
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") 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.24.0-beta02' 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' }
手動による統合
Meta Audience Network SDK for Android の最新バージョンをダウンロードします。
AudienceNetwork/binフォルダのAudienceNetwork.aarを展開して、プロジェクトに追加します。Google の Maven リポジトリで Meta Audience Network アダプタ アーティファクトに移動します。最新バージョンを選択し、Meta Audience Network アダプタの
.aarファイルをダウンロードして、プロジェクトに追加します。
ステップ 4: Meta Audience Network SDK にプライバシー設定を実装する
EU ユーザーからの同意と GDPR
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域(EEA)、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則(GDPR)の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
Meta は IAB Europe のグローバル ベンダー リスト(GVL)に登録されていません。代わりに、追加同意の技術仕様を使用する必要があります。詳しくは、追加の同意のコンポーネントをご覧ください。追加同意の仕様は、IAB ヨーロッパの透明性と同意に関するフレームワーク(TCF)バージョン 2 と連携して動作します。この仕様により、パブリッシャー様は、同意管理プラットフォーム(CMP)やパートナーとともに、Google の広告技術プロバイダ(ATP)リストに登録されているものの、IAB ヨーロッパの GVL にはまだ登録されていない企業について、補足的な同意シグナルを収集して送信できます。
GDPR と Meta 広告については、Meta のドキュメントのガイダンスに従ってください。
米国のプライバシー関連州法
米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています(用語は法律の定義に基づく)。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
カリフォルニア州在住のユーザーのデータ処理オプションについては、Meta のドキュメントのガイダンスに沿って対応してください。
ステップ 5: 必要なコードを追加する
Meta Audience Network の統合に、追加のコードは必要ありません。
ステップ 6: 実装をテストする
テスト広告を有効にする
アド マネージャー用のテストデバイスを登録し、Meta Audience Network の管理画面でテストモードを有効にしてください。
テスト広告を確認する
Meta Audience Network からテスト広告を受信していることを確認するには、Meta Audience Network(入札)の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能なステップ
ネイティブ広告
一部の Meta Audience Network ネイティブ広告アセットは、Google ネイティブ広告アセットに 1 対 1 でマッピングされません。このようなアセットは、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 のネイティブ バナー広告フォーマットを使用してください。
代わりに 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 でネイティブ広告のインプレッション数とクリック数が記録されるタイミングを示します。
| インプレッションの記録 | クリックの記録 |
|---|---|
| 画面上の 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 のドキュメントをご覧ください。 |