Liftoff Monetize をメディエーションと統合する

このガイドでは、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

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

Android

手順については、 Android 向けガイドのステップ 2 をご覧ください。

iOS

手順については、 iOS 向けガイドのステップ 2 をご覧ください。

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 にプライバシー設定を実装する

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 で推奨される実装手順を確認: AndroidiOS: 詳細 メソッドで提供できる値を確認できます。

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

米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトするユーザーの「個人情報」(法律で定められているとおり、 これらの規約を参照)に同意し、「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 を使って作成、テストしています。