メディエーションネットワークの準備

Caution

サードパーティのSDKを自社のモバイルプロパティに連携させる場合、これらの連携に対して全責任を負うものとします。 お客様とサードパーティのSDKプロバイダーは、ユーザーやデバイスベースのプライバシーの選択やフラグに基づくデータ処理および取り扱いが、適切かつコンプライアンスに準拠していることを保証しなければなりません。

このページでは、MAXのメディエーションネットワーク アダプターをアプリに連携する方法を説明します。 以下のチェックボックスから、連携したいメディエーション広告ネットワークを選択してください。 その後、選択されたネットワーク向けの手順がこのページに表示されます。

Android

連携したいアドネットワークを選択します。 その後、このページのAndroid向けの手順に従ってください。

Google Ad Manager Google Bidding and Google AdMob InMobi Meta Audience Network Pangle VK Ad Network

Note

Google AdSense、AdManager、AdMobを使用する開発者とパブリッシャーは、Googleが認定する同意管理プラットフォーム（CMP）を使用する必要があります。 欧州経済領域（EEA）または英国のユーザーに広告を提供する場合、CMPはIABのTransparency and Consent Frameworkと連携する必要があります。 詳細についてはPrivacy: “TCF v2 Consent”を参照してください。

Google BiddingとGoogle AdMobのアプリIDを追加

1. Integration Managerを開きます (AppLovin > Integration Manager)。
2. 最新のGoogle BiddingとGoogle AdMobをインストールします。
   1. Integration ManagerのMediated Networksセクション内にあるGoogle BiddingおよびGoogle AdMobの横にあるActions列でInstallをクリックします。
   2. Import Unity PackageダイアログでImportをクリックします。
3. Integration ManagerのMediated Networksセクションに、アプリIDの2つの新しいフィールドが表示されます。 そこに対応する値を入力します。

Gradleエラー

Google AdMobは、Android Gradleプラグインバージョン4.2.0以降、およびGradleバージョン6.7.1以降が必須となります。 以下のエラーが表示された場合、AndroidのGradleプラグインとGradleバージョンを更新してください。

AAPT: error: unexpected element <property> found in <manifest><application>.

Android GradleプラグインとGradleのバージョンを更新するには、以下の手順に従ってください。

1. Unityにて、Project Settings > Player > Android > Publishing Settings > Buildを開きます。
2. カスタムのGradleテンプレートを確認します。
3. Assets/Plugins/Android/baseProjectTemplate.gradleファイルを編集します。 依存関係でGradleビルドツールのバージョンを4.2.0に設定します。

   allprojects {
     buildscript {
       dependencies {
         classpath 'com.android.tools.build:gradle:4.2.0'
         «build script dependencies»
       }
     }
   }

4. Gradleバージョン6.7.1以降をダウンロードして、インストールします。
5. Unityにて、Unity Preferences > External Toolsを開きます。
6. カスタムGradleパスを設定し、最新のGradleインストール先を指すようにします。

Meta Audience Network SDKを移行

プロジェクトで [Meta Audience Network Unity SDK] (https://developers.facebook.com/docs/audience-network/setting-up/platform-setup/unity/changelog)を使用している場合、MAX Meta Audience Networkアダプターが動作するにはバージョン11.0以降が必須となります。 古いバージョンのMeta Audience Network Unity SDKから移行するには、Assets/FacebookSDK ディレクトリを削除し、こちらから最新バージョンをダウンロードして、再インポートしてください。

Meta Audience Networkのデータ処理オプション

Meta Audience Network Unityプラグインを使用していない場合は、こちらの「Unity SDK, v5.10+（not using the Audience Network-supplied Unity wrapper）」を参照して、該当するメソッドのラッパーを追加してください。

Limited Data Use（LDU）モードを有効にしたくない場合は、SetDataProcessingOptions() に空の文字列配列をパスしてください。

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] { });
⋮
// Initialize MAX SDK

LDUを有効化し、ユーザーの地域を指定するには、SetDataProcessingOptions() を以下のように呼び出します。

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, «country», «state»);
⋮
// Initialize MAX SDK

