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

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

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

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

要件

  • Unity 4 以降
  • 最新の Google Mobile Ads SDK
  • Android にデプロイする <ph type="x-smartling-placeholder">
      </ph>
    • Android API レベル 21 以降
  • iOS にデプロイする場合 <ph type="x-smartling-placeholder">
      </ph>
    • iOS デプロイ ターゲットが 12.0 以降
  • Google Mobile Ads SDK で設定された、動作する Unity プロジェクト。詳細については、スタートガイドをご覧ください。
  • メディエーションのスタートガイドを完了していること

ステップ 1: myTarget の管理画面で設定を行う

まず、登録またはログインして、 myTarget アカウントに移動します。ページの右上にある [アプリ] をクリックして できます。[アプリを追加] をクリックしてアプリを追加します。

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

Android

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

iOS

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

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

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

インタースティシャル

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

特典

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

ネイティブ

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

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

AdMob 広告ユニット ID を設定するには、slot_id に加えて、myTarget の永続アクセス トークンも必要です。[プロフィール] タブに移動し、[アクセス トークン] を選択します。[Create Token] または [Show Token] をクリックして表示します。 myTarget 永続アクセス トークン。

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

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

ステップ 2: UI で Ad Manager myTarget のデマンドを設定する

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

Android

手順については、 Android。

iOS

手順については、 iOS。

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

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Google Mobile Ads myTarget メディエーション プラグイン（Unity 用）をプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

Unity プロジェクト エディタで [Edit] >プロジェクト設定 > [Package Manager] をクリックすると、 Unity Package Manager の設定。

[スコープ付きレジストリ] タブで、OpenUPM をスコープ付きレジストリとして追加し、次の詳細情報を指定します。

  • 名前: OpenUPM
  • URL: https://package.openupm.com
  • スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウン メニューから [My Registries] を選択します。

Unity レジストリ

[Google Mobile Ads myTarget Mediation] パッケージを選択し、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

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

Unity プロジェクト エディタで、[Assets] を選択します。パッケージのインポート > [Custom Package] に移動し、 GoogleMobileAdsMyTargetMediation.unitypackage 表示されます。すべてのファイルが選択されていることを確認して、 インポート。

Unity からインポート

次に、[アセット] >External Dependency Manager > Android Resolver >Force Resolve。External Dependency Manager ライブラリは依存関係をゼロから解決し、 アプリケーションの Assets/Plugins/Android ディレクトリに配置し、 Unity アプリ

強制解決

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

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

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

MyTarget.SetCCPAUserConsent(true);

myTarget のサポートに問い合わせる ご確認ください。

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

Android

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

iOS

SKAdNetwork の統合

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

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

テスト広告を有効にする

Ad Manager にテストデバイスを登録し、 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 に設定されている Ad Manager myTarget サーバー パラメータがないか、無効です。
102 リクエストされた広告サイズが、myTarget でサポートされているバナーサイズと一致しません。
103 広告リクエストが統合型ネイティブ広告リクエストではない。
104 myTarget から読み込まれたネイティブ広告が、リクエストされたネイティブ広告と異なります。
105 myTarget から読み込まれたネイティブ広告に、必要なアセット（画像やアイコンなど）が欠落しています。

iOS

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

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

バージョン 3.18.1

バージョン 3.18.0

バージョン 3.17.1

バージョン 3.17.0

バージョン 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

  • 新しいオープンベータ版の Rewarded 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 に転送します。
    • MyTarget.SetUserAgeRestricted メソッド: ユーザーが年齢制限のあるカテゴリ（16 歳未満）に属していることが判明しているかどうかを示すフラグを設定します。
    • 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 をサポートします。