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

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

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

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

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

バナー広告（MREC バナーを除く）はメディエーションでのみサポートされています。入札では、どのタイプのバナー広告もサポートされていません。

要件

  • 最新の Google Mobile Ads SDK
  • Unity 5.6 以降
  • [入札の場合]: AppLovin 4.2.0 以降用の Google モバイル広告メディエーション プラグイン（最新バージョンを推奨）
  • Android にデプロイするには
    • Android API レベル 21 以降
  • iOS にデプロイするには
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google Mobile Ads SDK で構成された Unity 作業中のプロジェクト。詳しくは、使ってみるをご覧ください。
  • メディエーションのスタートガイドを完了している。

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

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

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

入札を統合するだけの場合は、メディエーション設定を構成するに進んでください。

メディエーション対象のアプリを選択

入札

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

ウォーターフォール

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

ゾーンを作成する

入札

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

ウォーターフォール

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

ゾーン ID の名前を入力し、[プラットフォーム] として [Android] を選択して、[広告タイプ] を選択します。

[フラット CPM] または [AppLovin によって最適化] を選択して、ゾーンの料金を構成します。フラット CPM オプションの場合、CPM は国ごとに設定できます。[保存] をクリックします。

Android

iOS

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

Android

iOS

Ad Manager

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

AppLovin のテスト広告を有効にする方法については、AppLovin の MAX テストモード ガイドをご覧ください。

ステップ 2: UI で AppLovin デマンドを設定する Ad Manager

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

Android

手順については、 Android。

iOS

手順については、 iOS。

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

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

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

変更履歴のダウンロード リンクから AppLovin 用 Google Mobile Ads メディエーション プラグインの最新バージョンをダウンロードし、zip ファイルから GoogleMobileAdsAppLovinMediation.unitypackage を抽出します。

Unity プロジェクト エディタで、[Assets] > [Import Package] > [Custom Package] を選択し、ダウンロードした GoogleMobileAdsAppLovinMediation.unitypackage ファイルを見つけます。すべてのファイルのチェックボックスがオンになっていることを確認して、[Import]（インポート）をクリックします。

次に、[Assets] > [Play Services Resolver] > [Android Resolver] > [Force Resolve] を選択します。Unity Play 開発者サービス リゾルバ ライブラリは、依存関係の解決をゼロから実行し、宣言された依存関係を Unity アプリの Assets/Plugins/Android ディレクトリにコピーします。

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

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

Google モバイル広告メディエーション プラグイン バージョン 7.0.0 以降 AppLovin では、共有設定から同意文字列を読み取り、それに応じて同意ステータスを設定できるようになりました。

Applovin バージョン 7.0.0 以降用の Google モバイル広告メディエーション プラグインを 使用していない場合、または 同意文字列を共有設定に書き込む CMP を使用していない場合、 AppLovin.SetHasUserConsent() メソッド、 AppLovin.SetIsAgeRestrictedUser() メソッドを使用できます。次のサンプルコードは、同意情報を AppLovin SDK に渡す方法を示しています。これらのオプションは、AppLovin SDK に正しく転送されるように、Google Mobile Ads SDK を初期化する前に設定する必要があります。

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

また、ユーザーが年齢制限カテゴリに属していることがわかっている場合は、以下のフラグを true に設定することもできます。

AppLovin.SetIsAgeRestrictedUser(true);

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

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

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

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

詳細については、AppLovin のプライバシー ドキュメントをご覧ください。

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

Android

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

iOS

SKAdNetwork との統合

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

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

テスト広告を有効にする

Ad Manager にテストデバイスを登録し、 AppLovin UI でテストモードを有効にします。

テスト広告を確認する

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

省略可能なステップ

最適化

AppLovin.Initialize() の呼び出しを起動アクティビティに追加すると、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 Adapter でサポートされていません。

iOS

エラーコード 理由
-1009 から -1, 204 AppLovin SDK からエラーが返されました。詳しくは、AppLovin のドキュメントをご覧ください。
101 リクエストされた広告サイズが、AppLovin でサポートされているバナーサイズと一致しません。
102 UI で設定されている AppLovin サーバー パラメータがないか、無効です。 Ad Manager
103 AppLovin 広告を表示できませんでした。
104 同じゾーンの複数の広告をリクエストしました。AppLovin で一度に読み込める広告は、ゾーンごとに 1 つのみです。
105 AppLovin SDK キーが見つかりません。
107 入札トークンが空です。
108 リクエストされた広告フォーマットは AppLovin Adapter でサポートされていません。
110 AppLovin は読み込みのコールバックを正常に送信しましたが、広告は 0 件読み込まれました。

