このガイドでは、GMA Next-Gen SDK を使用して AdMob メディエーションで AppLovin の広告を読み込んで表示する方法を、ウォーターフォール統合と入札統合の両方を含めて説明します。また、広告ユニットのメディエーション設定に AppLovin を追加する方法と、AppLovin SDK とアダプタを Android アプリに統合する方法についても取り上げます。
サポートされている統合と広告フォーマット
AppLovin 用のメディエーション アダプタには、次の機能があります。
| 統合 | |
|---|---|
| 入札 | |
| ウォーターフォール | |
| フォーマット | |
| アプリの起動 | 1 |
| バナー | 2 |
| インタースティシャル | |
| リワード | |
| ネイティブ | |
1 アプリ起動時広告フォーマットは、ウォーターフォール統合でのみ使用できます。
ウォーターフォールでは、320×50 と 728×90 のバナーサイズのみがサポートされています。入札ではバナー広告はサポートされていません。
要件
- Android API レベル 24 以降
- [入札の場合]: 入札でサポートされているすべての広告フォーマットを統合するには、AppLovin アダプタ 9.4.2.0 以降（最新バージョンを推奨）を使用します。
GMA Next-Gen SDK の最新動画
メディエーションのスタートガイドの手順を完了していること
ステップ 1: AppLovin の UI で設定を行う
AdMob 広告ユニットを設定するには、AppLovin の SDK キーとレポートキーが必要です。これらの値を確認するには、AppLovin UI > [Account] > [Keys] に移動します。
入札のみを統合する場合は、メディエーション設定の構成に進んでください。
メディエーション用のアプリを選択する
入札単価
入札統合の場合、この手順は必要ありません。
ウォーターフォール
AppLovin UI で、[Monetization] セクションの [Applications] を選択して、登録済みのアプリに移動します。利用可能なアプリのリストから、メディエーションで使用するアプリを選択します。
ゾーンを作成する
入札単価
入札統合の場合、この手順は必要ありません。
ウォーターフォール
AppLovin の UI で、[Monetization] セクションの [Zones] を選択して、登録済みのゾーン ID にアクセスします。アプリに必要なゾーンをすでに作成している場合は、ステップ 2 に進みます。新しいゾーン ID を作成するには、[ゾーンを作成] をクリックします。
[ゾーン ID] の名前を入力し、[プラットフォーム] として [Android] を選択して、[広告タイプ] を選択します。
[料金設定] で、[固定 CPM] または [AppLovin による最適化] のいずれかを選択して、ゾーンの料金設定を構成します。[固定 CPM] オプションでは、CPM を国ごとに設定できます。次に、[Save] をクリックします。
ゾーンを作成すると、[ゾーン ID] 列にゾーン ID が表示されます。
app-ads.txt を更新する
アプリの認定販売者 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 の管理画面で AppLovin のデマンドを設定する
広告ユニットのメディエーション設定を構成する
広告ユニットのメディエーション設定に AppLovin を追加する必要があります。
まず、AdMob アカウントにログインします。次に、[メディエーション] タブに移動します。変更したい既存のメディエーション グループがある場合は、そのメディエーション グループの名前をクリックして編集し、広告ソースとして AppLovin を追加するに進みます。
新しいメディエーション グループを作成するには、[メディエーション グループを作成] を選択します。
広告フォーマットとプラットフォームを入力し、[続行] をクリックします。
メディエーション グループに名前を付け、ターゲットとする地域を選択します。次に、メディエーション グループのステータスを [有効] に設定し、[広告ユニットを追加] をクリックします。
このメディエーション グループを、1 つ以上の既存の AdMob 広告ユニットに関連付けます。次に [完了] をクリックします。
広告ユニット カードに選択した広告ユニットが表示されます。
広告ソースとして AppLovin を追加する
入札単価
[広告ソース] セクションの [入札] カードで、[広告ソースを追加] を選択します。[AppLovin] を選択します。
[パートナー契約への署名手順] をクリックし、AppLovin との入札パートナーシップを設定します。
[確認して同意する] をクリックし、[続行] をクリックします。
AppLovin のマッピングがすでにある場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、前のセクションで取得した SDK キーを入力します。[完了] をクリックします。
ウォーターフォール
[広告のソース] セクションの [ウォーターフォール] カードで、[広告ソースを追加] を選択します。
[AppLovin] を選択し、[最適化] スイッチをオンにします。前のセクションで取得したレポートキーを入力して、AppLovin の広告ソース最適化を設定します。次に、AppLovin の eCPM 値を入力し、[続行] をクリックします。
AppLovin のマッピングがすでに存在する場合は、それを選択できます。それ以外の場合は、[マッピングを追加] をクリックします。
次に、アプリのバンドル ID と、前のセクションで取得した SDK キーとゾーン ID を入力します。[完了] をクリックします。
GDPR と米国の州規制の広告パートナー リストに AppLovin Corp. を追加する
欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、AdMob 管理画面の欧州および米国の州の規制に関する広告パートナーのリストに AppLovin Corp. を追加します。
ステップ 3: AppLovin の SDK とアダプタをインポートする
Android Studio の統合（推奨）
アプリレベルの Gradle ファイルに、次の実装依存関係と構成を追加します。
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02") implementation("com.google.ads.mediation:applovin:13.5.1.0") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02' implementation 'com.google.ads.mediation:applovin:13.5.1.0' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
手動による統合
AppLovin Android SDK をダウンロードし、
applovin-sdk-x.y.z.jarを抽出してプロジェクトに追加します。Google の Maven リポジトリで AppLovin アダプタ アーティファクトに移動します。最新バージョンを選択し、AppLovin アダプタの .aar ファイルをダウンロードして、プロジェクトに追加します。
ステップ 4: AppLovin SDK にプライバシー設定を実装する
EU の同意に関する規制と GDPR
Google の EU ユーザーの同意ポリシーに準拠するには、欧州経済領域（EEA）、英国、スイスのユーザーに対して特定の情報を開示し、法律で義務付けられている場合は、Cookie やその他のローカル ストレージの使用、広告のパーソナライズを目的とした個人データの収集、共有、使用についてユーザーの同意を得る必要があります。このポリシーには、EU の e プライバシー指令と一般データ保護規則（GDPR）の要件が反映されています。パブリッシャー様には、同意がメディエーション チェーン内の各広告ソースに反映されていることを確認する責任があります。 Google は、同意に関するユーザーの選択をそのようなネットワークに自動的に渡すことはできません。
SDK バージョン 12.0.0 以降、AppLovin は共有設定から同意文字列を読み取り、それに応じて同意ステータスを設定することをサポートしています。
AppLovin SDK バージョン 12.0.0 以降を使用していない場合、または同意文字列を共有設定に書き込む CMP を使用していない場合は、setHasUserConsent メソッドを使用できます。次の例では、同意情報を AppLovin SDK に渡しています。これらのオプションは、GMA Next-Gen SDK を初期化する前に設定して、AppLovin SDK に正しく転送されるようにする必要があります。
Java
AppLovinPrivacySettings.setHasUserConsent(true);
Kotlin
AppLovinPrivacySettings.setHasUserConsent(true)
詳しくは、AppLovin のプライバシー設定をご覧ください。
子供のユーザーを宣言する
AppLovin SDK 13.0.0 以降、AppLovin は年齢制限のあるユーザーフラグをサポートしなくなりました。また、適用される法律で定義されている「子供」に関連して AppLovin SDK を初期化または使用することはできません。詳しくは、お子様のデータまたはお子様を対象としたサービスやアプリの利用の禁止に関する AppLovin のドキュメントをご覧ください。
AppLovin アダプタ バージョン 13.0.0.1 以降では、GMA Next-Gen SDK で次のいずれかの設定を宣言しているアプリに対して、AppLovin メディエーションが自動的に無効になります。
米国のプライバシー関連州法
米国のプライバシー関連州法では、ユーザーが「個人情報」の「販売」をオプトアウトする権利を付与することが義務付けられています（用語は法律の定義に基づく）。「販売者」のホームページには、「個人情報を第三者に売却しない」ことを明記したリンクを目立つように表示することによってオプトアウトの手段を提供する必要があります。米国のプライバシー関連州法遵守ガイドでは、Google 広告の配信で制限付きデータ処理を有効にできますが、Google がこの設定をメディエーション チェーン内の各広告ネットワークに適用することはできません。そのため、メディエーション チェーン内で個人情報の販売に関与する可能性のある広告ネットワークを特定し、各ネットワークのガイダンスに沿って州法を遵守する必要があります。
AppLovin SDK には、パブリッシャーが個人情報の販売をオプトアウトできる setDoNotSell メソッドが含まれています。
次の例では、この同意情報を AppLovin SDK に渡しています。これらのオプションは、GMA Next-Gen SDK を初期化する前に設定する必要があります。これにより、AppLovin SDK に正しく転送されます。
Java
AppLovinPrivacySettings.setDoNotSell(true);
Kotlin
AppLovinPrivacySettings.setDoNotSell(true)
詳しくは、AppLovin のプライバシーに関するドキュメントをご覧ください。
ステップ 5: 必要なコードを追加する
AppLovin の統合に、追加のコードは必要ありません。
ステップ 6: 実装をテストする
テスト広告を有効にする
AdMob 用のテストデバイスを登録し、AppLovin の管理画面でテストモードを有効にしてください。
テスト広告を確認する
AppLovin からテスト広告を受信していることを確認するには、AppLovin（入札）と AppLovin（ウォーターフォール）の広告ソースを使用して、広告インスペクタで単一の広告ソースのテストを有効にします。
省略可能なステップ
ネットワーク固有のパラメータ
AppLovin アダプタは setMuteAudio() をサポートしており、動画広告の音声を無効にできます。このメソッドは、AppLovinExtras.Builder() オブジェクトから呼び出すことができます。
Java
Bundle extras = new AppLovinExtras.Builder()
.setMuteAudio(true)
.build();
AdRequest request = new AdRequest.Builder(AD_UNIT_ID)
.putAdSourceExtrasBundle(ApplovinAdapter.class, extras)
.build();
Kotlin
val extras = AppLovinExtras.Builder()
.setMuteAudio(true)
.build()
val request = AdRequest.Builder(AD_UNIT_ID)
.putAdSourceExtrasBundle(ApplovinAdapter::class.java, extras)
.build()
最適化
アプリの起動時に AppLovin SDK を初期化します。これにより、AppLovin はイベントのトラッキングをすぐに開始できます。」エラーコード
アダプタが AppLovin から広告を受け取れない場合は、次のクラスの ResponseInfo.getAdSourceResponses() を使用して、広告レスポンスからエラーの詳細を確認できます。
com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
広告の読み込みに失敗した場合に AppLovin アダプタがスローするコードとメッセージは次のとおりです。
| エラーコード | 理由 |
|---|---|
| -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 がありません。 |