AppLovin Support

准备 mediated network

在将第三方 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 的透明度和同意框架 (TCF) 集成。 请参阅 Privacy: “TCF v2 consent” 了解更多信息。

    添加您的 Google bidding 和 Google AdMob App 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 部分将出现两个新的 App ID 字段。 请在这两个字段中输入对应值。 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>.
    

    To update your Android Gradle plugin and Gradle versions, take the following steps:

    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,则其版本必须为 11.0 或更高,MAX Meta Audience Network adapter 才能正常运行。 如需从旧版本的 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)” 下的说明为相关方法添加 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

    如果您使用 Google UMP 作为您的 CMP,则可以判断用户是否已向 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 版本不兼容,则会导致以下 build 错误之一:

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

    要修复此错误,请升级至以下 Android Gradle plugin 版本之一。 这些版本支持 <queries> 元素:

    请升级 Android Gradle plugin,而非 Gradle Build Tools。

    当前 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 或更高。

    请参阅 Google Mobile Ads SDK Release Notes 了解最新的 compileSdkVersion 要求。

    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 的透明度和同意框架 (TCF) 集成。 请参阅 Privacy: “TCF v2 consent” 了解更多信息。

    添加您的 Google bidding 和 Google AdMob App 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 部分将出现两个新的 App ID 字段。 请在这两个字段中输入对应值。 Google Bidding and Google AdMob. App ID (Android). App ID (iOS).

    Meta Audience Network SDK 迁移

    如果您的项目使用 Meta Audience Network Unity SDK,则其版本必须为 11.0 或更高,MAX Meta Audience Network adapter 才能正常运行。 如需从旧版本的 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)” 下的说明为相关方法添加 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

    如果您使用 Google UMP 作为您的 CMP,则可以判断用户是否已向 Meta 授予同意。 为此,请使用以下 code:

    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 文档。

    Meta 针对 iOS 14.5 及更高版本的准备工作

    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。 要通过中国大陆流量变现,请configure the 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。

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

手动下载

加载中……


search