このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 メディエーションを使用して、DT Exchange から配信される ウォーターフォール統合に対応していますDT Exchange を広告ユニットの DT Exchange SDK とアダプターを統合する方法を 組み込むことが重要です。 Unity
サポートされている統合と広告フォーマット
DT Exchange 用の AdMob メディエーション アダプタには、 次のような機能があります。
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 |
要件
- 最新の Google Mobile Ads SDK
- Unity 4 以降
- Android にデプロイする
- Android API レベル 21 以降
- iOS にデプロイする場合
- iOS デプロイ ターゲットが 12.0 以降であること
- Google で構成された Unity 作業プロジェクト Mobile Ads SDK があります。詳しくは、 スタートガイドをご覧ください。
- メディエーションを完了する スタートガイド
ステップ 1: DT Exchange UI で設定をセットアップする
新しいアプリと広告のプレースメントを追加
DT Exchange コンソールに登録またはログインします。
[Add App] ボタンをクリックしてアプリを追加します。
[プラットフォーム] を選択し、フォームの残りの部分を入力して、[プレースメントを追加] をクリックします。
Android
iOS
[Name your Placement] フィールドに新しいプレースメントの名前を入力し、プルダウン リストから目的の [プレースメント タイプ] を選択します。最後に [Save Placement] をクリックします。
アプリ ID とプレースメント ID
左ナビゲーション バーにカーソルを合わせ、開きます。左側のメニューで [アプリ] をクリックします。
[アプリの管理] ページで、アプリの横にある [アプリ ID] をメモします。
アプリを選択して [プレースメント] タブに移動し、[プレースメント名] の横にあるコピーアイコンをクリックします。[プレースメント ID] をメモします。
パブリッシャー ID、コンシューマ キー、コンシューマ シークレット
左側のメニューからユーザー名をクリックし、[ユーザー プロフィール] を選択します。
[Publisher ID]、[Consumer Key]、[Consumer Secret] は次のステップで必要になるため、メモしておきます。
ステップ 2: 管理画面で DT Exchange デマンドを設定する AdMob
広告ユニットのメディエーション設定を行う
GDPR と米国の州規制の広告パートナー リストに Fyber 追加
GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の GDPR および米国の州規制の広告パートナーのリストに Fyber を追加します。
ステップ 3: DT Exchange SDK とアダプタをインポートする
DT 向け Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロード
変更履歴と抽出
ZIP ファイル内の GoogleMobileAdsFyberMediation.unitypackage
。
Unity プロジェクト エディタで、[Assets] >パッケージをインポート >カスタム
パッケージ化し、必要な GoogleMobileAdsFyberMediation.unitypackage
ファイルを見つけます。
ダウンロードされます。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import](インポート)をクリックします。
次に、[アセット >Play 開発者サービス リゾルバ >Android リゾルバ >力
解決する。Unity Play Services Resolver ライブラリが依存関係を実行
宣言し、宣言された依存関係を
Unity アプリの Assets/Plugins/Android
ディレクトリ。
ステップ 4: DT Exchange SDK にプライバシー設定を実装する
EU の同意と GDPR
Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID と個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則(GDPR)。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google は ユーザーの同意に関する選択をこうしたネットワークに自動的に渡す。
このセクションでは、DT Exchange のパーソナライズド広告を有効または無効にする方法について説明します。
DT Exchange 用の Google Mobile Ads メディエーション プラグイン バージョン 1.1.0 で、
SetGDPRRequired()
メソッドと SetGDPRConsentString()
メソッドを含む Fyber
クラス
同意情報を DT Exchange に手動で渡すことができます。次の
サンプルコードは、これらのパラメータを DT Exchange に渡す方法を示しています。
アダプター:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
DT Exchange にアクセスする GDPR(一般データ保護規則) を参照してください。
米国のプライバシー関連州法
米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトするユーザーの「個人情報」(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドに用意されている 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります
DT Exchange 用の Google Mobile Ads メディエーション プラグイン バージョン 3.1.1 で、
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 Open にアクセス 出典 を参照してください。
ステップ 5: 必要なコードを追加する
Android
DT Exchange を統合するために追加のコードは必要ありません。
iOS
SKAdNetwork との統合
DT Exchange の
ドキュメント
プロジェクトの Info.plist
ファイルに SKAdNetwork 識別子を追加します。
ステップ 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 メディエーション プラグインの変更履歴
次のバージョン
DummyClient
の名前をPlaceholderClient
に変更しました。
バージョン 3.2.1
- DT Exchange Android アダプター バージョン 8.2.7.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.3.1.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.1 でビルド、テストされています。
バージョン 3.2.0
- DT Exchange Android アダプター バージョン 8.2.7.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.3.0.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 3.1.12
- DT Exchange Android アダプター バージョン 8.2.7.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.2.8.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 3.1.11
- DT Exchange Android アダプター バージョン 8.2.7.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.2.7.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.1.0 でビルド、テストされています。
バージョン 3.1.10
- DT Exchange Android アダプター バージョン 8.2.6.1 をサポートします。
- DT Exchange iOS アダプター バージョン 8.2.7.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 9.0.0 でビルド、テストされています。
バージョン 3.1.8
- DT Exchange Android アダプター バージョン 8.2.5.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.2.6.0 をサポートしています。
- Google Mobile Ads Unity Plugin バージョン 8.6.0 でビルド、テストされています。
バージョン 3.1.7
- DT Exchange Android アダプター バージョン 8.2.4.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.2.4.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 8.5.2 でビルド、テストされていること。
バージョン 3.1.6
- DT Exchange Android アダプター バージョン 8.2.3.0 をサポートしています。
- DT Exchange iOS アダプター バージョン 8.2.3.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 8.4.1 でビルド、テストされていること。
バージョン 3.1.5
- アダプターのコンテンツを
GoogleMobileAds/Mediation/DTExchange/
に移動しました。 GoogleMobileAds.Mediation.DTExchange
を使用するようにアダプターの名前空間をリファクタリングしました。- DT Exchange Android アダプター バージョン 8.2.3.0 をサポートしています。
- DT Exchange iOS アダプター バージョン 8.2.1.0 をサポートします。
- Google Mobile Ads Unity プラグイン バージョン 8.1.0 でビルド、テストされています。
バージョン 3.1.4
- DT Exchange Android アダプター バージョン 8.2.2.0 をサポートしています。
- DT Exchange iOS アダプター バージョン 8.1.9.1 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.4.1 でビルド、テストされていること。
バージョン 3.1.3
- DT Exchange Android アダプター バージョン 8.2.1.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.1.9.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.4.0 でビルド、テストされていること。
バージョン 3.1.2
- Unity メディエーション プラグインの名称を「DT Exchange」に変更しました。
GoogleMobileAds.Api.Mediation.Fyber.Fyber
クラスの名前をGoogleMobileAds.Api.Mediation.DTExchange.DTExchange
に変更しました。- DT Exchange Android アダプター バージョン 8.2.1.0 をサポートします。
- DT Exchange iOS アダプター バージョン 8.1.7.0 をサポートします。
- Google Mobile Ads Unity Plugin バージョン 7.3.1 でビルド、テストされていること。
バージョン 3.1.1
Fyber
クラスに以下のメソッドを追加しました。SetCCPAString(string)
ClearCCPAString()
- Fyber Android アダプター バージョン 8.2.0.0 をサポートしています。
- Fyber iOS アダプター バージョン 8.1.6.0 をサポートしています。
- Google Mobile Ads Unity Plugin バージョン 7.3.0 でビルド、テストされていること。
バージョン 3.1.0
- Fyber Android アダプター バージョン 8.2.0.0 をサポートしています。
- Fyber iOS アダプター バージョン 8.1.5.0 をサポートしています。
- Google Mobile Ads Unity Plugin バージョン 7.2.0 でビルド、テストされていること。
バージョン 3.0.2
- Fyber Android アダプター バージョン 8.1.3.1 をサポートしています。
- Fyber iOS アダプター バージョン 8.1.5.0 をサポートしています。
- Google Mobile Ads Unity Plugin バージョン 7.0.2 でビルド、テストされていること。
バージョン 3.0.1
- Fyber Android アダプター バージョン 8.1.3.0 をサポートしています。
- Fyber iOS アダプター バージョン 8.1.4.0 をサポートしています。
- Google Mobile Ads Unity プラグイン バージョン 7.0.0 でビルド、テストされています。
バージョン 3.0.0
- Fyber Android アダプター バージョン 8.1.2.0 をサポートしています。
- Fyber iOS アダプター バージョン 8.1.2.0 をサポートしています。
バージョン 2.0.0
- Fyber Android アダプター バージョン 7.8.4.1 をサポートしています。
- Fyber iOS アダプター バージョン 8.0.0.0 をサポートしています。
バージョン 1.6.1
- Fyber Android アダプター バージョン 7.8.3.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.8.6.0 をサポートしています。
バージョン 1.6.0
- Fyber Android アダプター バージョン 7.8.2.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.8.5.0 をサポートしています。
バージョン 1.5.2
- Fyber Android アダプター バージョン 7.7.4.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.7.3.0 をサポートしています。
バージョン 1.5.1
- Fyber Android アダプター バージョン 7.7.2.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.7.2.0 をサポートしています。
バージョン 1.5.0
- Fyber Android アダプター バージョン 7.7.1.0 をサポートします。
- Fyber iOS アダプター バージョン 7.7.1.0 をサポートしています。
バージョン 1.4.0
- Fyber Android アダプター バージョン 7.7.0.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.6.4.0 をサポートしています。
バージョン 1.3.0
- Fyber Android アダプター バージョン 7.6.0.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.6.0.0 をサポートしています。
バージョン 1.2.3
- Fyber Android アダプター バージョン 7.5.4.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.5.6.0 をサポートしています。
バージョン 1.2.2
- Fyber Android アダプター バージョン 7.5.3.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.5.4.0 をサポートしています。
バージョン 1.2.1
- Fyber Android アダプター バージョン 7.5.2.0 をサポートしています。
- Fyber iOS アダプター バージョン 7.5.3.0 をサポートしています。
バージョン 1.2.0
- Fyber Android アダプター バージョン 7.5.0.0 をサポートします。
- Fyber iOS アダプター バージョン 7.5.1.0 をサポートしています。
バージョン 1.1.0
- GDPR の要件をサポートするために、次のメソッドを
Fyber
クラスに追加しました。SetGDPRConsent()
SetGDPRConsentString()
ClearGDPRConsentData()
- Fyber Android アダプター バージョン 7.3.4.0 をサポートします。
- Fyber iOS アダプター バージョン 7.5.0.0 をサポートしています。
バージョン 1.0.0
- 初リリース
- Fyber Android アダプター バージョン 7.3.4.0 をサポートします。
- Fyber iOS アダプター バージョン 7.4.0.0 をサポートしています。