このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを介して Meta Audience Network の広告を読み込んで表示する方法について説明します。また、入札の統合についても説明します。ここでは、Meta Audience Network を広告ユニットのメディエーション構成に追加する方法と、Meta Audience Network とアダプターをアプリに統合する方法について説明します。 Unity
サポートされている統合と広告フォーマット
Meta Audience Network の AdMob メディエーション アダプタには、次の機能があります。
統合 | |
---|---|
単価設定 | |
ウォーターフォール 1 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 | |
リワード インタースティシャル |
1 2021 年に Meta Audience Network は入札のみになりました。
要件
- 最新の Google Mobile Ads SDK
- Unity 5.6 以降
- Meta Audience Network 用 Google モバイル広告メディエーション プラグイン 2.11.0(最新バージョンを推奨)
- Android にデプロイする場合:
- Android API レベル 21 以降
- iOS にデプロイするには
- iOS デプロイ ターゲットが 10.0 以降
- 通常、最新の Meta Audience Network SDK を使用するには、最新バージョンの Xcode が必要です。
- Google Mobile Ads SDK で構成された動作する Unity プロジェクト。詳しくは、スタートガイドをご覧ください。
- メディエーションのスタートガイドの手順を完了していること
ステップ 1: Meta Audience Network の UI で設定を行う
ビジネス マネージャーの開始ページに登録してログインします。
[始める]、[新しいアカウントを作成] の順にクリックします。
必須項目にビジネスの詳細を入力し、[次へ] をクリックします。
プロパティを作成する
必要な情報を入力すると、アプリのプロパティを作成するよう求められます。アプリのプロパティの名前を入力し、[次へ] をクリックします。
次に、収益化を行うプラットフォームを選択します。
アプリの詳細を追加し、[次へ] をクリックします。
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 とアダプターをインポートする
OpenUPM-CLI
OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Unity 用 Google モバイル広告 Meta Audience Network メディエーション プラグインをプロジェクトにインストールできます。
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
OpenUPM
Unity プロジェクト エディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager Settings を開きます。
[スコープ付きレジストリ] タブで、OpenUPM をスコープ付きレジストリとして追加し、次の詳細情報を指定します。
- 名前:
OpenUPM
- URL:
https://package.openupm.com
- スコープ:
com.google
次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウン メニューから [My Registries] を選択します。
[Google Mobile Ads Meta Audience Network Mediation] パッケージを選択して、[Install] をクリックします。
Unity パッケージ
変更ログのダウンロード リンクから Meta Audience Network 向け Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ZIP ファイルから GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
を抽出します。
Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
ファイルを探します。すべてのファイルのチェックボックスがオンになっていることを確認して、[インポート] をクリックします。
次に、[Assets] > [External Dependency Manager] > [Android Resolver] > [Force Resolve] を選択します。External Dependency Manager ライブラリは、依存関係の解決を最初から実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android
ディレクトリにコピーします。
ステップ 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 Unity メディエーション プラグインの変更ログ
バージョン 3.14.0
- Meta Audience Network Android アダプター バージョン 6.18.0.0 をサポートしています。
- Meta Audience Network iOS アダプター バージョン 6.16.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.3.0 でビルド、テストされています。
バージョン 3.13.1
- Meta Audience Network Android アダプター バージョン 6.18.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.15.2.1 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.3.0 でビルド、テストされています。
バージョン 3.13.0
- Meta Audience Network Android アダプター バージョン 6.18.0.0 をサポートしています。
- Meta Audience Network iOS アダプター バージョン 6.15.2.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.2.0 でビルド、テストされています。
バージョン 3.12.2
- Meta Audience Network Android アダプター バージョン 6.17.0.0 に対応しています。
- Meta Audience Network iOS アダプター バージョン 6.15.2.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.2.0 でビルド、テストされています。
バージョン 3.12.1
- Meta Audience Network Android アダプター バージョン 6.17.0.0 に対応しています。
- Meta Audience Network iOS アダプタ バージョン 6.15.1.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 3.12.0
- Meta Audience Network Android アダプター バージョン 6.17.0.0 に対応しています。
- Meta Audience Network iOS アダプタ バージョン 6.15.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 3.11.0
- Meta Audience Network Android アダプター バージョン 6.15.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.14.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 8.5.1 でビルド、テストされています。
バージョン 3.10.0
- アダプターのコンテンツを
GoogleMobileAds/Mediation/MetaAudienceNetwork/
に移動しました。 - Meta Audience Network Android アダプター バージョン 6.14.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.12.0.1 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 8.1.0 でビルド、テストされています。
バージョン 3.9.1
- Meta Audience Network Android アダプター バージョン 6.12.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.12.0.1 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 7.4.1 でビルド、テストされています。
バージョン 3.9.0
- Meta Audience Network Android アダプター バージョン 6.12.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.12.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 7.3.0 でビルド、テストされています。
バージョン 3.8.0
- Unity メディエーション プラグインの名前を「Meta Audience Network」に変更しました。
- Meta Audience Network Android アダプタ バージョン 6.11.0.1 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.11.1.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 7.0.2 でビルド、テストされています。
バージョン 3.7.0
- Meta Audience Network Android アダプター バージョン 6.10.0.0 に対応しています。
- Meta Audience Network iOS アダプター バージョン 6.10.0.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 7.0.0 でビルド、テスト済み。
バージョン 3.6.1
- Meta Audience Network Android アダプター バージョン 6.8.0.0 に対応。
- Meta Audience Network iOS アダプタ バージョン 6.9.0.1 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 7.0.0 でビルド、テスト済み。
バージョン 3.6.0
- Meta Audience Network Android アダプター バージョン 6.8.0.0 に対応。
- Meta Audience Network iOS アダプター バージョン 6.8.0.0 をサポートしています。
バージョン 3.5.0
- Meta Audience Network Android アダプター バージョン 6.7.0.0 に対応しています。
- Meta Audience Network iOS アダプタ バージョン 6.7.0.0 をサポートしています。
バージョン 3.4.0
- Meta Audience Network Android アダプター バージョン 6.6.0.0 に対応しています。
- Meta Audience Network iOS アダプター バージョン 6.6.0.0 をサポートしています。
バージョン 3.3.2
- Meta Audience Network Android アダプタ バージョン 6.5.1.1 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.5.1.0 をサポートしています。
バージョン 3.3.1
- Meta Audience Network Android アダプター バージョン 6.5.1.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.5.1.0 をサポートしています。
バージョン 3.3.0
- Meta Audience Network Android アダプター バージョン 6.4.0.0 に対応しています。
- Meta Audience Network iOS アダプタ バージョン 6.4.1.0 をサポートしています。
バージョン 3.2.0
- Meta Audience Network Android アダプタ バージョン 6.2.0.1 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 6.2.1.0 をサポート。
バージョン 3.1.0
- Meta Audience Network Android アダプター バージョン 6.2.0.0 をサポートしています。
- Meta Audience Network iOS アダプター バージョン 6.2.0.0 をサポートしています。
バージョン 3.0.0
- Meta Audience Network Android アダプター バージョン 6.1.0.0 をサポートしています。
- Meta Audience Network iOS アダプター バージョン 6.0.0.0 をサポートしています。
バージョン 2.12.0
- Meta Audience Network Android アダプタ バージョン 5.11.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.10.1.0 をサポートしています。
バージョン 2.11.1
- Meta Audience Network Android アダプタ バージョン 5.10.1.0 をサポート。
- Meta Audience Network iOS アダプタ バージョン 5.10.1.0 をサポートしています。
バージョン 2.11.0
- Meta Audience Network Android アダプタ バージョン 5.10.0.0 をサポートしています。
- Meta Audience Network iOS アダプター バージョン 5.10.0.0 をサポートしています。
バージョン 2.10.0
- Meta Audience Network Android アダプタ バージョン 5.9.1.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.9.0.1 をサポートしています。
バージョン 2.9.2
- Meta Audience Network Android アダプタ バージョン 5.9.0.2 に対応しています。
- Meta Audience Network iOS アダプタ バージョン 5.9.0.1 をサポートしています。
バージョン 2.9.1
- Meta Audience Network Android アダプタ バージョン 5.9.0.1 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.9.0.1 をサポートしています。
バージョン 2.9.0
- Meta Audience Network Android アダプタ バージョン 5.9.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.9.0.0 をサポートしています。
バージョン 2.8.1
- Meta Audience Network Android アダプタ バージョン 5.8.0.1 をサポートしています。
- Meta Audience Network iOS アダプター バージョン 5.8.0.2 をサポートしています。
バージョン 2.8.0
- Meta Audience Network Android アダプター バージョン 5.8.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.8.0.1 をサポートしています。
バージョン 2.7.1(非推奨、2.8.0 以降を使用してください)
- Meta Audience Network Android アダプタ バージョン 5.7.1.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.7.1.1 に対応しています。
バージョン 2.7.0(非推奨、2.8.0 以降を使用してください)
- Meta Audience Network Android アダプター バージョン 5.7.0.0 に対応しています。
- Meta Audience Network iOS アダプタ バージョン 5.7.0.0 をサポートしています。
バージョン 2.6.1(非推奨、2.8.0 以降を使用してください)
- Meta Audience Network Android アダプタ バージョン 5.6.1.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.6.1.0 をサポートしています。
バージョン 2.6.0
- Meta Audience Network Android アダプター バージョン 5.6.0.0 をサポートしています。
- Meta Audience Network iOS アダプタ バージョン 5.6.0.0 をサポートしています。
バージョン 2.5.1
- Facebook Android アダプター バージョン 5.5.0.0 をサポート。
- Facebook iOS アダプター バージョン 5.5.1.0 をサポート。
バージョン 2.5.0
- Facebook Android アダプター バージョン 5.5.0.0 をサポート。
- Facebook iOS アダプター バージョン 5.5.0.0 をサポートしています。
バージョン 2.4.1
- Facebook Android アダプター バージョン 5.4.1.1 をサポート。
- Facebook iOS アダプター バージョン 5.4.0.0 をサポートしています。
バージョン 2.4.0
- Facebook Android アダプター バージョン 5.4.0.0 をサポート。
- Facebook iOS アダプター バージョン 5.4.0.0 をサポートしています。
バージョン 2.3.2
- Facebook Android アダプター バージョン 5.3.1.2 をサポート。
- Facebook iOS アダプター バージョン 5.3.2.0 をサポート。
バージョン 2.3.1
- Facebook Android アダプター バージョン 5.3.1.0 をサポート。
- Facebook iOS アダプター バージョン 5.3.2.0 をサポート。
バージョン 2.3.0
- Facebook Android アダプター バージョン 5.3.0.0 をサポート。
- Facebook iOS アダプター バージョン 5.3.0.0 をサポートしています。
バージョン 2.2.0
- 新しいオープンベータ版の Rewarded API をサポートするようにプラグインを更新しました。
- Facebook Android アダプター バージョン 5.2.0.1 をサポート。
- Facebook iOS アダプター バージョン 5.2.0.1 をサポートしています。
バージョン 2.1.1
- Facebook Android アダプター バージョン 5.1.0.1 をサポート。
- Facebook iOS アダプター バージョン 5.1.0.0 をサポートしています。
バージョン 2.1.0
- Facebook Android アダプター バージョン 5.1.0.0 をサポート。
- Facebook iOS アダプター バージョン 5.1.0.0 をサポートしています。
バージョン 2.0.0
- Facebook Android アダプター バージョン 5.0.1.0 をサポート。
- Facebook iOS アダプター バージョン 5.0.1.0 をサポートしています。
バージョン 1.2.1
- Facebook Android アダプター バージョン 4.99.3.0 をサポート。
- Facebook iOS アダプター バージョン 4.99.3.0 をサポートしています。
バージョン 1.2.0
- Facebook Android アダプター バージョン 4.99.1.1 をサポートしています。
- Facebook iOS アダプター バージョン 4.99.2.0 をサポートしています。
バージョン 1.1.3
- Facebook Android アダプター バージョン 4.28.2.1 をサポート。
- Facebook iOS アダプター バージョン 4.28.1.2 をサポート。
バージョン 1.1.2
- Unity Ads Unity メディエーション プラグインとの競合の可能性を修正しました。
バージョン 1.1.1
- Facebook Android アダプタ バージョン 4.28.2.0 をサポートしています。
- Facebook iOS アダプター バージョン 4.28.1.1 をサポート。
バージョン 1.1.0
- Facebook Android SDK バージョン 4.28.1 をサポートしています。
- Facebook iOS SDK バージョン 4.28.1 をサポートしています。
バージョン 1.0.0
- 初回リリースです。
- Facebook Android SDK バージョン 4.27.0 をサポートしています。
- Facebook iOS SDK バージョン 4.27.1 をサポートしています。