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

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

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

Unity 広告用のメディエーション アダプタの機能は次のとおりです。

要件

• Android API レベル 21 以降

• 最新の Google Mobile Ads SDK

• メディエーションを完了する スタートガイド

ステップ 1: Unity 広告 UI で設定をセットアップする

ステップ 2: 管理画面で Unity 広告デマンドを設定する AdMob

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

広告ユニットのメディエーション設定に Unity Ads を追加する必要があります。

AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。既存のメディエーション グループを編集する場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして Unity Ads を追加するに進んでください。

新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。

広告フォーマットとプラットフォームを入力して、[続行] をクリックします。

メディエーション グループに名前を付けて、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。

このメディエーション グループを、既存の 1 つ以上の広告ユニット（AdMob ）に関連付けます。[完了] をクリックします。

選択した広告ユニットが入力された広告ユニットカードが表示されます。

広告ソースとして Unity Ads を追加

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

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

Android Studio の統合（推奨）

アプリレベルの build.gradle.kts ファイルに次の実装を追加します。 構成について説明します。Unity Ads SDK の最新バージョンを使用する およびアダプター:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.2.0")
}

手動による統合

1. 最新の Unity Ads SDK（unity-ads.aar）を GitHub リポジトリ プロジェクトに追加します

2. [ Unity 広告アダプタ アーティファクト Google の Maven リポジトリにあります最新バージョンを選択して Unity をダウンロードしてください。 広告アダプタの .aar ファイルを開き、プロジェクトに追加します。

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

EU ユーザーの同意と GDPR

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

SDK バージョン 2.0.0 で、Unity Ads にプライバシー設定をサポートする API が追加されました。「 次のサンプルコードは、この同意情報を Unity に渡す方法を示しています。 。同意情報を Unity Ads SDK に渡す場合 広告をリクエストする前にこのコードを呼び出すことをおすすめします。 Google Mobile Ads SDK を介して データを収益化できます

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

Unity の広告を見る プライバシーに関する同意とデータ API および GDPR の遵守 の各メソッドで指定できる値に関するガイドをご覧ください。

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

米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトする「個人情報」を（法律で定められているとおり、 これらの規約を参照）の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドに用意されている 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

SDK バージョン 2.0.0 で、Unity Ads にプライバシー設定をサポートする API が追加されました。「 次のサンプルコードは、この同意情報を Unity に渡す方法を示しています。 。同意情報を Unity Ads SDK に渡す場合 広告をリクエストする前にこのコードを呼び出すことをおすすめします。 Google Mobile Ads SDK を介して データを収益化できます

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

import com.unity3d.ads.metadata.MetaData
// ...

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

Unity の広告を見る プライバシーに関する同意とデータ API および CCPA の遵守 の各メソッドで指定できる値に関するガイドをご覧ください。

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

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

アダプタが Unity Ads から広告を受け取れない場合は、 広告レスポンスの根本的なエラーを確認するため、 ResponseInfo.getAdapterResponses() 次のクラスに分類されます。

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

以下は、UnityAds アダプタがスローするコードとそのメッセージです。 広告の読み込みに失敗した場合:

Unity 広告 Android メディエーション アダプタの変更履歴

バージョン 4.12.2.0

• Unity Ads SDK 4.12.2 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 23.2.0.
• Unity Ads SDK バージョン 4.12.2。

バージョン 4.12.1.0

• Unity Ads SDK 4.12.1 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 23.2.0.
• Unity Ads SDK バージョン 4.12.1。

バージョン 4.12.0.0

• Unity Ads SDK 4.12.0 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 23.1.0.
• Unity Ads SDK バージョン 4.12.0。

バージョン 4.11.3.0

• バナー広告、インタースティシャル広告、リワード広告の各フォーマットで入札がサポートされるようになりました。
• Unity Ads SDK 4.11.3 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 23.1.0.
• Unity Ads SDK バージョン 4.11.3。

バージョン 4.11.2.0

• Unity Ads SDK 4.11.2 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 23.0.0 にアップデートします。
• Unity Ads SDK バージョン 4.11.2。

バージョン 4.10.0.0

• 必要な Google Mobile Ads SDK の最小バージョンを 23.0.0 に更新しました。
• Unity Ads SDK 4.10.0 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 23.0.0 にアップデートします。
• Unity Ads SDK バージョン 4.10.0。

バージョン 4.9.3.0

• Unity Ads SDK 4.9.3 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 22.6.0.
• Unity Ads SDK バージョン 4.9.3。

バージョン 4.9.2.0

• Unity Ads SDK 4.9.2 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 22.3.0.
• Unity Ads SDK バージョン 4.9.2。

バージョン 4.9.1.0

• 必要な最小バージョンの Google Mobile Ads SDK を 22.3.0 に更新しました。
• Unity Ads SDK 4.9.1 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 22.3.0.
• Unity Ads SDK バージョン 4.9.1.

バージョン 4.8.0.0

• Unity Ads SDK が新しい onBannerShown() を呼び出したときに広告のインプレッションを報告します コールバック メソッドを指定します。
• Unity Ads SDK 4.8.0 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 22.2.0.
• Unity Ads SDK バージョン 4.8.0。

バージョン 4.7.1.0

• Unity Ads SDK 4.7.1 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 22.1.0.
• Unity Ads SDK バージョン 4.7.1。

バージョン 4.7.0.0

• Unity Ads SDK 4.7.0 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 22.0.0 にアップデートします。
• Unity Ads SDK バージョン 4.7.0。

バージョン 4.6.1.1

• 新しい VersionInfo クラスを使用するようにアダプターを更新しました。
• 必要な Google Mobile Ads SDK の最小バージョンを 22.0.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 22.0.0 にアップデートします。
• Unity Ads SDK バージョン 4.6.1。

バージョン 4.6.1.0

• Unity Ads SDK 4.6.1 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 21.5.0
• Unity Ads SDK バージョン 4.6.1。

バージョン 4.6.0.0

• COPPA 情報を Unity Ads SDK に転送するためのサポートを追加しました。
• Unity Ads SDK 4.6.0 との互換性を検証しました。
• 必要な Google Mobile Ads SDK の最小バージョンを 21.5.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 21.5.0
• Unity Ads SDK バージョン 4.6.0。

バージョン 4.5.0.0

• Unity Ads SDK 4.5.0 との互換性を検証しました。
• 必要な最小バージョンの Google Mobile Ads SDK を 21.4.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 21.4.0
• Unity Ads SDK バージョン 4.5.0。

バージョン 4.4.1.0

• Unity Ads SDK 4.4.1 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 21.2.0
• Unity Ads SDK バージョン 4.4.1。

バージョン 4.4.0.0

• Unity Ads SDK 4.4.0 との互換性を検証しました。
• 必要な最小バージョンの Google Mobile Ads SDK を 21.2.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 21.2.0
• Unity Ads SDK バージョン 4.4.0。

バージョン 4.3.0.0

• Unity Ads SDK 4.3.0 との互換性を検証しました。
• インタースティシャル広告とリワード広告の再生が開始されたときに onAdOpened() コールバックが転送されるようになりました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 21.1.0
• Unity Ads SDK バージョン 4.3.0。

バージョン 4.2.1.1

• compileSdkVersion と targetSdkVersion を API 31 に更新しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 21.0.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 21.0.0.
• Unity Ads SDK バージョン 4.2.1。

バージョン 4.2.1.0

• Unity Ads SDK 4.2.1 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.6.0.
• Unity Ads SDK バージョン 4.2.1。

バージョン 4.1.0.0

• Unity Ads SDK 4.1.0 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.6.0.
• Unity Ads SDK バージョン 4.1.0。

バージョン 4.0.1.0

• Unity Ads SDK 4.0.1 との互換性を検証しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 20.6.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.6.0.
• Unity Ads SDK バージョン 4.0.1。

バージョン 4.0.0.0

• Unity Ads SDK 4.0.0 との互換性を検証しました。
• 必要な最小バージョンの Google Mobile Ads SDK を 20.5.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.5.0.
• Unity Ads SDK バージョン 4.0.0。

バージョン 3.7.5.0

• Unity Ads SDK 3.7.5 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.2.0.
• Unity Ads SDK バージョン 3.7.5。

バージョン 3.7.4.0

• Unity Ads SDK 3.7.4 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.2.0.
• Unity Ads SDK バージョン 3.7.4。

バージョン 3.7.2.0

• Unity Ads SDK 3.7.2 との互換性を検証しました。
• 必要な最小の Google Mobile Ads SDK バージョンを 20.2.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.2.0.
• Unity Ads SDK バージョン 3.7.2。

バージョン 3.7.1.0

• Unity Ads SDK 3.7.1 との互換性を検証しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 20.1.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 20.1.0.
• Unity Ads SDK バージョン 3.7.1。

バージョン 3.6.2.0

• Unity Ads SDK 3.6.2 との互換性を検証しました。
• リワード広告がクリック コールバックを転送しない問題を修正しました。
• UnityAds SDK がバンドルされたアダプター ビルドから削除されました。 パブリッシャー様は、追加の依存関係として UnityAds SDK を手動で追加する必要があります。
• 必要な最小バージョンの Google Mobile Ads SDK を 19.8.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.8.0.
• Unity Ads SDK バージョン 3.6.2。

バージョン 3.6.0.0

• Unity Ads SDK 3.6.0 との互換性を検証しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 19.6.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.6.0.
• Unity Ads SDK バージョン 3.6.0。

バージョン 3.5.1.1

• 複数のインタースティシャル広告とリワード広告をリクエストしようとしたときに発生する問題を修正しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.5.0.
• Unity Ads SDK バージョン 3.5.1。

バージョン 3.5.1.0

• Unity Ads SDK 3.5.1 との互換性を検証しました。
• スマートバナー広告のリクエストが失敗する問題を修正しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.5.0.
• Unity Ads SDK バージョン 3.5.1。

バージョン 3.5.0.0

• Unity Ads SDK 3.5.0 との互換性を検証しました。
• アダプティブ バナーのサポートを追加しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 19.5.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.5.0.
• Unity Ads SDK バージョン 3.5.0。

バージョン 3.4.8.0

• バナー広告が破棄されたときに発生する NullPointerException エラーを修正しました。
• 必要な最小バージョンの Google Mobile Ads SDK を 19.3.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.3.0.
• Unity Ads SDK バージョン 3.4.8。

バージョン 3.4.6.1

• Unity Ads SDK がバンドルされていないアダプタービルドを作成しました。 これによりパブリッシャー様は、 Unity で依存関係の問題を回避
  • パブリッシャー様は、 com.google.ads.mediation:unity-adapter-only:x.y.z.p の依存関係 アプリレベルの build.gradle ファイル。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.1.0.
• Unity Ads SDK バージョン 3.4.6。

バージョン 3.4.6.0

• Unity Ads SDK 3.4.6 との互換性を検証しました。
• バナー広告がクリックされたときに、アダプタが onAdOpened() コールバックを転送するようになりました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.1.0.
• Unity Ads SDK バージョン 3.4.6。

バージョン 3.4.2.3

• アダプターの読み込みまたは番組の失敗の説明的なエラーコードと理由を追加しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 19.1.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.1.0.
• Unity Ads SDK バージョン 3.4.2。

バージョン 3.4.2.2

• Unity Ads がエラーを返したときに発生する ConcurrentModificationException のクラッシュを修正しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.0.1.
• Unity Ads SDK バージョン 3.4.2。

バージョン 3.4.2.1

• Unity のエラーの転送を改善し、初期化と広告の読み込みエラーを早期に認識してタイムアウトを短縮しました。
• 必要な最小バージョンの Google Mobile Ads SDK を 19.0.1 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 19.0.1.
• Unity Ads SDK バージョン 3.4.2。

バージョン 3.4.2.0

• Unity Ads SDK 3.4.2 との互換性を検証しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 18.3.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 18.3.0.
• Unity Ads SDK バージョン 3.4.2。

バージョン 3.4.0.0

• Unity Ads SDK 3.4.0 との互換性を検証しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 18.3.0 に更新しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 18.3.0.
• Unity Ads SDK バージョン 3.4.0。

バージョン 3.3.0.0

• Unity Ads SDK 3.3.0 との互換性を検証しました。

ビルドとテストに使用するツール:

• Google Mobile Ads SDK バージョン 18.2.0.
• Unity Ads SDK バージョン 3.3.0。

バージョン 3.2.0.1

• loadAd() の呼び出し時に発生した null ポインタ例外のクラッシュを修正しました までメールでお問い合わせください。UnityAds.initialize()
• 最低限必要な Google Mobile Ads SDK のバージョンを 18.2.0 に更新しました。

バージョン 3.2.0.0

• バナー広告のリクエストが失敗する問題を修正しました。
• Unity Ads SDK 3.2.0 との互換性を検証しました。
• アダプターを AndroidX に移行しました。
• 必要な最小バージョンの Google Mobile Ads SDK を 18.1.1 に更新しました。

バージョン 3.1.0.0

• 柔軟なバナー広告のサポートが追加されました。
• リクエストされたサイズが対応していないと、アダプタで広告リクエストが失敗します すべての Unity 広告のバナーサイズに対応
• Unity Ads SDK 3.1.0 との互換性を検証しました。

バージョン 3.0.1.0

• Unity Ads SDK 3.0.1 との互換性を検証しました。
• 「NPE」の原因となっていたバグを修正しました。3 つのルールがあります

バージョン 3.0.0.2

• 新しいオープンベータ版リワード API をサポートするようにアダプタを更新しました。
• 最低限必要な Google Mobile Ads SDK のバージョンを 17.2.0 に更新しました。

バージョン 3.0.0.1

• Unity 広告バナーのサポートを追加しました。

バージョン 3.0.0.0

• Unity Ads SDK 3.0.0 との互換性を検証しました。

バージョン 2.3.0.0

• Unity Ads SDK 2.3.0 との互換性を検証しました。

バージョン 2.2.1.1

• onRewardedVideoComplete() 広告イベントを呼び出すようにアダプタを更新しました。

バージョン 2.2.1.0

• Unity Ads SDK 2.2.1 との互換性を検証しました。

バージョン 2.2.0.0

• Unity Ads SDK 2.2.0 との互換性を検証しました。

バージョン 2.1.2.0

• Unity Ads SDK 2.1.2 との互換性を検証しました。

バージョン 2.1.1.0

• Unity Ads SDK 2.1.1 との互換性を検証しました。

バージョン 2.1.0.0

• Unity Ads SDK 2.1.0 に対応するようにアダプターを更新しました。

バージョン 2.0.8.0

• Unity Ads SDK 2.0.8 との互換性を検証しました。

バージョン 2.0.7.0

• Unity Ads のクリック レポート（AdMob および Unity Ads のクリック統計情報）を使用して、 一致します）。
• onAdLeftApplication コールバックのサポートを追加しました。

バージョン 2.0.6.0

• Unity Ads SDK 2.0.6 との互換性を検証しました。

バージョン 2.0.5.0

• 次のコードを追加することで、アダプターをコンパイルの依存関係として追加できるようになりました。 build.gradle ファイルの依存関係タグに追加します。 compile 'com.google.ads.mediation:unity:2.0.5.0'
• アダプターを jar ファイルではなく AAR として配布するように移行しました （詳細な手順については、README をご覧ください）。

バージョン 2.0.4.0

• 動画リワード広告の失敗時に、動画リワード広告の読み込みに失敗するバグを修正しました。 最初にインタースティシャル広告が読み込まれました。

バージョン 2.0.2.0

• バージョン命名システムを [Unity Ads SDK バージョン].[アダプター パッチ バージョン]。
• Unity Ads SDK の最小要件を v2.0.2 に更新しました。
• 最低限必要な Google Mobile Ads SDK を v9.0.0 に更新しました。
• アプリで UnityAds.changeActivity(this) を呼び出す必要はなくなりました。

バージョン 1.0.0

• 初版リリース。報酬ベースの動画広告とインタースティシャル広告をサポートします。