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

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. Custom Base Gradle Templateにチェックを入れます。
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を使用している場合、MAXのMeta Audience Networkアダプターを機能させるには、バージョン11.0以降である必要があります。 古いバージョンのMeta Audience Network Unity SDKから移行するには、Assets/FacebookSDKディレクトリを削除し、こちらから最新バージョンをダウンロードして再インポートしてください。

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

Meta Audience Network Unity Pluginを使用していない場合は、こちらの「Unity SDK, v5.10+ (not using the Audience Network-supplied Unity wrapper)」に記載されている手順に従って、関連するメソッドのラッパーを追加してください。

制限付きデータ使用（LDU）モードを有効にしない場合は、SetDataProcessingOptions()に空の文字列配列を渡します：

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] { });
⋮
// MAX SDKを初期化する

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

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, «country», «state»);
⋮
// MAX SDKを初期化する

Google UMPの使用

CMPとしてGoogle UMPを使用している場合、ユーザーがMetaに同意したかどうかを判定できます。 そのためには、以下のコードを使用します：

bool? hasMetaConsent = MaxSdkUtils.GetAdditionalConsentStatus(89);
if ( hasMetaConsent != null )
{
  // それに応じてMetaのデータ処理オプションを設定します。
}
else
{
  // AC文字列がディスク上に存在しません。ユーザーがCMPフローを完了した後に同意ステータスを確認してください。
}

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

カリフォルニア州におけるMeta Audience Networkの「制限付きデータ使用（Limited Data Use）」フラグの実装方法については、Meta for Developersのドキュメントをお読みください。

Android manifestマージエラー

一部のネットワークSDKには、バンドルされているAndroid Manifestファイルに<queries>要素が含まれています。 互換性のないバージョンのAndroid Gradleプラグインを使用している場合、これが原因で以下のいずれかのビルドエラーが発生します：

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

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»

compileSdkVersion

Google Mobile Ads SDK バージョン23.1.0以降では、compileSdkVersionが34以上である必要があります。

アプリのbuild.gradleで、compileSdkVersionを34以上に設定してください。

最新のcompileSdkVersion要件については、Google Mobile Ads SDK リリースノートを参照してください。

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を使用している場合、MAXのMeta Audience Networkアダプターを機能させるには、バージョン11.0以降である必要があります。 古いバージョンのMeta Audience Network Unity SDKから移行するには、Assets/FacebookSDKディレクトリを削除し、こちらから最新バージョンをダウンロードして再インポートしてください。

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

Meta Audience Network Unity Pluginを使用していない場合は、こちらの「Unity SDK, v5.10+ (not using the Audience Network-supplied Unity wrapper)」に記載されている手順に従って、関連するメソッドのラッパーを追加してください。

制限付きデータ使用（LDU）モードを有効にしない場合は、SetDataProcessingOptions()に空の文字列配列を渡します：

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] { });
⋮
// MAX SDKを初期化する

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

using AudienceNetwork;
⋮
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, «country», «state»);
⋮
// MAX SDKを初期化する

Google UMPの使用

CMPとしてGoogle UMPを使用している場合、ユーザーがMetaに同意したかどうかを判定できます。 そのためには、以下のコードを使用します：

bool? hasMetaConsent = MaxSdkUtils.GetAdditionalConsentStatus(89);
if ( hasMetaConsent != null )
{
  // それに応じてMetaのデータ処理オプションを設定します。
}
else
{
  // AC文字列がディスク上に存在しません。ユーザーがCMPフローを完了した後に同意ステータスを確認してください。
}

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

カリフォルニア州におけるMeta Audience Networkの「制限付きデータ使用（Limited Data Use）」フラグの実装方法については、Meta for Developersのドキュメントをお読みください。

iOS 14.5以降に向けたMetaの準備

Audience Network SDK バージョン6.2.1では、以下の要件が導入されています：

• mediationの使用の有無にかかわらず、setAdvertiserTrackingEnabledフラグを実装します。 これにより、パーソナライズされた広告を配信するためにデータを使用するかどうかをMetaに通知します。

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

#if UNITY_IOS || UNITY_IPHONE || UNITY_EDITOR
  if (MaxSdkUtils.CompareVersions(UnityEngine.iOS.Device.systemVersion, "14.5") != MaxSdkUtils.VersionComparisonResult.Lesser)
  {
    // Unity EditorおよびiOSターゲットでは、App transparency trackingの認証を`sdkConfiguration.AppTrackingStatus`経由で確認できます。
    // 1. ここでMeta ATEフラグを設定し、その後に
  }
#endif

  // 2. 広告をロードします
};

SKAdNetwork

Integration Managerは、統合されたネットワークのSKAdNetwork IDを自動的にお客様に代わって統合します。