DT Exchange をメディエーションと統合する

このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを活用し、ウォーターフォール統合で DT Exchange から広告を読み込んで表示する方法について説明します。ここでは、広告ユニットのメディエーション構成に DT Exchange を追加する方法と、DT Exchange SDK とアダプターを Flutter アプリに統合する方法について説明します。

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

DT Exchange 用の Flutter メディエーション アダプタには、次の機能があります。

要件

• 最新の Google Mobile Ads SDK
• Flutter 3.7.0 以降
• Android にデプロイするには
  • Android API レベル 21 以降
• iOS にデプロイするには
  • iOS デプロイ ターゲットが 12.0 以降
• Google Mobile Ads SDK で構成された動作する Flutter プロジェクト。詳細については、スタートガイドをご覧ください。
• メディエーションのスタートガイドを完了していること

ステップ 1: DT Exchange UI で構成を設定する

新しいアプリと広告プレースメントを追加する

DT Exchange Console に登録するか、ログインします。

[アプリを追加] ボタンをクリックしてアプリを追加します。

プラットフォームを選択し、フォームの残りの項目を入力して、[プレースメントを追加] をクリックします。

[プレースメントに名前を付ける] というラベルの付いたフィールドに新しいプレースメントの名前を入力し、プルダウン リストから目的のプレースメント タイプを選択します。最後に、[プレースメントを保存] をクリックします。

アプリ ID とプレースメント ID

左側のナビゲーション バーにマウスカーソルを合わせると、そのバーが開きます。次に、左側のメニューから [アプリ] をクリックします。

[アプリ管理] ページで、アプリの横にあるアプリ ID をメモします。

アプリを選択して [プレースメント] タブに移動し、[プレースメント名] の横にあるコピーアイコンをクリックします。プレースメント ID をメモしておきます。

パブリッシャー ID、コンシューマ キー、コンシューマ シークレット

左側のメニューでユーザー名をクリックし、[ユーザー プロフィール] を選択します。

パブリッシャー ID、コンシューマ キー、コンシューマ シークレットをメモしておきます。これらは次のステップで必要になります。

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

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

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

GDPR 設定と米国の州規制の設定の手順に沿って、AdMob 管理画面の GDPR と米国の州規制の広告パートナー リストに DT Exchange（Fyber 収益化）を追加します。

ステップ 3: DT Exchange SDK とアダプターをインポートする

pub.dev による統合

パッケージの pubspec.yaml ファイルに、最新バージョンの DT Exchange SDK とアダプタを含む次の依存関係を追加します。

dependencies:
  gma_mediation_dtexchange: ^1.0.0

手動による統合

DT Exchange 用の Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（とその内容）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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

EU の同意と GDPR

Google の EU ユーザーの同意ポリシーに基づき、デバイス ID と個人データの使用について、欧州経済領域（EEA）のユーザーに対して特定の情報を開示し、同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受領、または使用する可能性があるメディエーション チェーン内の各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。

DT Exchange 用の Google Mobile Ads メディエーション プラグインは、DT Exchange SDK への同意情報の渡しをサポートしていません。

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

米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。

DT Exchange 用の Google Mobile Ads メディエーション プラグインは、DT Exchange SDK への同意情報の渡しをサポートしていません。

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

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

テスト広告を有効にする

AdMob 用にテストデバイスを登録してください。

テスト広告を確認する

DT Exchange からテスト広告が配信されていることを確認するには、広告インスペクタで DT Exchange（ウォーターフォール）広告ソースを使用して単一の広告ソースのテストを有効にします。

エラーコード

アダプターが DT Exchange から広告を受信できない場合、パブリッシャーは次のクラスの ResponseInfo を使用して、広告レスポンスの根本的なエラーを確認できます。

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

広告の読み込みに失敗したときに DT Exchange アダプタによってスローされるコードとそれに付随するメッセージは次のとおりです。

DT Exchange Flutter メディエーション アダプタの変更ログ

次のバージョン

• Google Mobile Ads Flutter プラグイン バージョン 5.2.0 でビルド、テスト済み。

1.1.0

• DT Exchange Android アダプター バージョン 8.3.0.0 との互換性が確認されました。
• DT Exchange iOS アダプター バージョン 8.3.1.0 との互換性が確認されました。
• Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テスト済み。

1.0.0

• 初回リリース。
• DT Exchange Android アダプター バージョン 8.2.7.0 との互換性が確認されました。
• DT Exchange iOS アダプター バージョン 8.2.8.0 との互換性が確認されました。
• Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テスト済み。