Google UMPを使用する

CMPとしてGoogle UMPを使用している場合、ユーザーがMetaに同意したかどうかを判断できます。 これを行うには、次のコードを使用してください。

bool? hasMetaConsent = MaxSdkUtils.GetAdditionalConsentStatus(89);
if ( hasMetaConsent != null )
{
  // Set Meta Data Processing Options accordingly.
}
else
{
  // AC String is not available on disk. Please check for consent status after the user completes the CMP flow.
}

カリフォルニア州のユーザー向けのMeta Audience Networkデータ処理オプション

カリフォルニア州でMeta Audience Networkの「Limited Date Use」フラグを実装する方法については、Metaの開発者向けドキュメントをご覧ください。

Androidマニフェストのマージエラー

いくつかのネットワークSDKは、バンドルされたAndroidマニフェストファイル内で <queries> 要素を使用しています。互換性のないバージョンのAndroid Gradleプラグインを使用している場合、次のいずれかのビルドエラーが発生します。

Google Bidding and Google AdMob / InMobi / Pangle

com.android.builder.internal.aapt.v2.Aapt2Exception: Android resource linking failed
error: unexpected element <queries> found in <manifest>.

Meta Audience Network / VK Ad Network

Missing 'package' key attribute on element package at [:com.my.target.mytarget-sdk-5.11.3:]
AndroidManifest Validation failed

このエラーを修正するには、Android Gradleプラグインの以下のいずれかのバージョンにアップグレードしてください。 これらのバージョンは <queries> 要素をサポートします：

Caution

Gradleビルドツールではなく、Android Gradleプラグインをアップグレードしてください。

現在のAndroid Gradleプラグインバージョン	<queries> 要素をサポートするバージョン
4.1.*	すべて
4.0.*	4.0.1+
3.6.*	3.6.4+
3.5.*	3.5.4+
3.4.*	3.4.3+
3.3.*	3.3.3+

互換性のあるGradleプラグインバージョンにアップデートするには、カスタムベースのGradleテンプレートを有効にしてください。

1. Edit > Project Settings…を選択します。
2. Playerを選択し、Androidアイコンが表示されているタブを選びます。
3. Publisher Settingsを開き、 Custom Base Gradle Templateを確認します。

テンプレートは、Unity 2019.2以前の場合は Assets/Plugins/Android/mainTemplate.gradle に、Unity 2019.3以降の場合は Assets/Plugins/Android/baseProjectTemplate.gradle にあります。 そのテンプレート内で、以下の行を適切なGradleバージョンに追加してください。

classpath com.android.tools.build:gradle:«x».«x».«x»

build.gradleでアプリのcompileSdkVersionを設定します。

Google Mobile Ads SDKバージョン20.5.0以降では、compileSdkVersionを31に設定する必要があります。

Google Mobile Ads SDKバージョン20.4.0.1は、compileSdkVersionから30の設定を引き続きサポートする最新バージョンです。

iOS

連携したいアドネットワークを選択します。 その後、このページのiOS向けの手順に従ってください。

Google Bidding and Google AdMob Meta Audience Network Pangle

Note

Google AdSense、AdManager、AdMobを使用する開発者とパブリッシャーは、Googleが認定する同意管理プラットフォーム（CMP）を使用する必要があります。 欧州経済領域（EEA）または英国のユーザーに広告を提供する場合、CMPはIABのTransparency and Consent Frameworkと連携する必要があります。 詳細についてはPrivacy: “TCF v2 Consent”を参照してください。

Google BiddingとGoogle AdMobのアプリIDを追加

Integration Managerを開き(AppLovin > Integration Manager)、最新のGoogle biddingおよびGoogle AdMob アダプターをインストールします。

1. Integration ManagerのMediated Networksセクション内にあるGoogle BiddingおよびGoogle AdMobの横にあるActions列でInstallをクリックします。
2. Import Unity PackageダイアログでImportをクリックします。
3. Integration ManagerのMediated Networksセクションに、アプリIDの2つの新しいフィールドが表示されます。 そこに対応する値を入力します。

