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

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

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

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

統合
入札
ウォーターフォール
形式
バナー  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 アカウントに登録またはログインします。

AdMob 広告ユニットを設定するには、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

AdMob

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

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 の広告配信について制限付きデータ処理を有効にすることができますが、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 のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

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

テスト広告を有効にする

AdMob にテストデバイスを登録し、 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 アダプタは、リクエストされた広告フォーマットをサポートしていません。

iOS

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

AppLovin Unity メディエーション プラグインに関する変更履歴

バージョン 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 をサポートします。