このガイドでは、Google Mobile Ads SDK を使用して、Google Mobile Ads SDK を読み込んで表示する方法を説明します。 メディエーションを使用して Unity Ads から配信する ウォーターフォール統合に対応していますUnity 広告を広告ユニットの広告ユニット Unity Ads SDK とアダプタを Google Cloud の Flutter アプリ
サポートされている統合と広告フォーマット
Unity 広告用の AdMob メディエーション アダプタには、 次のような機能があります。
統合 | |
---|---|
単価設定 | 1 |
滝 | |
フォーマット | |
バナー | |
インタースティシャル | |
特典 |
要件
- 最新の Google Mobile Ads SDK
- Flutter 3.7.0 以降
- Android にデプロイする
<ph type="x-smartling-placeholder">
- </ph>
- Android API レベル 21 以降
- iOS にデプロイする場合
<ph type="x-smartling-placeholder">
- </ph>
- iOS デプロイ ターゲットが 12.0 以降であること
- Google で構成された Flutter 作業プロジェクト Mobile Ads SDK があります。詳しくは、 スタートガイドをご覧ください。
- メディエーションを完了する スタートガイド
ステップ 1: Unity 広告 UI で設定をセットアップする
Unity 広告にお申し込みまたはログインしてください。
プロジェクトを作成する
Unity 広告ダッシュボードの [プロジェクト] をクリックし、[プロジェクトを作成] をクリックします。
フォームに入力し、[プロジェクトを作成] をクリックしてプロジェクトを追加します。
[収益化] >[開始] をクリックし、[開始] をクリックします。
[Project Setup](プロジェクトの設定)モーダルで [I plan to use Mediation](メディエーションを使用する)を選択し、[Google メディエーション パートナーの AdMob を選択し、[次へ] をクリックします。
広告設定を選択し、[次へ] をクリックします。
フォームに入力し、[プロジェクトを追加] をクリックします。
ゲーム ID をメモしておきます。
広告ユニットを作成する
[収益化] >[広告ユニット] で [広告ユニットを追加] をクリックします。
[広告ユニット名] を入力し、[プラットフォーム] と [広告フォーマット] を選択します。
Android
iOS
最後に、[作成] をクリックして広告ユニットを保存します。
プレースメントを追加
単価設定
入札プレースメントを作成するには、Google アカウント マネージャーにお問い合わせください。
滝
プロジェクトが作成されたら、[収益化] >プレースメント。宛先 新しいプレースメントを作成するには、広告ユニットに [プレースメントを追加] をクリックします。
必要な情報を入力して [プレースメントを追加] をクリックします。
プレースメント ID をメモしておきます。
Android
iOS
Unity Ads Reporting API キーの場所を確認する
単価設定
入札の統合では不要です。
滝
[ゲーム ID] と [プレースメント ID] に加えて、 Unity Ads の API キーと組織コア ID を設定します。 AdMob 広告ユニット ID。
[収益化] >設定 >API 管理] に移動し、 Monetization Stats API アクセスキー。
次に、[収益化] >[Organization Settings] に移動し、 Organization Core ID の値です。
テストモードをオンにする
テストモードは Unity 広告ダッシュボード。プロジェクトの [テスト] タブを選択します。
各アプリの編集ボタンをクリックすると、アプリを強制的にテストモードにできます。 [Override client test mode] をオンにして、 すべてのデバイスで強制的にテストモードをオン(テスト広告を使用)します。
Android
iOS
または、 [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: 必要なコードを追加する
Android
Unity 広告 Android との統合に必要な追加のコードはありません。
iOS
SKAdNetwork との統合
Unity 広告のドキュメント
プロジェクトの Info.plist
ファイルに SKAdNetwork 識別子を追加します。
ステップ 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 広告からの広告の初期化、読み込み、表示に使用されるコンテキストは、Activity インスタンスではありません。 |
106 | UnityAds が表示準備が完了していない広告を表示しようとしました。 |
107 | UnityAds がデバイスではサポートされていません。 |
108 | UnityAds は、プレースメントごとに一度に 1 つの広告しか読み込めません。 |
109 | UnityAds がエラー状態で終了しました。 |
200-204 | UnityAds バナーで特定のエラー。コードをご覧ください。 をご覧ください。 |
iOS
0~9 | UnityAds SDK からエラーが返されました。Unity のドキュメントをご覧ください。 をご覧ください。 |
101 | AdMob 管理画面で設定されている UnityAds サーバー パラメータがないか、無効です。 |
102 | デバイスが UnityAds でサポートされていません。 |
103 | UnityAds がエラー状態 kUnityAdsFinishStateError での表示を終了しました。 |
104 | イニシャライザを呼び出した後の Unity 広告オブジェクトは nil です。 |
105 | 広告の準備ができていないため、Unity 広告を表示できませんでした。 |
106 | UnityAds が、プレースメントの状態 kUnityAds プレースメント StateNoFill でプレースメント変更コールバックを呼び出しました。 |
107 | UnityAds が、プレースメントの状態を kUnityAds PlacementStateDisabled にして、プレースメント変更コールバックを呼び出しました。 |
108 | このプレースメントには広告がすでに読み込まれています。UnityAds SDK では、同じプレースメントに複数の広告を読み込むことはできません。 |
Unity 広告の Flutter メディエーション アダプタに関する変更履歴
バージョン 1.0.0
- 初回リリース。
- Unity Android アダプター バージョン 4.10.0.0 との互換性を検証済み
- Unity iOS アダプター バージョン 4.10.0.0 との互換性を検証済み