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

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

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

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

統合
入札
ウォーターフォール
形式
バナー
インタースティシャル
特典

要件

  • Unity 4 以降
  • 最新の Google Mobile Ads SDK
  • Android にデプロイするには
    • Android API レベル 19 以降
  • iOS にデプロイする場合
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google Mobile Ads SDK を使って動作する Unity プロジェクトが設定されていること。詳しくは、使ってみるをご覧ください。
  • メディエーションのスタートガイドを完了する

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

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

DT Exchange コンソールに登録またはログインします。

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

アプリを管理する

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

Android

iOS

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

設定

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

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

メニュー

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

App ID

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

プレースメント ID

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

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

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

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

ユーザー プロフィール

ステップ 2: 管理画面で DT エクスチェンジのデマンドを設定する AdMob

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

Android

手順については、 Android 向けガイドのステップ 2 をご覧ください。

iOS

手順については、 iOS 向けガイドのステップ 2 をご覧ください。

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

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

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

変更履歴のダウンロード リンクから DT Exchange 用の Google モバイル広告メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsFyberMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsFyberMediation.unitypackage ファイルを見つけます。すべてのファイルが選択されていることを確認し、[Import]（インポート）をクリックします。

次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolve] を選択します。Unity Play Services Resolver ライブラリは、依存関係の解決をゼロから行い、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

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

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

このセクションでは、DT Exchange のパーソナライズド広告を有効または無効にする方法について説明します。

DT Exchange バージョン 1.1.0 用の Google モバイル広告メディエーション プラグインでは、SetGDPRRequired() メソッドと SetGDPRConsentString() メソッドを含む Fyber クラスが追加され、同意情報を手動で DT Exchange に渡せるようになりました。次のサンプルコードは、これらのパラメータを DT Exchange アダプタに渡す方法を示しています。

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

詳細とこのメソッドで指定できる値については、DT Exchange の GDPR の記事をご覧ください。

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

米国のプライバシー関連州法 「個人情報」の「販売」は、法律で定められているとおり、オプトアウトする権利をユーザーに提供することが義務付けられています。オプトアウトするには、「販売」当事者のホームページに目立つ [個人情報を第三者に売却しない] リンクを使用します。米国のプライバシー関連州法の遵守ガイドでは、Google の広告配信について制限付きデータ処理を有効にすることができますが、Google がメディエーション チェーンの各広告ネットワークにこの設定を適用することはできません。したがって、個人情報の販売に参加する可能性のあるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってポリシーに準拠する必要があります。

DT Exchange バージョン 3.1.1 用の Google モバイル広告メディエーション プラグインでは、SetCCPAString() メソッドを使用する Fyber クラスが追加され、同意情報を手動で DT Exchange に渡せるようになりました。次のサンプルコードは、これらのパラメータを DT Exchange アダプタに渡す方法を示しています。

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

詳細とこのメソッドで提供できる値については、DT Exchange の CCPA オープンソース記事をご覧ください。

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

Android

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

iOS

SKAdNetwork との統合

DT Exchange のドキュメントに沿って、SKAdNetwork 識別子をプロジェクトの Info.plist ファイルに追加します。

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

テスト広告を有効にする

AdMob。

テスト広告を確認する

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

エラーコード

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

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

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

iOS

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

DT Exchange Unity メディエーション プラグインに関する変更履歴

バージョン 3.1.8

バージョン 3.1.7

バージョン 3.1.6

バージョン 3.1.5

バージョン 3.1.4

バージョン 3.1.3

バージョン 3.1.2

バージョン 3.1.1

バージョン 3.1.0

バージョン 3.0.2

バージョン 3.0.1

バージョン 3.0.0

バージョン 2.0.0

バージョン 1.6.1

バージョン 1.6.0

バージョン 1.5.2

バージョン 1.5.1

バージョン 1.5.0

バージョン 1.4.0

バージョン 1.3.0

バージョン 1.2.3

バージョン 1.2.2

バージョン 1.2.1

バージョン 1.2.0

バージョン 1.1.0

バージョン 1.0.0