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

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

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

統合
入札
ウォーターフォール
フォーマット
アプリの起動	1、 3
バナー	2
インタースティシャル
特典
リワード インタースティシャル	2

¹ このフォーマットの入札統合はクローズド ベータ版です。

² このフォーマットの入札統合はオープンベータ版です。

³ このフォーマットのウォーターフォール統合はクローズド ベータ版です。

要件

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

ステップ 1: Liftoff Monetize UI で構成をセットアップする

Liftoff Monetize アカウントに登録またはログインします。

[Add Application] ボタンをクリックして、Liftoff Monetize ダッシュボードにアプリを追加します。

フォームに必要な情報をすべて入力します。

アプリを作成したら、Liftoff Monetize Applications ダッシュボードからアプリを選択します。

アプリ ID をメモします。

新しいプレースメントを追加

メディエーションで使用する AdMob新しいプレースメントを作成するには、[Liftoff] の収益化プレースメント ダッシュボードに移動し、[Add Placement] ボタンをクリックしてプルダウン リストからアプリを選択します。

新しいプレースメントを追加する方法について詳しくは、下記をご覧ください。

[Reference ID] をメモして、[Sounds Good] をクリックします。

Reporting API キーを確認する

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

テスト広告を有効にするには、Liftoff Monetize ダッシュボードの [Applications] に移動します。

アプリの [プレースメント参照 ID] セクションで、テスト広告を有効にするアプリを選択します。テスト広告を有効にするには、[ステータス] セクションで [テストモード] から [テスト広告のみを表示] を選択します。

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

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

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

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

ステップ 3: Vungle SDK と Liftoff Monetize アダプタをインポートする

pub.dev による統合

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

dependencies:
  gma_mediation_liftoffmonetize: ^1.0.0

手動統合

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

dependencies:
  gma_mediation_liftoffmonetize:
    path: path/to/local/package

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

EU の同意と GDPR

Google の EU ユーザーの同意ポリシーに基づき、デベロッパーは、デバイス ID および個人データの使用に関して欧州経済領域（EEA）のユーザーに対し特定の開示を行い、ユーザーから同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。同意を求める際は、個人データを収集、受信、または使用する可能性があるメディエーション チェーンの各広告ネットワークを特定し、各ネットワークの使用に関する情報を提供する必要があります。Google は現在、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

Liftoff Monetize 用の Google モバイル広告メディエーション プラグインには、GmaMediationLiftoffmonetize.setGDPRStatus() メソッドが含まれています。次のサンプルコードは、同意情報を Vungle SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に、このメソッドを呼び出すことをおすすめします。

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

GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");

詳細情報とメソッドで指定できる値については、Android および iOS 向けの GDPR 推奨実装手順をご覧ください。

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

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

Liftoff Monetize 用の Google モバイル広告メディエーション プラグインには、GmaMediationLiftoffmonetize.setCCPAStatus() メソッドが含まれています。次のサンプルコードは、同意情報を Vungle SDK に渡す方法を示しています。このメソッドを呼び出す場合は、Google Mobile Ads SDK を使用して広告をリクエストする前に、このメソッドを呼び出すことをおすすめします。

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

GmaMediationLiftoffmonetize.setCCPAStatus(true);

詳細とこのメソッドで指定できる値については、CCPA の推奨される実装手順（Android および iOS）をご覧ください。

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

エラーコード

アダプタが Liftoff Monetize から広告を受信できない場合、パブリッシャーは、次のクラスの ResponseInfo を使用して、広告レスポンスの根本的なエラーを確認できます。

広告の読み込みに失敗したときに、Liftoff Monetize アダプタがスローするコードとそのメッセージは次のとおりです。

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 を使って作成、テストしています。