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

{10. {10 。

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

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

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

統合
単価設定
フォーマット
バナー
インタースティシャル
特典
ネイティブ

要件

  • Android API レベル 21 以降
  • 最新の Google Mobile Ads SDK

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

ステップ 1: DT Exchange UI で設定を行う

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

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

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

アプリを管理する

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

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

セットアップ

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

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

メニュー

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

App ID

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

プレースメント ID

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

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

ユーザー プロフィール メニュー

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

ユーザー プロフィール

ステップ 2: Ad Manager UI で DT Exchange デマンドを設定する

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

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

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

アプリレベルの build.gradle.kts ファイルで、次の実装依存関係と構成を追加します。DT Exchange SDK とアダプタの最新バージョンを使用します。

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:fyber:8.3.2.0")
}

手動による統合

  • DT Exchange SDK for Android の最新バージョンをダウンロードし、次のファイルをプロジェクトに追加します。
    • ia-mraid-kit-release-x.y.z.aar
    • ia-sdk-core-release-x.y.z.aar
    • ia-video-kit-release-x.y.z.aar
  • Google の Maven リポジトリで DT Exchange アダプタ アーティファクトに移動します。最新バージョンを選択し、DT Exchange アダプターの .aar ファイルをダウンロードしてプロジェクトに追加します。

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

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

DT Exchange には、ユーザーの同意を SDK に転送できる API が含まれています。次のサンプルコードは、同意情報を DT Exchange SDK に手動で渡す方法を示しています。同意情報を DT Exchange SDK に手動で渡す場合は、Google Mobile Ads SDK で広告をリクエストする前にこのコードを呼び出すことをおすすめします。

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

詳細とメソッドで指定可能な値については、DT Exchange の GDPR リソースページGDPR 実装ガイド をご覧ください。

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

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

DT Exchange には、ユーザーの同意を SDK に転送できる API が含まれています。次のサンプルコードは、同意情報を DT Exchange SDK に手動で渡す方法を示しています。同意情報を DT Exchange SDK に手動で渡す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に、このコードを呼び出すことをおすすめします。

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

詳細と、このメソッドで指定できる値については、DT Exchange の CCPA リソース ページと、 CCPA 実装ガイド をご覧ください。

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

DT Exchange を統合するために追加のコードは必要ありません。

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

テスト広告を有効にする

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

テスト広告を確認する

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

省略可能なステップ

ネットワーク固有のパラメータ

DT Exchange アダプターは、Android Bundle としてアダプターに渡すことができる追加のリクエスト パラメータをサポートしています。アダプタは、バンドル内で次のキーを検索します。

リクエスト パラメータと値
InneractiveMediationDefs.KEY_AGE 整数。ユーザーの年齢
FyberMediationAdapter.KEY_MUTE_VIDEO Boolean。動画をミュートする、ミュートを解除する

これらの広告リクエスト パラメータを設定するコードの例を次に示します。

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
   .build();

Kotlin

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
   .build()

エラーコード

アダプターが DT Exchange から広告を受信できない場合は、 ResponseInfo.getAdapterResponses() 次のクラスで、広告レスポンスから根本的なエラーを確認できます。

com.google.ads.mediation.fyber.FyberMediationAdapter

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

エラーコード 理由
101 Ad Manager UI で構成された DT Exchange サーバー パラメータが欠落しているか、無効です。
103 リクエストされた広告サイズが DT Exchange でサポートされているバナーサイズと一致しません。
105 DT Exchange SDK が広告を読み込みましたが、予期しないコントローラを返しました。
106 広告を表示する準備ができていません。
200-399 DT Exchange SDK がエラーを返しました。詳しくは、コードをご覧ください。

DT Exchange Android メディエーション アダプタの変更履歴

バージョン 8.3.2.0

  • DT Exchange SDK 8.3.2 との互換性が確認されました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 23.4.0.
  • DT Exchange SDK バージョン 8.3.2。

バージョン 8.3.1.0

  • DT Exchange SDK 8.3.1 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.3.0。
  • DT Exchange SDK バージョン 8.3.1.

バージョン 8.3.0.0

  • Google Mobile Ads SDK のバージョンを DT Exchange SDK に渡すためのサポートを追加しました。
  • DT Exchange SDK 8.3.0 との互換性を確認しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 23.2.0。
  • DT Exchange SDK バージョン 8.3.0。

バージョン 8.2.7.0

  • DT Exchange SDK 8.2.7 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 23.0.0。
  • DT Exchange SDK バージョン 8.2.7。

バージョン 8.2.6.1

  • 最低限必要な Google Mobile Ads SDK のバージョンを 23.0.0 に更新しました。
  • DT Exchange SDK 8.2.6 との互換性が確認されました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 23.0.0 にアップデートします。
  • DT Exchange SDK バージョン 8.2.6。

バージョン 8.2.6.0

  • DT Exchange SDK 8.2.6 との互換性を検証済み

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.6.0。
  • DT Exchange SDK バージョン 8.2.6.

バージョン 8.2.5.0

  • DT Exchange SDK 8.2.5 との互換性を検証済み

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.5.0。
  • DT Exchange SDK バージョン 8.2.5。

バージョン 8.2.4.0

  • DT Exchange SDK 8.2.4 との互換性が確認されました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 22.3.0。
  • DT Exchange SDK バージョン 8.2.4。

バージョン 8.2.3.0

  • 新しい VersionInfo クラスを使用するようにアダプターを更新しました。
  • 必須の Google Mobile Ads SDK バージョンを 22.0.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 22.0.0。
  • DT Exchange SDK バージョン 8.2.3。

バージョン 8.2.2.1

  • インタースティシャル広告を非表示にするためにメディエーション エクストラで muteVideo キーを渡すためのサポートを追加しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 21.5.0.
  • DT Exchange SDK バージョン 8.2.2.

バージョン 8.2.2.0

  • DT Exchange SDK 8.2.2 との互換性が確認されました。
  • 必要最小限の Google Mobile Ads SDK バージョンを 21.5.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 21.5.0.
  • DT Exchange SDK バージョン 8.2.2.

バージョン 8.2.1.0

  • アダプター名を「DT Exchange」に変更しました。
  • DT Exchange SDK 8.2.1 との互換性が確認されました。
  • 必須の Google Mobile Ads SDK バージョンを 21.3.0 に更新しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 21.3.0.
  • DT Exchange SDK バージョン 8.2.1。

バージョン 8.2.0.0

  • Fyber SDK 8.2.0 との互換性を確認しました。
  • 必要最小限の Google Mobile Ads SDK バージョンを 21.1.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 21.1.0。
  • Fyber SDK バージョン 8.2.0。

バージョン 8.1.5.0

  • Fyber SDK 8.1.5 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 21.0.0。
  • Fyber SDK バージョン 8.1.5。

バージョン 8.1.4.0

  • Fyber SDK 8.1.4 との互換性が確認されました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 21.0.0.
  • Fyber SDK バージョン 8.1.4.

バージョン 8.1.3.1

  • compileSdkVersiontargetSdkVersion を API 31 に更新しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 21.0.0 に更新しました。
  • 必要最小限の Android API レベルを 19 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 21.0.0。
  • Fyber SDK バージョン 8.1.3。

バージョン 8.1.3.0

  • Fyber SDK 8.1.3 との互換性が確認されました。
  • 必須となる Google Mobile Ads SDK のバージョンを 20.6.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 20.6.0.
  • Fyber SDK バージョン 8.1.3。

バージョン 8.1.2.0

  • Fyber SDK 8.1.2 との互換性が確認されました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 20.5.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 20.5.0.
  • Fyber SDK バージョン 8.1.2。

バージョン 8.1.0.0

  • Fyber SDK 8.1.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 20.4.0。
  • Fyber SDK バージョン 8.1.0。

バージョン 7.8.4.1

  • メディエーション構成に重複するアプリ ID または複数の一意のアプリ ID が存在する場合にアダプタが初期化されない問題を修正しました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 20.4.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 20.4.0。
  • Fyber SDK バージョン 7.8.4。

バージョン 7.8.4.0

  • Fyber SDK 7.8.4 との互換性を検証済み
  • 必要最小限の Google Mobile Ads SDK バージョンを 20.3.0 に更新しました。
  • onVideoComplete() が呼び出されないリワード ディスプレイ広告の問題を修正しました。
  • Fyber で広告を表示するには、アクティビティ コンテキストが必要になりました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 20.3.0.
  • Fyber SDK バージョン 7.8.4。

バージョン 7.8.3.0

  • Fyber SDK 7.8.3 との互換性が確認されました。
  • 標準化されたアダプタのエラーコードとメッセージを追加しました。
  • 必要最小限の Google Mobile Ads SDK バージョンを 20.1.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 20.1.0。
  • Fyber SDK バージョン 7.8.3。

バージョン 7.8.2.0

  • Fyber SDK 7.8.2 との互換性を確認しました。
  • 必要最小限の Google Mobile Ads SDK バージョンを 20.0.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 20.0.0 にアップデートします。
  • Fyber SDK バージョン 7.8.2。

バージョン 7.8.1.0

  • Fyber SDK 7.8.1 との互換性が確認されました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.7.0。
  • Fyber SDK バージョン 7.8.1.

バージョン 7.8.0.0

  • Fyber SDK 7.8.0 との互換性を確認しました。
  • 必要最小限の Google Mobile Ads SDK バージョンを 19.7.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.7.0。
  • Fyber SDK バージョン 7.8.0。

バージョン 7.7.4.0

  • Fyber SDK 7.7.4 との互換性が確認されました。
  • リワード広告で onUserEarnedReward() が 2 回転送される問題を修正しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.5.0。
  • Fyber SDK バージョン 7.7.4。

バージョン 7.7.3.0

  • Fyber SDK 7.7.3 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.5.0。
  • Fyber SDK バージョン 7.7.3。

バージョン 7.7.2.0

  • Fyber SDK 7.7.2 との互換性を確認しました。
  • 必須となる Google Mobile Ads SDK のバージョンを 19.5.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.5.0。
  • Fyber SDK バージョン 7.7.2。

バージョン 7.7.1.0

  • Fyber SDK 7.7.1 との互換性が確認されました。
  • 最低限必要な Google Mobile Ads SDK のバージョンを 19.4.0 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.4.0。
  • Fyber SDK バージョン 7.7.1.

バージョン 7.7.0.0

  • Fyber SDK 7.7.0 との互換性を確認しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.3.0。
  • Fyber SDK バージョン 7.7.0.

バージョン 7.6.1.0

  • Fyber SDK 7.6.1 との互換性を検証済み

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.3.0.
  • Fyber SDK バージョン 7.6.1.

バージョン 7.6.0.0

  • Fyber SDK 7.6.0 との互換性を確認しました。
  • インライン アダプティブ バナー リクエストをサポートするようにアダプタを更新しました。
  • 必要な最小バージョンの Google Mobile Ads SDK を 19.3.0 に更新しました。
  • バナー広告で onAdOpened() メソッドと onAdClosed() メソッドが呼び出されなかったバグを修正しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.3.0。
  • Fyber SDK バージョン 7.6.0。

バージョン 7.5.4.0

  • Fyber SDK 7.5.4 との互換性を検証済み
  • 必須となる Google Mobile Ads SDK のバージョンを 19.1.0 に更新しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 19.1.0。
  • Fyber SDK バージョン 7.5.4。

バージョン 7.5.3.0

  • Fyber SDK 7.5.3 との互換性を検証しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.0.1。
  • Fyber SDK バージョン 7.5.3。

バージョン 7.5.2.0

  • Fyber SDK 7.5.2 との互換性を検証済み
  • 必要な最小バージョンの Google Mobile Ads SDK を 19.0.1 に更新しました。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 19.0.1。
  • Fyber SDK バージョン 7.5.2。

バージョン 7.5.0.0

  • Fyber SDK 7.5.0 との互換性が確認されました。
  • Fyber 広告の読み込み中に発生する NullPointerException クラッシュを修正しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 18.3.0。
  • Fyber SDK バージョン 7.5.0.

バージョン 7.4.1.0

  • Fyber SDK 7.4.1 との互換性を検証済み
  • 必要最小限の Google Mobile Ads SDK バージョンを 18.3.0 に更新しました。

以下を使用してビルドとテストを行う:

  • Google Mobile Ads SDK バージョン 18.3.0。
  • Fyber SDK バージョン 7.4.1。

バージョン 7.3.4.0

  • 初回リリース
  • バナー広告、インタースティシャル広告、リワード広告に対応しています。

構築およびテストに使用したバージョン:

  • Google Mobile Ads SDK バージョン 18.2.0。
  • Fyber SDK バージョン 7.3.4.