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

プラットフォームを選択: Android iOS Unity Flutter

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

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

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

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

ウォーターフォールでサポートされているバナーサイズは 320×50 と 728×90 のみです。入札ではバナー広告はサポートされていません。

要件

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

ステップ 1: AppLovin UI で構成を設定する

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

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

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

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

入札

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

ウォーターフォール

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

ゾーンを作成する

入札

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

ウォーターフォール

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

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

[料金設定] で、[固定 CPM] または [AppLovin による最適化] のいずれかを選択して、ゾーンの料金設定を構成します。[固定 CPM] オプションでは、CPM を国ごとに設定できます。次に、[Save] をクリックします。

Android

iOS

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

Android

iOS

app-ads.txt を更新する

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

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

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

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

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

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

Android

手順については、Android のガイドの手順 2 をご覧ください。

iOS

手順については、iOS のガイドの手順 2 をご覧ください。

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

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

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合は、プロジェクトのルート ディレクトリから次のコマンドを実行して、Google Mobile Ads Applovin Mediation Plugin for Unity をプロジェクトにインストールできます。

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

Unity プロジェクト エディタで、[Edit] > [Project Settings] > [Package Manager] を選択して、Unity Package Manager の設定を開きます。

[Scoped Registries] タブで、次の詳細情報を使用して OpenUPM をスコープ付きレジストリとして追加します。

  • 名前: OpenUPM
  • URL: https://package.openupm.com
  • スコープ: com.google

OpenUPM の詳細

次に、[Window] > [Package Manager] に移動して Unity Package Manager を開き、プルダウン メニューから [My Registries] を選択します。

Unity Registries

[Google Mobile Ads Applovin Mediation] パッケージを選択し、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

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

Unity プロジェクト エディタで、[Assets]（アセット） > [Import Package]（インポート パッケージ） > [Custom Package]（カスタム パッケージ）を選択し、ダウンロードした GoogleMobileAdsApplovinMediation.unitypackage ファイルを探します。すべてのファイルが選択されていることを確認して、[インポート] をクリックします。

Unity からインポートする

次に、[Assets] > [External Dependency Manager] > [Android Resolver] > [Force Resolve] を選択します。External Dependency Manager ライブラリにより、依存関係の解決が最初から実行され、宣言された依存関係が Unity アプリの Assets/Plugins/Android ディレクトリにコピーされます。

Force Resolve

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

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

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

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

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

AppLovin.SetHasUserConsent(true);

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

AppLovin.SetIsAgeRestrictedUser(true);

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

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

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

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

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

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

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

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

AppLovin.SetDoNotSell(true);

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

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

Android

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

iOS

SKAdNetwork の統合

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

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

テスト広告を有効にする

AdMob 用のテストデバイスを登録し、Applovin の管理画面でテストモードを有効にしてください。

テスト広告を確認する

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

省略可能なステップ

最適化

起動アクティビティに 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 アダプタは、リクエストされた広告フォーマットをサポートしていません。
109 コンテキストが Activity インスタンスではありません。
110 SDK キーがありません。
112 ユーザーが子供である。
113 広告ユニット ID がありません。

iOS

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

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

バージョン 8.5.1

バージョン 8.5.0

バージョン 8.4.1

バージョン 8.4.0

バージョン 8.3.2

バージョン 8.3.1

バージョン 8.3.0

バージョン 8.2.1

バージョン 8.2.0

バージョン 8.1.1

バージョン 8.1.0

バージョン 8.0.4

バージョン 8.0.3

バージョン 8.0.2

バージョン 7.4.1

バージョン 7.4.0

バージョン 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

  • 新しいオープンベータ版の Rewarded 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 をサポートしています。