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

プラットフォームを選択: Android iOS Unity Flutter Android（以前のバージョン）

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

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

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

統合
入札
ウォーターフォール  1
フォーマット
バナー
インタースティシャル
特典

前提条件

続行する前に、次のことを確認してください。

  • 最新の Google Mobile Ads Flutter Plugin バージョン。
  • Flutter フレームワーク バージョン 3.7.0 以降。
  • [入札の場合]: 入札でサポートされているすべての広告フォーマットを統合するには、Unity Ads 1.1.0 以降用の Google Mobile Ads メディエーション プラグインを使用します（最新バージョンを推奨）。
  • Android にデプロイする場合
    • Android API レベル 24 以降。
  • iOS にデプロイするには
    • iOS のデプロイ ターゲット 13.0 以降。
  • Google Mobile Ads Flutter Plugin で構成された正常に動作する Flutter プロジェクト。詳細については、Google Mobile Ads Flutter Plugin の設定をご覧ください。
  • メディエーションを設定する

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

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

    プロジェクトを作成する

    Unity Ads ダッシュボードで、[プロジェクト] に移動し、[新規] をクリックします。

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

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

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

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

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

    入札

    ウォーターフォール

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

    ゲーム ID をメモします。

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

    [Unity Ads Monetization] > [Placements] に移動し、プロジェクトを選択して [広告ユニットを追加] をクリックします。

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

    Android

    iOS

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

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

    Android

    iOS

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

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

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

    Unity Ads Reporting API キーを確認する

    入札

    このステップは、入札の統合では必要ありません。

    ウォーターフォール

    [Unity Ads Monetization] > [API 管理] に移動し、[Monetization Stats API Access] の [API キー] をメモします。

    次に、[Unity Ads Monetization] > [Organization Settings] に移動し、[Organization core ID] をメモします。

    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] に移動します。

    アプリでテストモードを強制的に有効にするには、各プラットフォームの編集ボタンをクリックし、[Override client test mode] を有効にして、[Force test mode ON (i.e. use test ads) for all devices] を選択します。

    Android

    iOS

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

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

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

    広告ユニットのメディエーション設定を構成する

    Android

    手順については、Android のガイドの手順 2 をご覧ください。

    iOS

    手順については、iOS のガイドの手順 2 をご覧ください。

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

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

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

    pub.dev を介した統合

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

    dependencies:
  gma_mediation_unity: ^1.11.1

    手動による統合

    Unity Ads 用の Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、ダウンロードしたファイルを解凍して、解凍したプラグイン フォルダ（およびそのコンテンツ）を Flutter プロジェクトに追加します。次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

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

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

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

    Unity Ads Flutter アダプタ バージョン 1.10.0 以降では、IAB の透明性と同意に関するフレームワーク（TCF）と統合されている同意管理プラットフォームから Unity Ads 広告 SDK に GDPR 同意シグナルを渡すことがサポートされています。詳しくは、TCF または非 TCF の同意設定を行うをご覧ください。

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

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

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

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

GmaMediationUnity.setCCPAConsent(true);

    年齢に応じた取り扱いを設定する

    Unity Ads メディエーション プラグイン バージョン 1.6.5 以降では、子供向けの設定と同意年齢に満たないユーザーの設定が Unity Ads に転送されます。

    これらのシグナルをユーザーごとに処理するには、Unity Monetization ダッシュボードで混合オーディエンスの指定を有効にする必要があります。プロジェクトで混合対象年齢指定を有効にする方法について詳しくは、ゲームレベルの年齢指定を設定するをご覧ください。

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

    Android

    Unity Ads Android 統合では、追加のコードは必要ありません。

    iOS

    SKAdNetwork の統合

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

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

    テスト広告を有効にする

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

    テスト広告を確認する

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

    エラーコード

    アダプタが 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 UI で設定された UnityAds サーバー パラメータが存在しないか、無効です。
    102 UnityAds が NO_FILL 状態のプレースメントを返しました。
    103 UnityAds が、DISABLED 状態のプレースメントを返しました。
    104 UnityAds が null コンテキストで広告を表示しようとしました。
    105 Unity Ads からの広告の初期化、読み込み、表示に使用されるコンテキストが、Activity インスタンスではありません。
    106 UnityAds が、表示する準備ができていない広告を表示しようとしました。
    107 UnityAds はデバイスでサポートされていません。
    108 UnityAds では、プレースメントごとに一度に 1 つの広告しか読み込むことができません。
    109 UnityAds がエラー状態で終了しました。
    110 リクエストされた広告サイズが UnityAds でサポートされているバナーサイズと一致しません。
    111 UnityAds から初期化エラーが返されました。
    112 Unity Ads から null または空の入札トークンが返されました。
    200-204 UnityAds バナーの特定のエラー。詳しくは、コードをご覧ください。

    iOS

    0～9 UnityAds SDK がエラーを返しました。詳しくは、Unity のドキュメントをご覧ください。
    101 アド マネージャーの管理画面で設定された UnityAds サーバー パラメータが不足しているか、無効です。
    102 デバイスが UnityAds でサポートされていません。
    103 UnityAds の表示がエラー状態 kUnityAdsFinishStateError で終了しました。
    104 初期化子を呼び出した後、Unity 広告オブジェクトが nil になる。
    105 広告の準備ができていないため、Unity Ads を表示できませんでした。
    107 UnityAds が、プレースメントの状態 kUnityAdsPlacementStateDisabled でプレースメント変更コールバックを呼び出しました。
    108 このプレースメントにはすでに広告が読み込まれています。UnityAds SDK は、同じプレースメントの複数の広告の読み込みをサポートしていません。
    109 UnityAds から返されたバナー広告が、リクエストされたサイズと一致しません。
    110 UnityAds から初期化エラーが返されました。
    111 サポートされていない広告フォーマットです。
    112 UnityAds から null または空の入札トークンが返されました。

    Unity Ads Flutter メディエーション アダプタの変更履歴

    バージョン 1.11.1

    バージョン 1.11.0

    バージョン 1.10.0

    バージョン 1.9.0

    バージョン 1.8.1

    バージョン 1.8.0

    バージョン 1.7.0

    バージョン 1.6.5

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.6.4

    バージョン 1.6.3

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.6.2

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.6.1

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.6.0

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.5.1

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.5.0

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.4.1

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.4.0

    • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

    バージョン 1.3.0

    • Google Mobile Ads Flutter プラグイン バージョン 5.3.1 でビルドおよびテスト済みです。

    バージョン 1.2.0

    • Google Mobile Ads Flutter プラグイン バージョン 5.3.1 でビルドおよびテスト済みです。

    バージョン 1.1.0

    • Google Mobile Ads Flutter プラグイン バージョン 5.2.0 でビルドおよびテスト済みです。

    バージョン 1.0.0

    • Google Mobile Ads Flutter プラグイン バージョン 5.0.0 でビルドおよびテスト済みです。