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

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

このガイドでは、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 コンソールに登録またはログインします。

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

アプリを管理する

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

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

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

左ナビゲーションバーにカーソルを合わせ、開きます。左側のメニューで [アプリ] をクリックします。

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

App ID

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

プレースメント ID

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

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

[Publisher ID]、[Consumer Key]、[Consumer Secret] は次のステップで必要になるため、メモしておきます。

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

広告ユニットのメディエーション設定を行う

アドマネージャーアカウントにログインします。

[配信] > [収益グループ] に移動して、[新しい収益グループ] ボタンをクリックします。

収益グループの一意の名前を入力し、[ステータス] を [有効] に設定して [広告フォーマット] を選択し、[広告枠のタイプ] を [モバイルアプリ] に設定します。[ターゲティング] > [広告枠] で、[広告枠] と [モバイルアプリケーション] でメディエーションを追加する広告ユニットを選択します。

次に、[収益パートナーを追加] ボタンをクリックします。

「DT Exchange」の収益パートナーがすでにある場合は、そのパートナーを選択できます。それ以外の場合は、[新しい収益パートナーを作成] を選択します。

[広告ネットワーク] として DT Exchange を選択し、固有の名前を入力して [メディエーション] を有効にします。

[自動データ収集] をオンにして、前のセクションで取得したPublisher ID, Consumer Secret and Consumer Key を入力します。

[収益パートナー] を選択したら、[統合タイプ] として [モバイル SDK メディエーション]、[プラットフォーム] として [Android]、[ステータス] として [有効] を選択します。前のセクションで取得したApplication ID and Placement ID を入力します。[デフォルト CPM] の値を入力します。

完了したら、ページの下部にある [保存] をクリックします。

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

GDPR 設定米国の州規制の設定の手順に沿って、 Ad Manager UI の GDPR および米国の州規制の広告パートナーのリストに Fyber を追加します。

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

Android Studio の統合（推奨）

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:fyber:8.2.7.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 広告配信で制限付きデータ処理を有効にすることができますが、メディエーションチェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に参加する可能性があるメディエーションチェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに従ってコンプライアンスを確保する必要があります。

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: 実装をテストする

テスト広告を有効にする

Ad Manager。

テスト広告を確認する

DT Exchangeからテスト広告を受信していることを確認するには、広告インスペクタで DT Exchange (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。

省略可能なステップ

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

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	UI に設定されている DT Exchange サーバーパラメータがないか、無効です。 Ad Manager
103	リクエストされた広告サイズが、DT Exchange でサポートされているバナーサイズと一致しません。
105	DT Exchange SDK が広告を読み込みましたが、予期しないコントローラが返されました。
106	広告を表示する準備ができていません。
200-399	DT Exchange SDK からエラーが返されました。詳しくは、コードをご覧ください。
0-10	DT Exchange SDK からエラーが返されました。詳しくは、ドキュメントをご覧ください。
101	UI に設定されている DT Exchange サーバーパラメータがないか、無効です。 Ad Manager
102	リクエストされた広告サイズが、DT Exchange でサポートされているバナーサイズと一致しません。
103	広告オブジェクトはすでに使用されているため、広告を表示できませんでした。
104	広告の準備ができていないため、DT Exchange 広告を表示できませんでした。
105	DT Exchange SDK から初期化エラーが返されました。

DT Exchange Android メディエーションアダプタに関する変更履歴

次のバージョン:

MobileAds のバージョンを DT Exchange SDK に渡します。

バージョン 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 がある場合に、アダプタが初期化されない問題を修正しました。
最低限必要な 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 で広告を表示するには、Activity コンテキストが必要になりました。

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

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: 管理画面で DT Exchange デマンドを設定する Ad Manager

広告ユニットのメディエーション設定を行う

GDPR と米国の州規制の広告パートナー リストに 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.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 と米国の州規制の広告パートナーリストに Fyber 追加

DT Exchange Android メディエーションアダプタに関する変更履歴