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

[プラットフォームを選択]: Android（ベータ版） 新規 Android iOS Unity Flutter

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

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

AppLovin 用の Ad Manager メディエーション アダプタには、次の機能があります。

統合
入札
ウォーターフォール
フォーマット
バナー  1
インタースティシャル
特典

ウォーターフォールでは、320x50 と 728x90 のバナーサイズのみがサポートされます。入札では、バナー広告はサポートされません。

要件

  • 最新の Google Mobile Ads Flutter Plugin
  • Flutter 3.7.0 以降
  • Android にデプロイする場合
    • Android API レベル 23 以降
  • iOS にデプロイする場合
    • iOS のデプロイ対象のバージョンが 13.0 以降であること
  • Google Mobile Ads Flutter Plugin で構成された正常に動作する Flutter プロジェクト。詳しくは、 を設定するGoogle Mobile Ads Flutter Pluginをご覧ください。
  • メディエーションを設定する。

ステップ 1: AppLovin の管理画面で構成を設定する

登録またはログイン して AppLovin アカウントにアクセスします。

Ad Manager 広告ユニットを設定するには、AppLovin のSDK キー とレポートキー が必要です。これらの値を確認するには、 [AppLovin の管理画面] > [Account] > [Keys] に移動します。

入札の統合のみを行う場合は、 メディエーション設定の構成に進みます。

メディエーションに使用するアプリを選択する

入札

入札の統合では、この手順は必要ありません。

ウォーターフォール

AppLovin の管理画面で、[Monetization] セクションの [Applications] を選択して、登録済みアプリに移動します。使用可能なアプリのリストから、メディエーションで使用するアプリを選択します。

ゾーンを作成する

入札

入札の統合では、この手順は必要ありません。

ウォーターフォール

AppLovin の管理画面で、[Monetization] セクションの [Zones] を選択して、登録済みゾーン ID に移動します。アプリに必要なゾーンをすでに作成している場合は、 ステップ 2に進みます。 新しいゾーン ID を作成するには、[Create Zone] をクリックします。

[Zone ID] の名前を入力し、[Platform] として [Android] を選択して、 [Ad Type] を選択します。

[Pricing] で [Flat CPM] または [Optimized by AppLovin] を選択して、ゾーンの価格設定を行います。[Flat CPM] オプションでは、国ごとにインプレッション単価を設定できます。次に、[Save] をクリックします。

Android

iOS

ゾーンが作成されると、[Zone ID] 列にゾーン ID が表示されます。

Android

iOS

app-ads.txt を更新する

アプリの認定販売者 app-ads.txt は、IAB Tech Lab が推進するイニシアチブで、承認されたチャネルでのみアプリ広告枠を販売できるようにするものです。広告収入の大幅な減少を防ぐためには、app-ads.txt ファイルを実装する必要があります。まだ設定していない場合は、 Ad Manager の app-ads.txt ファイルを作成します。

AppLovin に app-ads.txt を実装するには、 app-ads.txt ファイルに AppLovin を追加します。

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

AppLovin の MAX テストモード ガイドの手順に沿って、AppLovin のテスト広告を有効にします。

ステップ 2: アド マネージャーの管理画面で AppLovin のデマンドを設定する

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

Android

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

iOS

iOS

GDPR と米国の州規制の広告パートナー リストに AppLovin Corp. を追加する

欧州の規制に関する設定 と 米国の州の規制に関する設定 の手順に沿って、アド マネージャーの管理画面で 欧州および米国の州の規制に関する広告パートナーのリストにAppLovin Corp. を追加します。

ステップ 3: AppLovin の SDK とアダプタをインポートする

Google Mobile Ads Flutter Plugin

pub.dev を介した統合

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

dependencies:
  gma_mediation_applovin: ^2.5.2

手動による統合

AppLovin次に、次の依存関係を追加して、pubspec.yaml ファイルでプラグインを参照します。

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

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

Google の EU ユーザーの同意ポリシーに準拠する には、欧州経済領域（EEA）、英国、スイスの ユーザーに対して特定の情報を開示し、法律で 義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告の パーソナライズを目的とした個人データの収集、共有、使用について ユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。

AppLovin では、共有設定から同意文字列を読み取り、それに応じて同意ステータスを設定できます。

同意文字列を共有設定に書き込む CMP を使用していない場合は、 GmaMediationApplovin.setHasUserConsent() と GmaMediationApplovin.setIsAgeRestrictedUser() メソッドを使用できます。次のサンプルコードは、同意情報を AppLovin SDK に渡す方法を示しています。これらのオプションは、 AppLovin SDK に正しく転送されるように、初期化Google Mobile Ads Flutter Plugin する前に設定する必要があります。

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

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

詳しくは、AppLovin のプライバシー設定 をご覧ください。

子供のユーザーを宣言する

AppLovin SDK 13.0.0 以降では、AppLovin は年齢制限付きユーザーフラグをサポートしなくなりました。適用される法律で定義されている「子供」に関連して AppLovin SDK を初期化または使用することはできません。詳しくは、AppLovin の 「Prohibition on Children Data or Using the Services for Children or Apps Exclusively Targeted to Children」（子供のデータまたは子供向けのサービスやアプリの利用の禁止）に関するドキュメントを Android または iOS向けにご覧ください。

