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

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

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

統合
単価設定
フォーマット
アプリの起動 1, 2
バナー 1
インタースティシャル
特典
リワード インタースティシャル 1
ネイティブ <ph type="x-smartling-placeholder"></ph> 12

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

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

要件

  • 最新の 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 に登録またはログインする アカウントを収益化します。

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

フォームに必要事項をすべて入力します。

Android

iOS

アプリを作成したら、 Liftoff Monetize Applications ダッシュボード

Android

iOS

アプリ ID をメモします。

Android

iOS

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

AdMob で使用する新しいプレースメントを作成するため 詳細ページの Liftoff Monetize Placements ダッシュボード [Add Placement] ボタンをクリックして、プルダウンからアプリを選択します。 選択します。

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

アプリの起動

[インタースティシャル] を選択し、プレースメント名を入力します。[スキップ可能] で [はい] を選択し、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックして、 あります。

[バナー] を選択し、[プレースメント名] を入力して、フォームの残りの部分を入力します。[入札のみ] [収益化] で [アプリ内入札] を切り替えます [Enabled] に切り替えます。ページの下部にある [続行] ボタンをクリックしてプレースメントを作成します。

300x250 バナー

[MREC] を選択し、[プレースメント名] の残りの部分を入力します。 フォームに入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページ下部にある [続行] ボタンをクリックします。 プレースメントを作成します

インタースティシャル

[インタースティシャル] を選択し、プレースメント名を入力して、残りを入力します。 表示されます。[入札のみ] [収益化] で、 [アプリ内入札] を [有効] に切り替えます。[続行] ボタンをクリックします。 プレースメントを作成します

特典

[リワード] を選択し、プレースメント名を入力して、フォームの残りの部分を入力します。[入札のみ] [収益化] で、[アプリ内入札] スイッチを [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックしてプレースメントを作成します。

リワード インタースティシャル

[リワード] を選択します。[プレースメント名] を入力し、[スキップ可能] を有効にしてから、 フォームの残りに入力します。[入札のみ] [収益化] で切り替えます [アプリ内入札] を [有効] に切り替えます。ページの下部にある [続行] ボタンをクリックしてプレースメントを作成します。

ネイティブ

[ネイティブ] を選択し、[プレースメント名] を入力して、フォームの残りの部分を入力します。[入札のみ] [収益化] で [アプリ内入札] を切り替えます [Enabled] に切り替えます。ページ下部にある [続行] ボタンをクリックします。 プレースメントを作成します

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

アプリの起動

300×250 のバナー

インタースティシャル

特典

リワード インタースティシャル

ネイティブ

Reporting API キーを確認する

単価設定

入札の統合では不要です。

アプリ ID参照 ID に加えて、次の情報も必要です。 Liftoff Monetize Reporting API Key にアクセスし、 AdMob 広告ユニット ID。[ Liftoff Monetize Reports ダッシュボード Reporting API キー ボタンをクリックして、Reporting API を表示します Key です。

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

テスト広告を有効にするには、Liftoff Monetize のダッシュボードにアクセスして、 アプリ

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

Android

iOS

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

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

Android

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

iOS

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

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 プロジェクトに追加します。次に、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 モバイル広告メディエーション プラグインには、 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」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドでは、 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられますそのため各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

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: 必要なコードを追加する

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.getNativeAd() が 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 では、プレースメント ID に関係なく、一度に 1 つのバナー広告のみを読み込むことができます。
106 Vungle SDK から、広告を再生できないことを示すコールバックが送信されました。
107 Vungle SDK では広告を再生する準備ができていません。

Vungle SDK に起因するエラーについては、エラーコード: Vungle SDK for iOS and Android をご覧ください。

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

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