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

プラットフォームを選択: Android（ベータ版） Android iOS Unity Flutter

このガイドでは、GMA Next-Gen SDK を使用して メディエーションで Unity Ads の広告を読み込んで表示する方法を、入札とウォーターフォールの統合を含めて説明します。また、広告ユニットのメディエーション設定に Unity Ads を追加する方法と、Unity Ads SDK とアダプタを Android アプリに統合する方法についても取り上げます。

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

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

要件

• Android API レベル 24 以降

• [入札の場合]: 入札でサポートされているすべての広告フォーマットを統合するには、Unity アダプタ 4.16.0.1 以降（最新バージョンを推奨）を使用します。

• GMA Next-Gen SDK の最新動画

• メディエーションのスタートガイドの手順を完了していること

ステップ 1: Unity Ads の管理画面で構成を設定する

Unity Ads に登録するか、ログインします。

プロジェクトを作成する

Unity Ads ダッシュボードで、[Projects] に移動し、[New] をクリックします。

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

[Unity Ads Monetization] に移動し、[Get started] をクリックします。

[New Project] モーダルで、[I will use Mediation] と [Mediation Partner] の [Google Admob] を選択し、[Next] をクリックします。

広告設定のオプションを選択し、[次へ] をクリックします。

プレースメント設定を選択し、[次へ] をクリックします。

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

ゲーム ID をメモします。

広告ユニットとプレースメントを作成する

[Unity Ads Monetization] > [Placements] に移動し、プロジェクトを選択して [Add ad unit] をクリックします。

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

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

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

[設定] で [ウォーターフォール] を選択します。[プレースメント] で、[プレースメント名]、[位置情報タグ]、[ターゲット] を入力します。

配置 ID をメモしておきます。

最後に、[広告ユニットを追加] をクリックして、広告ユニットとプレースメントを保存します。

Unity Ads Reporting API キーを確認する

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ作成していない場合は、アド マネージャー用の app-ads.txt ファイルを作成します。

Unity Ads に app-ads.txt を実装するには、app-ads.txt を初めて設定するをご覧ください。

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

テストモードは Unity Ads ダッシュボードから有効にできます。[Unity Ads Monetization] > [Testing] に移動します。

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

または、[テストデバイスを追加] をクリックして、特定のデバイスのテストモードを有効にすることもできます。

テストデバイスの詳細を入力して、[保存] をクリックします。

ステップ 2: アド マネージャーの管理画面で Unity Ads のデマンドを設定する

アド マネージャー アカウントにログインします。

[Companies] に Unity Ads を追加する

セキュア シグナルの共有を有効にする

入札リクエストでセキュア シグナルを共有する

SDK 入札のセキュア シグナルの共有を許可する

Unity Ads の入札を設定する

広告ユニットのマッピングを設定する

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

欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに Unity Ads を追加します。

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

Android Studio の統合（推奨）

アプリレベルの Gradle ファイルに、次の実装依存関係と構成を追加します。

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.16.6.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.16.6.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

手動による統合

1. GitHub リポジトリから最新の Unity Ads SDK（unity-ads.aar）をダウンロードして、プロジェクトに追加します。

2. Google の Maven リポジトリで Unity Ads アダプタ アーティファクトに移動します。最新バージョンを選択し、Unity Ads アダプタの .aar ファイルをダウンロードして、プロジェクトに追加します。

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

EU ユーザーからの同意と GDPR

Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

SDK バージョン 2.0.0 で、Unity Ads はプライバシー設定をサポートする API を追加しました。次のサンプルコードは、この同意情報を Unity Ads SDK に渡す方法を示しています。同意情報を Unity Ads SDK に手動で渡す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前にこのコードを呼び出すことをおすすめします。

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

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

詳細と各メソッドで指定できる値については、Unity Ads の GDPR への準拠をご覧ください。

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

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

SDK バージョン 2.0.0 で、Unity Ads はプライバシー設定をサポートする API を追加しました。次のサンプルコードは、この同意情報を Unity Ads SDK に渡す方法を示しています。同意情報を Unity Ads SDK に手動で渡す場合は、GMA Next-Gen SDK を通じて広告をリクエストする前にこのコードを呼び出すことをおすすめします。

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

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

詳細と各メソッドで指定できる値については、Unity Ads の消費者プライバシー法への準拠をご覧ください。

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

Activity コンテキストで広告を読み込む

バナー広告、インタースティシャル広告、ネイティブ広告の各フォーマットを読み込むときに Activity コンテキストを渡します。アクティビティ コンテキストがないと、広告の読み込みは失敗します。

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

テスト広告を有効にする

アド マネージャー用のテストデバイスを登録し、Unity Ads の管理画面でテストモードを有効にしてください。

テスト広告を確認する

Unity Ads からテスト広告を受信していることを確認するには、Unity Ads（入札）と Unity Ads（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。

エラーコード

アダプタが Unity Ads から広告を受け取れない場合は、次のクラスの ResponseInfo.getAdSourceResponses() を使用して、広告レスポンスからエラーの詳細を確認できます。

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

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