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

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

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

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

要件

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

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

Unity 広告にお申し込みまたはログインしてください。

プロジェクトを作成する

Unity 広告ダッシュボードで、[Projects] に移動し、[Create Project] をクリックします。

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

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

[プロジェクトの設定] モーダルで、[メディエーション パートナー] に [I plan to use Mediation] と [Google AdMob] を選択し、[Next] をクリックします。

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

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

ゲーム ID をメモしておきます。

広告ユニットを作成する

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

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

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

プレースメントを追加

Unity Ads Reporting API キーを探す

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

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

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

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

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

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

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

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

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

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

pub.dev による統合

最新バージョンの SDK とともに次の依存関係を追加します。 Unity Ads パッケージ内の SDK とアダプタ pubspec.yaml ファイル:

dependencies:
  gma_mediation_unity: ^1.0.0

手動統合

最新バージョンの Google モバイル広告メディエーション プラグイン Unity Ads ダウンロードしたファイルを解凍し、抽出したプラグイン フォルダを追加します。 （およびその内容）を Flutter プロジェクトに追加します。次に、Terraform でプラグインを pubspec.yaml ファイルに次の依存関係を追加します。

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

EU の同意と GDPR

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

Unity 広告用の Google Mobile Ads メディエーション プラグイン 含まれる GmaMediationUnity.setGDPRConsent() メソッドを呼び出します。次のサンプルコードは、同意情報を Unity Ads SDKこのメソッドを呼び出す場合は、 Google Mobile Ads SDK を使って 広告をリクエストする前に

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setGDPRConsent(true);

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

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

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

Unity 広告用の Google Mobile Ads メディエーション プラグイン 含まれる GmaMediationUnity.setCCPAConsent() メソッドを呼び出します。次のサンプルコードは、同意情報を Unity Ads SDKこのメソッドを呼び出す場合は、 Google Mobile Ads SDK を使って 広告をリクエストする前に

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

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

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

GADMAdapterUnity
GADMediationAdapterUnity

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

Unity 広告の Flutter メディエーション アダプタに関する変更履歴

バージョン 1.0.0

• 初回リリース。
• Unity Android アダプター バージョン 4.10.0.0 との互換性を検証済み
• Unity iOS アダプター バージョン 4.10.0.0 との互換性を検証済み