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

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

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

統合
入札
ウォーターフォール
フォーマット
バナー
インタースティシャル
特典
リワード インタースティシャル

要件

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

ステップ 1: myTarget UI で構成をセットアップする

まず、myTarget アカウントに登録またはログインします。ヘッダーの [アプリ] をクリックして、[アプリ] ページに移動します。[ADD APP] をクリックしてアプリを追加します。

アプリが Android と iOS の両方のプラットフォームをサポートしている場合は、それぞれを個別に設定する必要があります。

Android

次に、アプリの Google Play の URL を入力します。

iOS

次に、アプリの iTunes URL** を入力します。

アプリを追加する場合、プロセスを完了する前に myTarget で広告ユニットを作成する必要があります。

利用可能な広告フォーマットから [BANNER] を選択し、[BANNER] ボタンをクリックします。

インタースティシャル

利用可能な広告フォーマットから [インタースティシャル] を選択し、[広告ユニットを追加] ボタンをクリックします。

特典

利用可能な広告フォーマットの中から [リワード広告動画] を選択し、[広告ユニットを追加] ボタンをクリックします。

ネイティブ

使用可能な広告フォーマットから [ネイティブ] を選択し、[広告ユニットを追加] をクリックします。

広告ユニットの詳細ページでスロット ID をメモしておきます。スロット ID は広告ユニット設定の slot_id で確認できます。このスロット ID は、次のセクションで広告ユニットを設定する際に使用します。 AdMob

AdMob 広告ユニット ID を設定するには、slot_id に加えて myTarget の永続アクセス トークンも必要です。[Profile] タブに移動し、[Access Tokens] を選択します。[トークンを作成] または [トークンを表示] をクリックして、myTarget の永続アクセス トークンを表示します。

テストモードをオンにする

myTarget のドキュメントの手順に沿って、myTarget UI でテストデバイスを追加して構成します。

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

myTarget バージョン 2.1.0 用の Google モバイル広告メディエーション プラグインには、SetUserConsent() メソッドと SetUserAgeRestricted() メソッドが含まれています。次のサンプルコードは、ユーザーの同意情報を myTarget SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に、呼び出すことをおすすめします。

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

ユーザーが年齢制限カテゴリに属していることがわかっている場合は、SetUserAgeRestricted() メソッドを呼び出すこともできます。

MyTarget.SetUserAgeRestricted(true);

詳しくは、myTarget のプライバシーと GDPR ガイドをご覧ください。

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

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

myTarget バージョン 3.13.3 用の Google モバイル広告メディエーション プラグインには、SetCCPAUserConsent(bool) メソッドが含まれています。次のサンプルコードは、ユーザーの同意情報を myTarget SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に、呼び出すことをおすすめします。

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

詳細については、myTarget のサポートにお問い合わせください。

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

Android

myTarget の統合には追加のコードは必要ありません。

iOS

SKAdNetwork との統合

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

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

テスト広告を有効にする

AdMob にテストデバイスを登録し、 myTarget UI でテストモードを有効にします。

テスト広告を確認する

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

エラーコード

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

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

広告の読み込みに失敗した場合に myTarget アダプタがスローするコードとそのメッセージは次のとおりです。

Android

エラーコード 理由
100 myTarget SDK がエラーを返しました。
101 UI で設定されている AdMob myTarget サーバー パラメータがないか、無効です。
102 リクエストされた広告サイズが、myTarget でサポートされているバナーサイズと一致しません。
103 広告リクエストは統合ネイティブ広告リクエストではありません。
104 myTarget から読み込まれたネイティブ広告が、リクエストされたネイティブ広告と異なります。
105 myTarget から読み込まれたネイティブ広告に、必須のアセット（画像、アイコンなど）が含まれていません。

iOS

エラーコード 理由
100 myTarget SDK には、まだ利用可能な広告がありません。
101 UI で設定されている AdMob myTarget サーバー パラメータがないか、無効です。
102 myTarget Adapter では、リクエストされた広告フォーマットがサポートされていません。
103 読み込まれていない myTarget 広告を表示しようとしました。
104 リクエストされた広告サイズが、myTarget でサポートされているバナーサイズと一致しません。
105 必須のネイティブ広告アセットがありません。

