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

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

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

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

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

要件

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

ステップ 1: Liftoff 収益化 UI で設定を行う

Liftoff Monetize アカウントに登録するか、ログインします。

[アプリケーションを追加] ボタンをクリックして、アプリを Liftoff 収益化ダッシュボードに追加します。

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

アプリが作成されたら、Liftoff の [Monetize Applications] ダッシュボードでアプリを選択します。

アプリ ID をメモします。

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

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

新しいプレースメントを追加する方法の詳細は次のとおりです。

参照 ID をメモし、[OK] をクリックします。

Reporting API キーを確認する

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

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

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

ステップ 2: AdMob UI で Liftoff Monetize デマンドを設定する

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

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

GDPR 設定と 米国の州の規制設定の手順に沿って、AdMob 管理画面の 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 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");

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

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

米国の州のプライバシー法 は、ユーザーに「個人情報」の「販売」を拒否する権利を保障する法律で、「販売者」パーティのホームページにある「個人情報を販売しない」リンクから販売を拒否することができます。米国の州のプライバシー関連法の遵守ガイドでは、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);

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

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

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

テスト広告を有効にする

AdMob にテストデバイスを登録し、Liftoff 収益化 UI でテストモードを有効にしてください。

テスト広告を確認する

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

エラーコード

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

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

Vungle SDK から発生したエラーについては、エラーコード: iOS と Android の Vungle SDK をご覧ください。

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

次のバージョン

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

バージョン 1.1.0

• Liftoff Monetize Android アダプター バージョン 7.4.0.1 との互換性が確認されました
• LiftoffMonetize iOS アダプター バージョン 7.4.0.1 との互換性を確認しました
• Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テストされています。

バージョン 1.0.0

• 初回リリース。
• Liftoff Monetize Android アダプター バージョン 7.3.1.0 との互換性が確認されました
• LiftoffMonetize iOS アダプター バージョン 7.3.2.0 との互換性が確認されました
• Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルド、テストされています。