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

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

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

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

統合
入札
ウォーターフォール
フォーマット
アプリの起動  1
バナー  2
インタースティシャル
リワード
リワード インタースティシャル
ネイティブ

1 ウォーターフォールの統合はクローズド ベータ版です。

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

前提条件

続行する前に、次のことを確認してください。

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

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

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

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

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

入札

このステップは、入札の統合には必要ありません。

ウォーターフォール

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

ゾーンを作成

入札

このステップは、入札の統合には必要ありません。

ウォーターフォール

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

[Zone ID] の名前を入力し、[Platform] として [Android] を選択し、[広告タイプ] を選択します。

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

Android

iOS

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

Android

iOS

app-ads.txt を更新する

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

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

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

AppLovin のテスト広告を有効にする方法については、AppLovin の MAX テストモード ガイドの手順に沿って操作してください。

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

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

Android

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

iOS

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

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

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

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

プロジェクトのルート ディレクトリに、AppLovin 用の Google Mobile Ads SDK for React Native メディエーション アダプタをインストールします。次の手順に沿って操作します。

  1. Google Mobile Ads SDK for React Native アダプタの tar ファイルを gma-sdk-react-native/adapters/applovin/ ディレクトリからプロジェクトの local_packages/ ディレクトリにコピーします。adapters フォルダがない場合は、前提条件をご覧ください。

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/applovin/gma-mediation-applovin-0.1.0.tgz local_packages/

    EXTRACT_DIR は、アーカイブを抽出したディレクトリのパスに置き換えます。

  2. 任意のパッケージ マネージャーを使用して、アダプタ パッケージをインストールします。

    npm

    npm install ./local_packages/gma-mediation-applovin-0.1.0.tgz

    毛糸

    yarn add ./local_packages/gma-mediation-applovin-0.1.0.tgz

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

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

AppLovin React Native アダプタ バージョン 0.1.0 以降では、UMP SDK と、Google の追加同意仕様を統合する同意管理プラットフォームから AppLovin SDK に GDPR 同意シグナルを渡すことができます。詳細については、TCF v2 の同意をご覧ください。

子供のユーザーを申告する

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 React Native メディエーション プラグインは、年齢に応じた取り扱いの設定を使用して子供ユーザーを宣言するアプリに対して、AppLovin へのメディエーションを自動的に無効にします。

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

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

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

import { AppLovinMediation } from '@google/gma-mediation-applovin';
// ...

AppLovinMediation.setDoNotSell(true);

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

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

Android

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

iOS

SKAdNetwork の統合

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

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

テスト広告を有効にする

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

テスト広告を確認する

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

省略可能なステップ

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

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

import { AdRequest } from '@google/mobile-ads';
import { AppLovinMediationExtras } from '@google/gma-mediation-applovin';

const request: AdRequest = {
  // ...
  mediationExtras: [
    new AppLovinMediationExtras({
      isMuted: true, // Mute audio for AppLovin ads
    }),
  ],
};

最適化

起動アクティビティに への呼び出しを追加すると、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 UI で設定された 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 広告の準備ができていません。広告を表示できません。

バージョン 0.1.0

  • 初回リリース。