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

プラットフォームを選択: Android iOS Unity Flutter Android（以前のバージョン）

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

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

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

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

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

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

前提条件

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

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

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

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

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

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

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

    入札

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

    ウォーターフォール

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

    ゾーンを作成

    入札

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

    ウォーターフォール

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

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

    [Flat CPM] または [Optimized by AppLovin] を選択して、ゾーンの [Pricing] を設定します。固定 CPM オプションでは、CPM を国ごとに設定できます。次に、[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 を実装するには、app-ads.txt ファイルに AppLovin を追加します。

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

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

    ステップ 2: アド マネージャーの管理画面で AppLovin のデマンドを設定する

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

    Android

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

    iOS

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

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

    欧州の規制に関する設定と米国の州の規制に関する設定の手順に沿って、アド マネージャーの管理画面で欧州および米国の州の規制に関する広告パートナーのリストに 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 レジストリ

    [Google Mobile Ads Applovin Mediation] パッケージを選択し、[インストール] をクリックします。

    OpenUPM からインストールする

    Unity パッケージ

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

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

    Unity からインポートする

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

    強制解決

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

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

    AppLovin Unity アダプタ バージョン 7.0.0 以降では、UMP SDK と Google の追加同意に関する仕様と統合された同意管理プラットフォームから GDPR 同意シグナルを渡すことができます。

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

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

    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 メディエーション プラグイン バージョン 11.3.0 以降では、次のいずれかの設定を使用して子供のユーザーを宣言しているアプリに対して、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 のドキュメントに沿って、プロジェクトの Info.plist ファイルに SKAdNetwork 識別子を追加します。

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

    テスト広告を有効にする

    アド マネージャー用のテストデバイスを登録し、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 アド マネージャーの管理画面で設定された 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 広告の準備ができていません。広告を表示できません。

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

    バージョン 8.7.7

    バージョン 8.7.6

    バージョン 8.7.5

    バージョン 8.7.4

    バージョン 8.7.3

    バージョン 8.7.2

    バージョン 8.7.1

    バージョン 8.7.0

    バージョン 8.6.0

    バージョン 8.5.2

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

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