AppLovin 用の Google Mobile Ads Flutter メディエーション プラグインのバージョン 2.0.0 以降では、Google Mobile Ads Flutter Pluginで次のいずれかの設定を宣言しているアプリに対して、AppLovin メディエーションが自動的に無効になります。

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

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

AppLovin 用の Google Mobile Ads メディエーション プラグインには メソッドが含まれています。GmaMediationApplovin.setDoNotSell()次のサンプルコードは、同意情報を AppLovin SDK に渡す方法を示しています。これらのオプションは、Google Mobile Ads SDK を初期化する前に設定して、AppLovin SDK に正しく転送されるようにする必要があります。

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

GmaMediationApplovin.setDoNotSell(true);

詳しくは、AppLovin のプライバシー に関するドキュメント をご覧ください。

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

Android

AppLovin の統合には追加のコードは必要ありません。

iOS

SKAdNetwork の統合

AppLovin のドキュメント に沿って、プロジェクトの Info.plist` ファイルに SKAdNetwork 識別子を追加します。

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

テスト広告を有効にする

アド マネージャー用のテストデバイスを 登録し 、AppLovin の管理画面でテストモードを有効にしてください。

テスト広告を確認する

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

省略可能なステップ

ネットワーク固有のパラメータ

AppLovin アダプタでは、AppLovinMediationExtras オブジェクトを広告リクエストに渡して、ネットワーク固有のパラメータを設定できます。次のサンプルコードは、isMuted パラメータを使用して動画広告の音声を無効にする方法を示しています。

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

最適化

起動アクティビティに GmaMediationApplovin.initializeSdk('sdkKey') の呼び出しを追加すると、アプリの起動直後に AppLovin がイベントをトラッキングできるようになります。

エラーコード

アダプタが AppLovin から広告を受け取れない場合は、 パブリッシャーは ResponseInfoを使用して、広告レスポンスからエラーの詳細を 確認できます。

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

Android

エラーコード 理由
-1009 ～-1、204 AppLovin SDK がエラーを返しました。詳しくは、 AppLovin のドキュメント をご覧ください。
101 リクエストされた広告サイズが、AppLovin でサポートされているバナーサイズと一致しません。
103 コンテキストが null です。
104 AppLovin の入札トークンが空です。
105 同じゾーンに対して複数の広告がリクエストされました。AppLovin では、ゾーンごとに一度に 1 つの広告しか読み込めません。
106 広告を表示する準備ができていません。
108 AppLovin アダプタは、リクエストされた広告フォーマットをサポートしていません。
109 コンテキストがアクティビティ インスタンスではありません。
110 SDK キーが設定されていません。
112 ユーザーは子供です。
113 広告ユニット ID が設定されていません。

iOS

エラーコード 理由
-1009 ～-1、204 AppLovin SDK がエラーを返しました。詳しくは、AppLovin のドキュメント をご覧ください。
101 リクエストされた広告サイズが、AppLovin でサポートされているバナーサイズと一致しません。
102 アド マネージャーの管理画面で構成された AppLovin サーバー パラメータが設定されていないか、無効です。
103 AppLovin 広告を表示できませんでした。
104 同じゾーンに対して複数の広告がリクエストされました。AppLovin では、ゾーンごとに一度に 1 つの広告しか読み込めません。
105 AppLovin SDK キーが見つかりません。
107 入札トークンが空です。
108 AppLovin アダプタは、リクエストされた広告フォーマットをサポートしていません。
110 AppLovin は読み込み成功のコールバックを送信しましたが、読み込まれた広告は 0 件でした。
111 AppLovin SDK のインスタンスを取得できません。
112 ユーザーは子供です。
113 AppLovin SDK の共有インスタンスが初期化されていません。
114 AppLovin SDK が入札トークンを返せません。
115 広告ユニット ID が設定されていません。広告を読み込めません。
116 広告の準備ができていません。広告を表示できません。

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

バージョン 2.5.2

  • Google Mobile Ads Flutter プラグイン バージョン 7.0.0 でビルドおよびテスト済みです。

バージョン 2.5.1

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.5.0

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.4.0

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.3.2

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.3.1

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.3.0

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.2.1

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.2.0

  • Google Mobile Ads Flutter プラグイン バージョン 6.0.0 でビルドおよびテスト済みです。

バージョン 2.1.0

  • Google Mobile Ads Flutter プラグイン バージョン 5.3.1 でビルドおよびテスト済みです。

バージョン 2.0.0

  • Google Mobile Ads Flutter プラグイン バージョン 5.3.1 でビルドおよびテスト済みです。

バージョン 1.2.0

  • Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルドおよびテスト済みです。

バージョン 1.1.0

  • Google Mobile Ads Flutter プラグイン バージョン 5.1.0 でビルドおよびテスト済みです。

バージョン 1.0.0

  • 初回リリース。
  • Google Mobile Ads Flutter プラグイン バージョン 5.0.0 でビルドおよびテスト済みです。