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

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

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

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

統合
単価設定
フォーマット
バナー  1
インタースティシャル
特典

バナー広告(MREC を除く) バナーなど)はメディエーションでのみサポートされています。入札はどのタイプにも対応していません バナー広告です。

要件

  • 最新の Google Mobile Ads SDK
  • Unity 5.6 以降
  • [入札の場合]: AppLovin 4.2.0 または 高い (最新バージョンを推奨
  • Android にデプロイする <ph type="x-smartling-placeholder">
      </ph>
    • Android API レベル 21 以降
  • iOS にデプロイする場合 <ph type="x-smartling-placeholder">
      </ph>
    • iOS デプロイ ターゲットが 12.0 以降であること
  • Google で構成された Unity 作業プロジェクト Mobile Ads SDK があります。詳しくは、 スタートガイドをご覧ください。
  • メディエーションを完了する スタートガイド

ステップ 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: UI で AppLovin デマンドを設定する AdMob

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

OpenUPM-CLI がインストールされている場合 Google Mobile Ads AppLovin を 次のコードを実行して、Unity 用メディエーション プラグインをプロジェクトに追加します。 次のコマンドを入力します。

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

OpenUPM

Unity プロジェクト エディタで、[Edit] >プロジェクト設定 > [Package Manager] をクリックすると、 Unity Package Manager の設定

[スコープ レジストリ] タブで、OpenUPM をスコープ レジストリとして追加し、 以下の詳細を確認できます。

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

OpenUPM の詳細

次に、[ウィンドウ] >[Package Manager] をクリックすると、 Unity Package Manager と プルダウン メニューから [レジストリ] を選択します。

Unity レジストリ

[Google Mobile Ads AppLovin Mediation for Unity パッケージをダウンロードし、[Install] をクリックします。

OpenUPM からインストールする

Unity パッケージ

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

Unity プロジェクト エディタで、[Assets] を選択します。パッケージのインポート > [Custom Package] に移動し、 GoogleMobileAdsAppLovinMediation.unitypackage 表示されます。すべてのファイルが選択されていることを確認して、 インポート

Unity からインポート

次に、[アセット] >Play 開発者サービス リゾルバ > Android Resolver >Force Resolve。Unity Play 開発者サービス リゾルバ ライブラリは依存関係をゼロから解決し、 宣言した依存関係を、アプリケーションの Assets/Plugins/Android ディレクトリに Unity アプリ

強制解決

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

Google の EU ユーザーの同意 ポリシーに基づき、特定の情報開示が必ず行われるようにし、 欧州経済領域(EEA)のユーザーから、 デバイス ID や個人データの使用。このポリシーは、 EU の e プライバシー指令と一般データ保護規則の要件 規則(GDPR)。同意を求める場合は、各広告ネットワークを特定する必要がある 個人データを収集、受信、または使用する可能性がある 各ネットワークの使用状況に関する情報が表示されます。現在のところ、Google は ユーザーの同意に関する選択をこうしたネットワークに自動的に渡す。

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

もし Applovin 向け Google モバイル広告メディエーション プラグインを使用していない バージョン 7.0.0 以降または CMP を使用していないため、同意の文字列を 設定では、 AppLovin.SetHasUserConsent()AppLovin.SetIsAgeRestrictedUser() あります。次のサンプルコードは、 同意情報を AppLovin SDK に渡します。これらのオプションを設定する必要があります。 Google Mobile Ads SDK を初期化する前に AppLovin SDK に適切に転送されるようにしてください。

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

AppLovin.SetHasUserConsent(true);

また、ユーザーが年齢制限の対象となっていることがわかっている場合は、 また、以下のフラグを true に設定します。

AppLovin.SetIsAgeRestrictedUser(true);

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

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

米国プライバシー関連州法 は、ユーザーに対して適切な権限を 「セール」からオプトアウトするユーザーの「個人情報」(法律で定められているとおり、 これらの規約を参照)の「Do Not Sell My Personal」という目立つ位置で 情報」[販売]ページのリンクに表示されます。「 米国州のプライバシー 法令遵守ガイドでは、 制限付きデータ処理 設定されているが、この設定を各広告に適用することはできない 関連付けられます各広告ネットワークを 個人の商品販売に参加するメディエーション チェーン 各ネットワークのガイダンスに従って 遵守する必要があります

AppLovin 向け Google Mobile Ads メディエーション プラグイン バージョン 6.3.1 含まれる AppLovin.SetDoNotSell() メソッドを呼び出します。次のサンプルコードは、Python コードを 同意情報を AppLovin SDK に送信します。これらのオプションは、事前に Google モバイル広告を SDK AppLovin 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 Adapter でサポートされていません。

iOS

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

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

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