このページは Cloud Translation API によって翻訳されました。

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

このガイドでは、Google Mobile Ads SDK を使用して AdMob メディエーションで 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: AdMob の管理画面で DT Exchange デマンドを設定する

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

広告ユニットのメディエーション設定に DT Exchange を追加する必要があります。

まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更する既存のメディエーショングループがある場合は、そのメディエーショングループの名前をクリックして編集し、DT Exchange を広告ソースとして追加するに進みます。

新しいメディエーショングループを作成するには、[メディエーショングループを作成] を選択します。

広告フォーマットとプラットフォームを入力し、[続行] をクリックします。

メディエーショングループに名前を付け、ターゲットとする地域を選択します。次に、メディエーショングループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーショングループを、既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。

選択した広告ユニットが広告ユニットカードに表示されます。

DT Exchange を広告ソースとして追加する

[広告ソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。[DT Exchange] を選択します。

[DT Exchange] を選択し、[最適化] スイッチをオンにします。前のセクションで取得したパブリッシャー ID、コンシューマシークレット、コンシューマキーを入力して、DT Exchange の広告ソースの最適化を設定します。次に、DT Exchange の eCPM 値を入力し、[続行] をクリックします。

DT Exchange のマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。

次に、前のセクションで取得したアプリケーション ID とプレースメント ID を入力します。[完了] をクリックします。

注: 広告ソースの最適化では、メディエーションネットワークの eCPM を正確に計算するのに十分なデータが収集されるまでに数日かかります。最適化が完了するまでの間、広告ソースの最適化ステータスは PENDING になります。このため、ネットワークの eCPM 値を手動で設定する必要があります。eCPM を計算できるようになると、広告ソースが自動的に eCPM の更新を開始します。

GDPR と米国の州規制の広告パートナーリストに DT Exchange（Fyber 収益化）を追加

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

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

Android Studio との統合（推奨）

アプリレベルの 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.3.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 にプライバシー設定を実装する

EU ユーザーの同意と GDPR

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 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーションチェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーションチェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。

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	AdMob 管理画面で設定された DT Exchange サーバーパラメータが存在しないか、無効です。
103	リクエストされた広告サイズが、DT Exchange でサポートされているバナーサイズと一致しません。
105	DT Exchange SDK が広告を読み込みましたが、予期しないコントローラを返しました。
106	広告を表示する準備ができていません。
200-399	DT Exchange SDK がエラーを返しました。詳しくは、コードをご覧ください。

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

バージョン 8.3.3.0

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

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

Google Mobile Ads SDK バージョン 23.5.0。
DT Exchange SDK バージョン 8.3.3。

バージョン 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

compileSdkVersion と targetSdkVersion を 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。

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

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

要件

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

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

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

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

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

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

DT Exchange を広告ソースとして追加する

GDPR と米国の州規制の広告パートナー リストに DT Exchange（Fyber 収益化）を追加

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

Android Studio との統合（推奨）

手動による統合

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

EU ユーザーの同意と GDPR

Java

Kotlin

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

Java

Kotlin

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

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

テスト広告を有効にする

テスト広告を確認する

省略可能なステップ

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

Java

Kotlin

エラーコード

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

バージョン 8.3.3.0

バージョン 8.3.2.0

バージョン 8.3.1.0

バージョン 8.3.0.0

バージョン 8.2.7.0

バージョン 8.2.6.1

バージョン 8.2.6.0

バージョン 8.2.5.0

バージョン 8.2.4.0

バージョン 8.2.3.0

バージョン 8.2.2.1

バージョン 8.2.2.0

バージョン 8.2.1.0

バージョン 8.2.0.0

バージョン 8.1.5.0

バージョン 8.1.4.0

バージョン 8.1.3.1

バージョン 8.1.3.0

バージョン 8.1.2.0

バージョン 8.1.0.0

バージョン 7.8.4.1

バージョン 7.8.4.0

バージョン 7.8.3.0

バージョン 7.8.2.0

バージョン 7.8.1.0

バージョン 7.8.0.0

バージョン 7.7.4.0

バージョン 7.7.3.0

バージョン 7.7.2.0

バージョン 7.7.1.0

バージョン 7.7.0.0

バージョン 7.6.1.0

バージョン 7.6.0.0

バージョン 7.5.4.0

バージョン 7.5.3.0

バージョン 7.5.2.0

バージョン 7.5.0.0

バージョン 7.4.1.0

バージョン 7.3.4.0

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

GDPR と米国の州規制の広告パートナーリストに DT Exchange（Fyber 収益化）を追加

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