myTarget Unity メディエーション プラグインの変更履歴

バージョン 3.16.2

バージョン 3.16.1

バージョン 3.16.0

バージョン 3.15.0

バージョン 3.14.0

バージョン 3.13.2

バージョン 3.13.1

バージョン 3.13.0

バージョン 3.12.0

バージョン 3.11.4

バージョン 3.11.3

バージョン 3.11.2

バージョン 3.11.1

バージョン 3.11.0

バージョン 3.10.2

バージョン 3.10.1

バージョン 3.10.0

バージョン 3.9.0

バージョン 3.8.2

バージョン 3.8.1

バージョン 3.8.0

バージョン 3.7.0

バージョン 3.6.1

バージョン 3.6.0

バージョン 3.5.2

バージョン 3.5.1

バージョン 3.5.0

バージョン 3.4.0

バージョン 3.3.0

バージョン 3.2.0

バージョン 3.1.0

バージョン 3.0.0

  • 新しいオープンベータ版の リワード API をサポートするようプラグインを更新しました。
  • myTarget Android アダプタ バージョン 5.3.9.0 をサポートします。
  • myTarget iOS アダプタ バージョン 5.0.4.0 をサポートします。

バージョン 2.3.2

  • myTarget Android アダプタ バージョン 5.2.5.0 をサポートします。
  • myTarget iOS アダプタ バージョン 4.8.9.0 をサポートします。

バージョン 2.3.1

  • myTarget Android アダプタ バージョン 5.2.5.0 をサポートします。
  • myTarget iOS アダプタ バージョン 4.8.5.0 をサポートします。

バージョン 2.3.0

  • myTarget Android アダプタ バージョン 5.2.2.0 をサポートします。
  • myTarget iOS アダプタ バージョン 4.8.0.0 をサポートします。

バージョン 2.2.0

  • myTarget Android アダプタ バージョン 5.1.4.0 をサポートします。
  • myTarget iOS アダプタ バージョン 4.8.0.0 をサポートします。

バージョン 2.1.2

  • myTarget Android アダプタ バージョン 5.1.3.0 をサポートします。
  • myTarget iOS アダプタ バージョン 4.7.11.0 をサポートします。

バージョン 2.1.1

  • myTarget Android アダプタ バージョン 5.1.1.0 をサポートします。
  • myTarget iOS アダプタ バージョン 4.7.10.0 をサポートします。

バージョン 2.1.0

  • myTarget Android SDK バージョン 5.1.0 をサポートします。
  • myTarget iOS SDK バージョン 4.7.9 をサポートします。
  • 以下のメソッドを追加しました。
    • MyTarget.SetUserConsent() メソッドで、ユーザーの同意ステータスを MyTarget SDK に転送します。
    • ユーザーが年齢制限のあるカテゴリ（16 歳未満）に属しているかどうかを示すフラグを設定する MyTarget.SetUserAgeRestricted メソッド。
    • MyTarget.IsUserConsent() メソッドを使用して、ユーザーの現在の同意ステータスを取得します。
    • MyTarget.IsUserAgeRestricted() メソッド: ユーザーが年齢制限のあるカテゴリ（16 歳未満）に属していることを示すフラグを取得します。

バージョン 2.0.1

  • myTarget Android SDK バージョン 5.0.2 をサポートします。
  • myTarget iOS SDK バージョン 4.7.8 をサポートします。

バージョン 2.0.0

  • myTarget Android SDK バージョン 5.0.0 をサポートします。
  • myTarget iOS SDK バージョン 4.7.7 をサポートします。

バージョン 1.1.0

  • myTarget Android SDK バージョン 4.7.2 をサポートします。
  • myTarget iOS SDK バージョン 4.7.6 をサポートします。

バージョン 1.0.0

  • 初リリース
  • myTarget Android SDK バージョン 4.6.27 をサポートします。
  • myTarget iOS SDK バージョン 4.6.24 をサポートします。