このガイドでは、Google Mobile Ads SDK を使用し、入札の統合を含め、メディエーションを使用して Meta Audience Network から広告を読み込んで表示する方法を説明します。Meta オーディエンス ネットワークを広告ユニットのメディエーション設定に追加する方法と、Meta オーディエンス ネットワークとアダプターを 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 の UI で設定を行う
ビジネス マネージャーのスタートページに登録してログインします。
[開始]、[新しいアカウントを作成] の順にクリックします。
必須項目にビジネスの詳細を入力し、[次へ] をクリックします。
プロパティを作成する
必要な情報を入力すると、アプリのプロパティを作成するように求められます。アプリのプロパティ名を入力して、[Next] をクリックします。
次に、収益化するプラットフォームを選択します。
アプリの詳細を追加して、[Next] をクリックします。
Android
iOS
[新しいお支払いアカウントを追加] をクリックしてお支払いアカウントを設定します。新しいページにリダイレクトされ、お支払い情報を入力します。必要な情報を入力して [次へ] をクリックします。
[メディエーション プラットフォーム] として [Google AdMob] を選択し、[プレースメントを作成] をクリックします。
形式を選択してフォームに記入し、[作成] をクリックします。
[プレースメント ID] をメモしておきます。
[完了] をクリックします。
テストモードをオンにする
Meta Audience Network のテスト広告を有効にする詳しい手順については、オーディエンス ネットワークのテスト実装ガイドをご覧ください。
ステップ 2: UI で Meta オーディエンス ネットワークの需要を設定する AdMob
広告ユニットのメディエーション設定を行う
GDPR と米国の州規制の広告パートナーのリストに Facebook 追加
GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の GDPR および米国の州規制の広告パートナーのリストに Facebook を追加します。
ステップ 3: Meta Audience Network SDK とアダプタをインポートする
pub.dev による統合
パッケージの pubspec.yaml
ファイルに、Meta Audience Network SDK とアダプタの最新バージョンとともに次の依存関係を追加します。
dependencies:
gma_mediation_meta: ^1.0.0
手動統合
Meta Audience Network の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを抽出し、抽出したプラグイン フォルダ(とその内容)を Flutter プロジェクトに追加します。次に、pubspec.yaml
ファイルで次の依存関係を追加して、プラグインを参照します。
dependencies:
gma_mediation_meta:
path: path/to/local/package
ステップ 4: Meta Audience Network SDK にプライバシー設定を実装する
EU ユーザーの同意と GDPR
Google の EU ユーザーの同意ポリシーに基づき、デベロッパーは、欧州経済領域(EEA)のユーザーに対して、デバイス識別子と個人データの使用に関して特定の開示を行い、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則(GDPR)の要件が反映されています。同意を求める際は、個人データを収集、受信、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、同意に関するユーザーの選択をこのようなネットワークに自動的に渡すことはできません。
GDPR と Meta の広告について詳しくは、Meta のガイダンスをご覧ください。
米国のプライバシー関連州法
米国のプライバシー関連州法 「個人情報」の「販売」は、法律で定められているとおり、オプトアウトする権利をユーザーに提供することが義務付けられています。オプトアウトするには、「販売」当事者のホームページに目立つ [個人情報を第三者に売却しない] リンクがあります。米国のプライバシー関連州法の遵守ガイドでは、Google の広告配信について制限付きデータ処理を有効にすることができますが、Google がメディエーション チェーンの各広告ネットワークにこの設定を適用することはできません。したがって、個人情報の販売に参加する可能性のあるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってポリシーに準拠する必要があります。
カリフォルニア州のユーザーの場合は、Meta のデータ処理オプションを確認してください。
ステップ 5: 必要なコードを追加する
Android
Meta Audience Network の統合には追加のコードは必要ありません。
iOS
SKAdNetwork との統合
Meta Audience Network のドキュメントに沿って、プロジェクトの Info.plist
ファイルに SKAdNetwork ID を追加します。
広告トラッキングが有効
iOS 14 以降向けに作成している場合は、Meta Audience Network の広告トラッキング フラグの設定方法を確認してください。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob にテストデバイスを登録し、 Meta Audience Network UI でテストモードを有効にします。
テスト広告を確認する
Meta Audience Networkからテスト広告を受信していることを確認するには、広告インスペクタで Meta Audience Network (Bidding) 広告ソースを使用して単独の広告ソースのテストを有効にします。
省略可能なステップ
Android 9 でのキャッシュ保存
Android
Android 9(API レベル 28)以降では、クリアテキストのサポートがデフォルトで無効になっています。これは、Meta Audience Network SDK のメディア キャッシュ機能に影響し、ユーザー エクスペリエンスと広告収入に影響する可能性があります。Meta のドキュメントに沿って、アプリのネットワーク セキュリティ構成を更新します。
iOS
iOS との統合には適用されません。
エラーコード
アダプタが Audience Network から広告を受信できない場合は、次のクラスの 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 オーディエンス ネットワークが 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 オーディエンス ネットワークが SDK 固有のエラーを返しました。詳しくは、Meta Audience Network のドキュメントをご覧ください。 |
Meta Audience Network Flutter メディエーション アダプタ変更履歴
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 でビルドおよびテストされています。