AppLovin Support

mediated networksの準備

サードパーティSDKをモバイルプロパティに統合する場合、その統合に関する責任はすべてお客様が負うものとします。 お客様とサードパーティSDKプロバイダーは、ユーザーまたはデバイスに基づくプライバシーの選択やフラグに準拠したデータ処理および取り扱いを確実に行う必要があります。

このページでは、アプリにMAXのmediation network adapterを統合する方法を説明します。 以下のチェックボックスをオンにして、統合する mediated ad networkを選択してください。 選択すると、それらのnetworkに特化した手順がこのページに表示されます。

    Android

    統合したいad networkを選択してください。 その後、このページに表示されるAndroid固有の手順に従ってください。

  • Google Ad Manager
  • Google Bidding and Google AdMob
  • InMobi
  • Meta Audience Network
  • Pangle
  • Google AdSense、AdManager、またはAdMobを使用するデベロッパーおよびパブリッシャーは、Googleが認定した同意管理プラットフォーム(CMP)を使用する必要があります。 欧州経済領域(EEA)または英国のユーザーに広告を配信する場合、CMPはIABのTransparency and Consent Framework(TCF)と統合されている必要があります。 詳細については、プライバシー:「TCF v2同意」を参照してください。

    Google biddingおよびGoogle AdMobのアプリIDを追加する

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

    Gradleエラー

    Google AdMobには、Android Gradle plugin バージョン4.2.0以上、およびGradle バージョン6.7.1以上が必要です。 以下のエラーが表示される場合は、Android Gradle pluginとGradleのバージョンをアップデートしてください:

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

    Android Gradle pluginとGradleのバージョンをアップデートするには、以下の手順を実行します:

    1. Unityで、Project Settings > Player > Android > Publishing Settings > Buildを開きます。
    2. Custom Base Gradle Templateにチェックを入れます。 Build: Custom Base Gradle Template (Assets/Plugins/Android/baseProjectTemplate.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インストールを指すようにします。 ☐ Gradle installed with Unity (recommended). Gradle: /path/to/gradle-6.7.1. Browse button. Warning: You are not using the recommended Gradle, other versions are not officially supported.

    Meta Audience Network SDKの移行

    プロジェクトでMeta Audience Network Unity SDKを使用している場合、MAXのMeta Audience Network adapterを機能させるには、バージョン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[] { });
    ⋮
    // 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 Data Use)」フラグの実装方法については、Meta for Developersのドキュメントをお読みください。

    Android manifestマージエラー

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

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

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

    Gradle Build Toolsではなく、Android Gradle Pluginをアップグレードしてください。

    現在のAndroid Gradle pluginのバージョン<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 pluginのバージョンを互換性のあるものにアップデートするには、カスタムのベース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 リリースノートを参照してください。

    iOS

    統合したいad networkを選択してください。 その後、このページに表示されるiOS固有の手順に従ってください。

  • Google Ad Manager
  • Google Bidding and Google AdMob
  • InMobi
  • Meta Audience Network
  • Pangle
  • Google AdSense、AdManager、またはAdMobを使用するデベロッパーおよびパブリッシャーは、Googleが認定した同意管理プラットフォーム(CMP)を使用する必要があります。 欧州経済領域(EEA)または英国のユーザーに広告を配信する場合、CMPはIABのTransparency and Consent Framework(TCF)と統合されている必要があります。 詳細については、プライバシー:「TCF v2同意」を参照してください。

    Google biddingおよびGoogle AdMobのアプリIDを追加する

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

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

    Meta Audience Network SDKの移行

    プロジェクトでMeta Audience Network Unity SDKを使用している場合、MAXのMeta Audience Network adapterを機能させるには、バージョン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[] { });
    ⋮
    // 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 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)
      {
        // 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
    };
    

    Pangle iOS adapter バージョン4.9.1.0.0以降、Pangleは中国本土では利用できなくなりました。 中国本土のトラフィックを収益化するには、CSJ networkを設定し、CSJ adapterを追加してください。 中国本土を除くグローバルトラフィックについては、引き続きPangleを使用して収益化を行うことができます。

    SKAdNetwork

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

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

Integration Manager

Unity IDEからAppLovin Integration Managerにアクセスできます。 これにより、mediation adapterやmediation plugin自体のインストールやアップグレードを行うことができます。

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

AppLovin > Integration Manager

これにより、利用可能な mediation networkのリストがポップアップウィンドウで表示されます。 Action列のボタンをクリックすることで、ad networkをInstallまたはUpgradeできます。

AppLovin Integration Manager: AppLovin MAX Plugin Details. Mediated Networks. AppLovin Quality Service. Unity Environment Details

手動ダウンロード

読み込み中...


search