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

このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 を使用した DT Exchange の広告 AdMob メディエーション ウォーターフォール統合に対応しています広告に DT Exchange を追加する方法について説明します。 メディエーション設定、DT Exchange SDK と アプリへの Android 変換も可能。

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

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

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

要件

  • Android API レベル 21 以降

ステップ 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 デマンドを設定する AdMob

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

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

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

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

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

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

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

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

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

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

[DT Exchange] を選択して、[最適化] スイッチを有効にします。前のセクションで取得した Publisher ID, Consumer Secret and Consumer Keyを入力して、DT Exchangeの広告ソースの最適化を設定します。 次に、DT Exchange の eCPM の値を入力し、[続行] をクリックします。

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

次に、前のセクションで取得した Application ID and Placement IDを入力します。[完了] をクリックします。

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

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

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

アプリレベルの 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: プロジェクトに追加します。 <ph type="x-smartling-placeholder">
      </ph>
    • ia-mraid-kit-release-x.y.z.aar
    • ia-sdk-core-release-x.y.z.aar
    • ia-video-kit-release-x.y.z.aar
  • [ DT Exchange アダプターのアーティファクト Google の Maven リポジトリにあります最新バージョンを選択し、DT をダウンロードします。 Exchange アダプターの .aar ファイルを開き、プロジェクトに追加します。

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

Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID と個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則(GDPR)。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google は ユーザーの同意に関する選択をこうしたネットワークに自動的に渡す。

DT Exchange には、ユーザーの同意を SDK に転送できる API が含まれています。「 次のサンプルコードは、同意情報を DT Exchange に渡す方法を示しています。 手動で実行することもできます。同意情報を DT Exchange に渡す場合 広告をリクエストする前にこのコードを呼び出すことをおすすめします 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 実装ガイド を参照してください。

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

米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトする「個人情報」を(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドに用意されている 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

DT Exchange には、ユーザーの同意を SDK に転送できる API が含まれています。「 次のサンプルコードは、同意情報を DT Exchange に渡す方法を示しています。 手動で実行することもできます。同意情報を DT Exchange に渡す場合 広告をリクエストする前にこのコードを呼び出すことをおすすめします 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 (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 サーバー パラメータがないか、無効です。 AdMob
103 リクエストされた広告サイズが、DT Exchange でサポートされているバナーサイズと一致しません。
105 DT Exchange SDK が広告を読み込みましたが、予期しないコントローラが返されました。
106 広告を表示する準備ができていません。
200-399 DT Exchange SDK からエラーが返されました。コードをご覧ください。 をご覧ください。
0-10 DT Exchange SDK からエラーが返されました。ドキュメントをご覧ください。 をご覧ください。
101 UI に設定されている DT Exchange サーバー パラメータがないか、無効です。 AdMob
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

  • 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 がある場合に、アダプタが初期化されない問題を修正しました。
  • 必要な最小バージョンの 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.