Meta Audience Network SDKを移行

プロジェクトで [Meta Audience Network Unity SDK] (https://developers.facebook.com/docs/audience-network/setting-up/platform-setup/unity/changelog)を使用している場合、MAX Meta Audience Networkアダプターが動作するにはバージョン11.0以降が必須となります。 古いバージョンのMeta Audience Network Unity SDKから移行するには、Assets/FacebookSDK ディレクトリを削除し、こちらから最新バージョンをダウンロードして、再インポートしてください。

Meta Audience Networkのデータ処理オプション

Meta Audience Network Unityプラグインを使用していない場合は、こちらの「Unity SDK, v5.10+（not using the Audience Network-supplied Unity wrapper）」を参照して、該当するメソッドのラッパーを追加してください。

Limited Data Use（LDU）モードを有効にしたくない場合は、SetDataProcessingOptions() に空の文字列配列をパスしてください。

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] { });
⋮
// Initialize MAX SDK

LDUを有効化し、ユーザーの地域を指定するには、SetDataProcessingOptions() を以下のように呼び出します。

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, «country», «state»);
⋮
// Initialize MAX SDK

Google UMPを使用する

CMPとしてGoogle UMPを使用している場合、ユーザーがMetaに同意したかどうかを判断できます。 これを行うには、次のコードを使用してください。

bool? hasMetaConsent = MaxSdkUtils.GetAdditionalConsentStatus(89);
if ( hasMetaConsent != null )
{
  // Set Meta Data Processing Options accordingly.
}
else
{
  // AC String is not available on disk. Please check for consent status after the user completes the CMP flow.
}

カリフォルニア州のユーザー向けのMeta Audience Networkデータ処理オプション

カリフォルニア州でMeta Audience Networkの「Limited Date Use」フラグを実装する方法については、Metaの開発者向けドキュメントをご覧ください。

Meta 14.5以降への対応

Audience Network SDKバージョン6.2.1では、以下の重要な要件が導入されました。

• メディエーションの使用に関わらず、setAdvertiserTrackingEnabledフラグを実装してください。 これにより、Metaはパーソナライズド広告の配信にデータを使用するかどうかを通知します。

MaxSdkCallbacks.OnSdkInitializedEvent += (MaxSdkBase.SdkConfiguration sdkConfiguration) => {

#if UNITY_IOS || UNITY_IPHONE || UNITY_EDITOR
  if (MaxSdkUtils.CompareVersions(UnityEngine.iOS.Device.systemVersion, "14.5") != MaxSdkUtils.VersionComparisonResult.Lesser)
  {
    // Note that App transparency tracking authorization can be checked via `sdkConfiguration.AppTrackingStatus` for Unity Editor and iOS targets
    // 1. Set Meta ATE flag here, THEN
  }
#endif

  // 2. Load ads
};

Note

Pangle iOS アダプターバージョン4.9.1.0.0以降より、中国本土ではPangleが利用できなくなります。 中国本土のトラフィックを収益化するために、CSJネットワークをセットアップ し、CSJアダプターを追加してください。 中国本土を除くグローバルトラフィックに対しては、引き続きPangleを使用した収益化が可能です。

SKAdNetwork

Integration Managerは、連携されたネットワークのSKAdNetwork IDを自動的に連携します。

ノート

Unity向けにAmazonを連携するには、Amazon Publisher Services連携手順のページ を参照してください。

Integration Manager

Unity IDEからAppLovin Integration Managerにアクセスしてください。 メディエーションアダプターおよびメディエーションプラグイン自体をインストールまたはアップグレードすることができます。

Integration Managerを起動するには、UnityのメニューバーよりAppLovin > Integration Managerを選択します。

利用可能なメディエーションネットワークの一覧を示すポップアップウィンドウが表示されます。 Action列のボタンをクリックして、アドネットワークをInstallあるいはUpgradeすることが可能です。

マニュアルダウンロード