このガイドでは、Google Mobile Ads SDK を使用して、メディエーションを使用して Liftoff Monetize の広告を読み込んで表示する方法について説明します。入札とウォーターフォールの両方の統合について説明します。広告ユニットに Liftoff Monetize を Vungle SDK とアダプターを Flutter アプリ
サポートされている統合と広告フォーマット
統合 | |
---|---|
単価設定 | |
滝 | |
フォーマット | |
アプリの起動 | 1, 3 |
バナー | 2 |
インタースティシャル | |
特典 | |
リワード インタースティシャル | 2 |
1 このフォーマットの入札の統合はクローズド ベータ版です。
2 入札 このフォーマットの統合はオープンベータ版です。
3 ウォーターフォール このフォーマットの統合はクローズド ベータ版です。
要件
- 最新の Google Mobile Ads SDK
- Flutter 3.7.0 以降
- Android にデプロイする
- Android API レベル 21 以降
- iOS にデプロイする場合
- iOS デプロイ ターゲットが 12.0 以降であること
- 以下で構成された Flutter 作業プロジェクト Google Mobile Ads SDK詳しくは、 スタートガイドをご覧ください。
- メディエーションを完了する スタートガイド
ステップ 1: Liftoff 収益化 UI で設定を行う
Liftoff Monetize アカウントに登録またはログインします。
[Add Application] ボタンをクリックして、Liftoff Monetize ダッシュボードにアプリを追加します。
フォームに必要な情報をすべて入力します。
Android
iOS
アプリを作成したら、Liftoff Monetize Applications ダッシュボードからアプリを選択します。
Android
iOS
アプリ ID をメモします。
Android
iOS
新しいプレースメントを追加
メディエーションで使用する AdMob新しいプレースメントを作成するには、[Liftoff] の収益化プレースメント ダッシュボードに移動し、[Add Placement] ボタンをクリックしてプルダウン リストからアプリを選択します。
新しいプレースメントを追加する方法について詳しくは、下記をご覧ください。
アプリの起動
[インタースティシャル] を選択し、プレースメント名を入力します。[スキップ可能] で [はい] を選択し、フォームの残りの部分に入力します。[入札のみ] [収益化] で、[アプリ内入札] を [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。
バナー
[Banner] を選択し、プレースメント名を入力して、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。
300×250 のバナー
[MREC] を選択してプレースメント名を入力し、フォームの残りの部分に入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。
インタースティシャル
[インタースティシャル] を選択してプレースメント名を入力し、フォームの残りの部分に入力します。[入札のみ] [収益化] で、[アプリ内入札] を [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。
特典
[リワード] を選択してプレースメント名を入力し、フォームの残りの部分に入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。
リワード インタースティシャル
[リワード] を選択します。[プレースメント名] を入力し、[スキップ可能] を有効にして、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] を [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。
ネイティブ
[ネイティブ] を選択し、プレースメント名を入力して、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、プレースメントを作成します。
[Reference ID] をメモして、[Sounds Good] をクリックします。
アプリの起動
バナー
300×250 のバナー
インタースティシャル
特典
リワード インタースティシャル
ネイティブ
Reporting API キーを確認する
入札
入札の統合では、この手順は必要ありません。
ウォーターフォール
AdMob 広告ユニット ID を設定するには、アプリ ID と参照 ID に加えて、Liftoff Monetize Reporting API キーも必要です。Liftoff Monetize Reports ダッシュボードに移動し、[Reporting API Key] ボタンをクリックして Reporting API キーを表示します。
テストモードをオンにする
テスト広告を有効にするには、Liftoff Monetize ダッシュボードの [Applications] に移動します。
アプリの [プレースメント参照 ID] セクションで、テスト広告を有効にするアプリを選択します。テスト広告を有効にするには、[ステータス] セクションで [テストモード] から [テスト広告のみを表示] を選択します。
Android
iOS
ステップ 2: 管理画面で Liftoff Monetize デマンドを設定する AdMob
広告ユニットのメディエーション設定を行う
GDPR と米国の州規制の広告パートナー リストに Liftoff 追加
GDPR 設定 米国の州規制の設定 の手順に沿って、 AdMob UI の GDPR および米国の州規制の広告パートナーのリストに Liftoff を追加します。
ステップ 3: Vungle SDK と Liftoff Monetize アダプタをインポートする
pub.dev による統合
最新バージョンの SDK とともに次の依存関係を追加します。
Liftoff Monetize パッケージ内の SDK とアダプタ
pubspec.yaml
ファイル:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
手動統合
最新バージョンの Google モバイル広告メディエーション プラグイン
Liftoff Monetize
ダウンロードしたファイルを解凍し、抽出したプラグイン フォルダを追加します。
(およびその内容)を Flutter プロジェクトに追加します。次に、Terraform でプラグインを
pubspec.yaml
ファイルに次の依存関係を追加します。
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
ステップ 4: Liftoff Monetize SDK にプライバシー設定を実装する
EU の同意と GDPR
Google の EU ユーザーの同意に基づく ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID や個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則(GDPR)。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google はユーザーの同意に関する選択を自動的にこのようなネットワークに渡すことはできません。
Liftoff Monetize 用の Google Mobile Ads メディエーション プラグインには、GmaMediationLiftoffmonetize.setGDPRStatus()
メソッドが含まれています。次のサンプルコード
は、同意情報を Vungle SDK に渡す方法を示しています。次のオプションを選択した場合:
このメソッドを呼び出す場合は、広告をリクエストする前に、
Google Mobile Ads SDK を使用します
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
GDPR で推奨される実装手順を確認: Android、iOS: 詳細 メソッドで提供できる値を確認できます。
米国のプライバシー関連州法
米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトするユーザーの「個人情報」(法律で定められているとおり、 これらの規約を参照)に同意し、「Do Not Sell My Personal」という目立つページ 情報」[販売]ページのリンクに表示されます。米国の州のプライバシー関連法の遵守ガイドでは、Google 広告配信で制限付きデータ処理を有効にできますが、Google はメディエーション チェーン内の各広告ネットワークにこの設定を適用することはできません。そのため、個人情報の販売に関与する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークのガイダンスに沿ってコンプライアンスを確保する必要があります。
Liftoff Monetize 用の Google Mobile Ads メディエーション プラグインには、GmaMediationLiftoffmonetize.setCCPAStatus()
メソッドが含まれています。次のサンプルコード
は、同意情報を Vungle SDK に渡す方法を示しています。次のオプションを選択した場合:
このメソッドを呼び出す場合は、広告をリクエストする前に、
Google Mobile Ads SDK を使用します
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
CCPA で推奨される実装手順をご覧ください Android または iOS の詳細 メソッドで指定できる値。
ステップ 5: 必要なコードを追加する
Android
Liftoff Monetize の統合では、追加のコードは必要ありません。
iOS
SKAdNetwork との統合
Liftoff Monetize の
ドキュメント
プロジェクトの Info.plist
ファイルに SKAdNetwork 識別子を追加します。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob にテストデバイスを登録し、 Liftoff Monetize UI でテストモードを有効にします。
テスト広告を確認する
Liftoff Monetizeからテスト広告を受信していることを確認するには、広告インスペクタで Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) 広告ソースを使用して単独の広告ソースのテストを有効にします。
エラーコード
アダプタが Liftoff Monetize から広告を受け取れなかった場合、パブリッシャーは以下を行うことができます。
広告レスポンスからの根本的なエラーを確認する
次のクラスの ResponseInfo
:
Android
形式 | クラス名 |
---|---|
アプリ起動(入札) | com.google.ads.mediation.vungle.VungleMediationAdapter |
アプリ起動(ウォーターフォール) | com.google.ads.mediation.vungle.VungleMediationAdapter |
バナー(入札) | com.google.ads.mediation.vungle.VungleMediationAdapter |
バナー(ウォーターフォール) | com.vungle.mediation.VungleInterstitialAdapter |
インタースティシャル(入札) | com.google.ads.mediation.vungle.VungleMediationAdapter |
インタースティシャル(ウォーターフォール) | com.vungle.mediation.VungleInterstitialAdapter |
リワード(入札) | com.google.ads.mediation.vungle.VungleMediationAdapter |
リワード(ウォーターフォール) | com.vungle.mediation.VungleAdapter |
リワード インタースティシャル(入札) | com.google.ads.mediation.vungle.VungleMediationAdapter |
リワード インタースティシャル(ウォーターフォール) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
形式 | クラス名 |
---|---|
アプリ起動(入札) | GADMediationAdapterVungle |
アプリ起動(ウォーターフォール) | GADMediationAdapterVungle |
バナー(入札) | GADMediationAdapterVungle |
バナー(ウォーターフォール) | GADMAdapterVungleInterstitial |
インタースティシャル(入札) | GADMediationAdapterVungle |
インタースティシャル(ウォーターフォール) | GADMAdapterVungleInterstitial |
リワード(入札) | GADMediationAdapterVungle |
リワード(ウォーターフォール) | GADMAdapterVungleRewardBasedVideoAd |
リワード インタースティシャル(入札) | GADMediationAdapterVungle |
リワード インタースティシャル(ウォーターフォール) | GADMediationAdapterVungle |
広告の読み込みに失敗したときに、Liftoff Monetize アダプタによってスローされるコードと付随するメッセージは次のとおりです。
Android
エラーコード | 理由 |
---|---|
101 | 無効なサーバー パラメータ(アプリ ID やプレースメント ID など)。 |
102 | リクエストされたバナーサイズが有効な Liftoff Monetize 広告にマッピングされていません 指定します。 |
103 | Liftoff Monetize をリクエストするには、Activity コンテキストが必要です
できます。 |
104 | Vungle SDK では同じプレースメントの複数の広告を読み込めません あります。 |
105 | Vungle SDK を初期化できませんでした。 |
106 | Vungle SDK から読み込み完了のコールバックが返されましたが、 Banners.getBanner() または Vungle.getadvertising() が null を返しました。 |
107 | Vungle SDK が広告を再生する準備ができていません。 |
108 | Vungle SDK から無効な入札トークンが返されました。 |
iOS
エラーコード | 理由 |
---|---|
101 | 無効なサーバー パラメータ(アプリ ID やプレースメント ID など)。 |
102 | このネットワーク構成の広告はすでに読み込まれています。Vungle SDK 同じプレースメント ID に 2 つ目の広告を読み込むことはできません。 |
103 | リクエストされた広告サイズが、Liftoff Monetize でサポートされているバナーサイズと一致しません。 |
104 | Vungle SDK がバナー広告をレンダリングできませんでした。 |
105 | Vungle SDK で一度に読み込めるバナー広告は 1 つのみです( プレースメント ID です。 |
106 | Vungle SDK から、広告が再生できないことを示すコールバックが送信されました。 |
107 | Vungle SDK では広告を再生する準備ができていません。 |
Vungle SDK に起因するエラーについては、エラーコード: Vungle SDK for iOS and Android をご覧ください。
Liftoff Monetize Flutter メディエーション アダプターに関する変更履歴
バージョン 1.0.0
- 初回リリース。
- Liftoff Monetize Android アダプター バージョン 7.3.1.0 との互換性を検証しました
- LiftoffMonetize iOS アダプター バージョン 7.3.2.0 との互換性を検証しました
- Google Mobile Ads Flutter プラグインのバージョン 5.1.0 を使って作成、テストしています。