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

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

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

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

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

要件

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

ステップ 1: Unity Ads UI で設定を行う

Unity Ads に登録またはログインします。

プロジェクトを作成する

Unity 広告ダッシュボードで [プロジェクト] に移動し、[プロジェクトを作成] をクリックします。

フォームに入力し、[プロジェクトを作成] をクリックしてプロジェクトを追加します。

[収益化] > [使ってみる] に移動し、[始める] をクリックします。

[Project Setup] モーダルで、[Mediation Partner] に [I plan to use Mediation] と [Google AdMob] を選択し、[Next] をクリックします。

広告設定を選択し、[次へ] をクリックします。

フォームに必要事項を入力し、[プロジェクトを追加] をクリックします。

[ゲーム ID] をメモします。

広告ユニットを作成する

[収益化] > [広告ユニット] に移動し、[広告ユニットを追加] をクリックします。

広告ユニット名を入力し、プラットフォームと広告フォーマットを選択します。

Android

iOS

最後に、[作成] をクリックして広告ユニットを保存します。

プレースメントを追加

プロジェクトが作成されたら、[収益化] > [プレースメント] に移動します。新しいプレースメントを作成するには、広告ユニットの [プレースメントを追加] をクリックします。

必要な情報を入力して [Add Placement] をクリックします。

[プレースメント ID] をメモしておきます。

Android

iOS

認証情報を取得する

ゲーム ID とプレースメント ID のほかに、AdMob 広告ユニット ID を設定するための Unity Ads API キーと組織コア ID も必要です。

[Monetization] > [Setup] > [API Management] に移動し、[Monetization Stats API Access Key] をメモします。

次に、[収益化] > [Organization Settings] に移動し、Organization core ID をメモします。

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

テストモードは Unity 広告ダッシュボードから有効にできます。プロジェクトの設定で、[テスト] タブを選択します。

アプリにテストモードを強制的に適用するには、各プラットフォームの編集ボタンをクリックし、[クライアント テストモードをオーバーライドする] をオンにして、[すべてのデバイスでテストモードを強制的にオンにする（テスト広告を使用する）] を選択します。

Android

iOS

また、[Add Test Device] ボタンをクリックして、特定のデバイスのテストモードを有効にすることもできます。

フォームに記入して [保存] をクリックします。

ステップ 2: UI で AdMob Unity 広告のデマンドを設定する

为广告单元配置中介设置

Android

如需了解相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需了解相关说明，请参阅 iOS 指南中的第 2 步。

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

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

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

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

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

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

Unity 広告サービスで Unity アダプタを使用する

[サービス] ペイン、パッケージ マネージャー、またはアセットストアから Unity Ads SDK を統合している場合は、アプリに Unity Ads Android SDK のコピーがすでに存在します。Android 向けのビルド時にシンボルの重複に関する問題を回避するには、Unity Ads SDK への参照を削除する必要があります。

Assets/GoogleMobileAds/Editor/UnityMediationDependencies.xml ファイルを更新し、Unity Ads SDK の依存関係を削除します。

<!-- If using the Unity Ads Service from Unity3D, comment out this dependency to
avoid including the Unity Ads Android SDK twice. -->
<androidPackage spec="com.unity3d.ads:unity-ads:x.y.z">
  <repositories>
    <repository>https://repo.maven.apache.org/maven2/</repository>
  </repositories>
</androidPackage>

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

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

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

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("gdpr.consent", true);

各メソッドで指定可能な値と詳細については、Unity Ads の Privacy Consent and Data API と GDPR への準拠ガイドをご覧ください。

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

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

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

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("privacy.consent", true);

各メソッドで指定可能な値と詳細については、Unity Ads の Privacy Consent and Data API と CCPA の遵守ガイドをご覧ください。

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

Android

Unity Ads Android との統合にコードを追加する必要はありません。

iOS

SKAdNetwork との統合

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

コンパイル エラー

Unity Ads アダプタ 3.4.0 以降の場合は、Unity のドキュメントに記載されている統合手順を実施する必要があります。

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

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

Android

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

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

Android

エラーコード 理由
0-10 UnityAds SDK からエラーが返されました。詳しくは、コードをご覧ください。
101 AdMob 管理画面で設定されている UnityAds サーバー パラメータがないか、無効です。
102 UnityAds から NO_FILL 状態のプレースメントが返されました。
103 UnityAds から DISABLED 状態のプレースメントが返されました。
104 UnityAds が null コンテキストの広告を表示しようとしました。
105 Unity Ads からの広告の初期化、読み込み、表示に使用されるコンテキストは Activity インスタンスではありません。
106 UnityAds が表示の準備が完了していない広告を表示しようとしました。
107 UnityAds はこのデバイスでは利用できません。
108 UnityAds では、プレースメントごとに一度に 1 つの広告しか読み込めません。
109 UnityAds が ERROR ステータスで終了しました。
200-204 UnityAds に特定のエラーが表示されるようになりました。詳しくは、コードをご覧ください。