AppLovin Unity メディエーション プラグインの変更履歴

バージョン 7.3.1

バージョン 7.3.0

バージョン 7.2.2

バージョン 7.2.1

バージョン 7.2.0

バージョン 7.1.0

バージョン 7.0.1

バージョン 7.0.0

バージョン 6.9.1

バージョン 6.9.0

バージョン 6.8.0

バージョン 6.7.0

バージョン 6.6.0

バージョン 6.5.1

バージョン 6.5.0

バージョン 6.4.3

バージョン 6.4.2

バージョン 6.4.1

バージョン 6.4.0

バージョン 6.3.1

バージョン 6.3.0

バージョン 6.2.1

バージョン 6.2.0

バージョン 6.1.0

バージョン 6.0.0

バージョン 5.1.3

バージョン 5.1.2

バージョン 5.1.1

バージョン 5.1.0

バージョン 5.0.0

バージョン 4.8.1

バージョン 4.8.0

バージョン 4.7.0

バージョン 4.6.2

バージョン 4.6.1

バージョン 4.6.0

バージョン 4.5.8

バージョン 4.5.7

バージョン 4.5.6

バージョン 4.5.5

バージョン 4.5.4

バージョン 4.5.3

バージョン 4.5.2

バージョン 4.5.1

バージョン 4.5.0

バージョン 4.4.1

バージョン 4.4.0

バージョン 4.3.0

バージョン 4.2.0

  • AppLovin Android アダプター バージョン 9.4.2.0 をサポートします。
  • AppLovin iOS アダプタ バージョン 6.6.1.0 をサポートします。

バージョン 4.1.0

  • 新しいオープンベータ版の リワード API をサポートするようプラグインを更新しました。
  • AppLovin Android アダプター バージョン 9.2.1.1 をサポートします。
  • AppLovin iOS アダプタ バージョン 6.3.0.0 をサポートします。

バージョン 4.0.0

  • AppLovin Android アダプター バージョン 9.2.1.0 をサポートします。
  • AppLovin iOS アダプタ バージョン 6.2.0.0 をサポートします。

バージョン 3.1.2

  • AppLovin Android アダプター バージョン 8.1.4.0 をサポートします。
  • AppLovin iOS アダプタ バージョン 5.1.2.0 をサポートします。

バージョン 3.1.1

  • AppLovin Android アダプター バージョン 8.1.0.0 をサポートします。
  • AppLovin iOS アダプタ バージョン 5.1.1.0 をサポートします。

バージョン 3.1.0

  • AppLovin Android アダプター バージョン 8.1.0.0 をサポートします。
  • AppLovin iOS アダプタ バージョン 5.1.0.0 をサポートします。

バージョン 3.0.3

  • AppLovin Android アダプター バージョン 8.0.2.1 をサポートします。
  • AppLovin iOS アダプタ バージョン 5.0.2.0 をサポートします。

バージョン 3.0.2

  • AppLovin Android SDK バージョン 8.0.1 をサポートします。
  • AppLovin iOS SDK バージョン 5.0.1 をサポートします。

バージョン 3.0.1

  • AppLovin Android SDK バージョン 8.0.0 をサポートします。
  • AppLovin iOS SDK バージョン 5.0.1 をサポートします。
  • ユーザーが年齢制限のあるカテゴリに属しているかどうかを示す AppLovin.SetIsAgeRestrictedUser() メソッドを追加しました。

バージョン 3.0.0

  • AppLovin Android SDK バージョン 8.0.0 をサポートします。
  • AppLovin iOS SDK バージョン 5.0.1 をサポートします。
  • ユーザーの同意フラグを AppLovin SDK に転送するための AppLovin.SetHasUserConsent() メソッドを追加しました。

バージョン 2.0.0

  • AppLovin Android SDK バージョン 7.8.6 をサポートします。
  • AppLovin iOS SDK バージョン 5.0.1 をサポートします。

バージョン 1.2.1

  • AppLovin Android SDK バージョン 7.8.6 をサポートします。
  • AppLovin iOS SDK バージョン 4.8.3 をサポートします。

バージョン 1.2.0

  • AppLovin Android SDK バージョン 7.8.5 をサポートします。
  • AppLovin iOS SDK バージョン 4.8.3 をサポートします。

バージョン 1.1.0

  • AppLovin Android SDK バージョン 7.7.0 をサポートします。
  • AppLovin iOS SDK バージョン 4.7.0 をサポートします。

バージョン 1.0.0

  • 初リリース
  • AppLovin Android SDK バージョン 7.4.1 をサポートします。
  • AppLovin iOS SDK バージョン 4.4.1 をサポートします。