iOS

0～9 UnityAds SDK からエラーが返されました。詳しくは、Unity のドキュメントをご覧ください。
101 AdMob 管理画面で設定されている UnityAds サーバー パラメータがないか、無効です。
102 UnityAds でサポートされていないデバイスです。
103 UnityAds がエラー ステータス kUnityAdsFinishStateError とともに表示を終了しました。
104 Unity 広告オブジェクトがイニシャライザを呼び出した後に nil になる。
105 広告の準備ができていないため、Unity 広告を表示できませんでした。
106 UnityAds は、プレースメントの状態が kUnityAdsPlacementStateNoFill のプレースメント変更コールバックを呼び出しました。
107 UnityAds は、プレースメントの状態が kUnityAdsPlacementStateDisabled のプレースメント変更コールバックを呼び出しました。
108 このプレースメントには広告がすでに読み込まれています。UnityAds SDK では、同じプレースメントに複数の広告を読み込むことはできません。

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

バージョン 3.9.1

バージョン 3.9.0

バージョン 3.8.0

バージョン 3.7.1

バージョン 3.7.0

バージョン 3.6.1

バージョン 3.6.0

バージョン 3.5.0

バージョン 3.4.1

バージョン 3.4.0

バージョン 3.3.0

バージョン 3.2.1

バージョン 3.2.0

バージョン 3.1.0

バージョン 3.0.1

バージョン 3.0.0

バージョン 2.7.2

バージョン 2.7.1

バージョン 2.7.0

バージョン 2.6.0

バージョン 2.5.1

バージョン 2.5.0

バージョン 2.4.7

バージョン 2.4.6

バージョン 2.4.5

バージョン 2.4.4

バージョン 2.4.3

バージョン 2.4.2

バージョン 2.4.1

バージョン 2.4.0

バージョン 2.3.0

バージョン 2.2.0

バージョン 2.1.0

  • Unity Ads Android アダプタ バージョン 3.1.0.0 をサポートします。
  • Unity Ads iOS アダプタ バージョン 3.1.0.0 をサポート

バージョン 2.0.3

  • 新しいオープンベータ版リワード API をサポートするようにプラグインを更新しました。
  • バナー広告のサポートが追加されました。
  • Unity Ads Android アダプタ バージョン 3.0.0.2 をサポートします。
  • Unity Ads iOS アダプタ バージョン 3.0.0.3 をサポート

バージョン 2.0.2

  • Unity Ads Android アダプタ バージョン 3.0.0.0 をサポートします。
  • Unity Ads iOS アダプタ バージョン 3.0.0.1 をサポートします。

バージョン 2.0.1

  • iOS 向けのビルド時に発生する問題の原因となっていた「互換性のないタイプ」のエラーを修正しました。

バージョン 2.0.0

  • Unity Ads Android アダプタ バージョン 3.0.0.0 をサポートします。
  • Unity Ads iOS アダプタ バージョン 3.0.0.0 をサポート

バージョン 1.2.0

  • Unity Ads Android アダプタ バージョン 2.3.0.0 をサポートします。
  • Unity Ads iOS アダプタ バージョン 2.3.0.0 をサポートします。

バージョン 1.1.3

  • Unity Ads Android アダプタ バージョン 2.2.1.0 をサポートします。
  • Unity Ads iOS アダプタ バージョン 2.2.1.0 をサポートします。

バージョン 1.1.2

  • Unity Ads Android SDK バージョン 2.2.0 をサポートします。
  • Unity Ads iOS SDK バージョン 2.2.0 をサポート
  • ターゲット広告に対するオプトインをユーザーに手動でリクエストする UnityAds.SetGdprConsentMetaData() メソッドを追加しました。

バージョン 1.1.1

  • Unity Ads Android SDK バージョン 2.2.0 をサポートします。
  • Unity Ads iOS SDK バージョン 2.2.1 をサポートします。

バージョン 1.1.0

  • Unity Ads Android SDK バージョン 2.2.0 をサポートします。
  • Unity Ads iOS SDK バージョン 2.2.0 をサポート

バージョン 1.0.0

  • 初回リリース
  • Unity Ads Android SDK バージョン 2.1.2 をサポート
  • Unity Ads iOS SDK バージョン 2.1.2 をサポート