选择要集成的广告平台

警告

在将第三方 SDK 集成到自己的移动端资产中时，您需要为此类集成承担全部责任。 您和第三方 SDK 提供商必须确保数据处理过程符合规定并且妥善处理任何基于用户或设备的隐私选择或标记。

Android

您可以通过两种方式下载 MAX 聚合适配器并将其集成到应用中：

Gradle

AppLovin 建议采用这种方式集成适配器。 AppLovin 的适配器 POM 文件会自动集成被聚合平台的 SDK 及其依赖。

开源适配器

如果需要更高的集成灵活性，则可以集成 AppLovin 的开源适配器。 此时，您将负责集成被聚合 SDK 及其依赖。 您可以在 AppLovn-MAX-SDK-Android GitHub 库中找到这些适配器。

警告

请勿更改适配器的名称或包名。 否则，MAX SDK 将无法识别适配器，广告也无法加载。

Gradle

勾选下方复选框，选择要通过 MAX 聚合接入的广告平台。 勾选这些复选框后，本页面会显示这些平台的具体说明。

本页面还会为您创建一个自定义的 UPL。 将下面的自定义 UPL 复制到 AppLovinMAX_UPL_Android.xml。

BidMachine BIGO Ads Chartboost DT Exchange Google Ad Manager Google Bidding and Google AdMob HyprMX InMobi ironSource Liftoff Monetize LINE Maio Meta Audience Network Mintegral MobileFuse Moloco Ogury Pangle PubMatic Smaato Unity Ads Verve VK Ad Network Yandex YSO Network

<AARImports>
    <insertValue value="com.applovin.mediation,bidmachine-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,bigoads-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,chartboost-adapter,+" /> <insertNewline/>
    <insertValue value="com.google.android.gms,play-services-base,16.1.0" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,fyber-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,google-ad-manager-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,google-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,hyprmx-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,inmobi-adapter,+" /> <insertNewline/>
    <insertValue value="com.squareup.picasso,picasso,2.8" /> <insertNewline/>
    <insertValue value="androidx.recyclerview,recyclerview,1.1.0" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,ironsource-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,vungle-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,line-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,maio-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,facebook-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,mintegral-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,mobilefuse-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,moloco-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,ogury-presage-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,bytedance-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,pubmatic-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,smaato-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,unityads-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,verve-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,mytarget-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,yandex-adapter,+" /> <insertNewline/>
    <insertValue value="com.applovin.mediation,yso-network-adapter,+" /> <insertNewline/>
</AARImports>

<buildGradleAdditions>
    <insert>
        allprojects {
            // You may add any additional repositories for other ad networks here
            repositories {
                maven { url "https://artifactory.bidmachine.io/bidmachine" }
                maven { url "https://cboost.jfrog.io/artifactory/chartboost-ads/" }
                maven { url "https://imobile-maio.github.io/maven" }
                maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea" }
                maven { url "https://maven.ogury.co" }
                maven { url "https://artifact.bytedance.com/repository/pangle" }
                maven { url "https://repo.pubmatic.com/artifactory/public-repos" }
                maven { url "https://s3.amazonaws.com/smaato-sdk-releases/" }
                maven { url "https://verve.jfrog.io/artifactory/verve-gradle-release" }
                maven { url "https://ysonetwork.s3.eu-west-3.amazonaws.com/sdk/android" }
            }
        }
    </insert>
</buildGradleAdditions>

注意

使用 Google AdSense、AdManager 或 AdMob 的开发者和发行商必须使用经过 Google 认证的许可管理平台 (CMP)。 要向欧洲经济区 (EEA) 或英国的用户投放广告，您的 CMP 必须集成 IAB 的透明度和许可框架。 请参阅 Privacy: “TCF v2 Consent” 了解更多信息。

添加您的 Google 竞价和 Google AdMob / Google Ad Manager 应用 ID

在 AppLovin MAX Unreal 插件的 AppLovinMAX_UPL_Android.xml 中，在 androidManifestUpdates 标签下添加您的 Google 竞价和 Google AdMob App ID。 在下面的示例中，将 «your-admob-app-id» 替换为您的 Google 竞价和 Google AdMob App ID。

<androidManifestUpdates>
⋮
    <addElements tag="application">
        <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="«your-admob-app-id»" />
    </addElements>
⋮
</androidManifestUpdates>

compileSdkVersion

Google 移动广告 SDK 23.1.0 及更新版本要求 compileSdkVersion 为 34 或更高。

在 Project Settings > Android SDK > SDK API Level 中将 compileSdkVersion 设置为 android-34 或更高。

请参阅 Google 移动广告 SDK 发行说明，了解最新的 compileSdkVersion 要求。

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 Manifest 合并错误

一些平台 SDK 会在其打包的 Android Manifest 文件中使用 <queries> 元素。 如果使用的 Android Gradle 插件版本不兼容，则会导致以下编译错误之一：

Google 竞价和 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> 元素:

警告

请升级 Android Gradle 插件，而非 Gradle Build Tools。

当前 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+

要升级 Android Gradle 插件，请按照以下说明进行操作：

1. 导航到您的 Unreal Engine 版本的目录。 例如，Unreal Engine 5.2 在 macOS 上的默认安装路径为 /Users/Shared/Epic Games/UE_5.2/。
2. 在 Engine/Source/Programs/UnrealBuildTool/Platform/Android/UEDeployAndroid.cs 中更新 ANDROID_TOOLS_BUILD_GRADLE_VERSION 的值 (将 «X.X.X» 替换为相应的版本号)：

   private const string ANDROID_TOOLS_BUILD_GRADLE_VERSION = "com.android.tools.build:gradle:«X.X.X»";

3. 在 Engine/Build/Android/Java/gradle/build.gradle 中，更新下列行 (将 «X.X.X» 替换为相应的版本号)：

   classpath project.hasProperty('ANDROID_TOOLS_BUILD_GRADLE_VERSION') ? project.property('ANDROID_TOOLS_BUILD_GRADLE_VERSION') : 'com.android.tools.build:gradle:«X.X.X»'

Meta Audience Network 数据处理选项

如果您不想启用限制数据使用 (LDU) 模式，请向 SetDataProcessingOptions() 传递一个空字符串数组：

⋮
<gameActivityImportAdditions>
  ⋮
  import com.facebook.ads.AdSettings;
</gameActivityImportAdditions>

<gameActivityOnCreateAdditions>
  <insert>
    AdSettings.setDataProcessingOptions( new String[] {} );
  </insert>
</gameActivityOnCreateAdditions>

要为用户启用 LDU 并指定用户地理位置，请以如下形式调用 SetDataProcessingOptions()：

<gameActivityOnCreateAdditions>
  <insert>
    AdSettings.setDataProcessingOptions( new String[] {"LDU"}, «country», «state» );
  </insert>
</gameActivityOnCreateAdditions>

针对加利福尼亚州用户的 Meta Audience Network 数据处理选项

要了解如何在加利福尼亚州启用 Meta Audience Network 的 “Limited Data Use” (限制数据使用) 标记，请参阅 Meta 开发者文档。

混淆

如果您使用代码混淆或资源缩减，请遵循 Pangle 的混淆指南。

适配器平台信息

iOS

Unreal Engine 要求您手动集成适用于 iOS 的第三方框架。 它不支持像 CocoaPods 这样的依赖管理器。 MAX Unreal GitHub 库包含一个 Python 脚本—— install_pods.py，可用于自动安装 Podfile 中的依赖项。 此脚本会下载 AppLovin 的适配器和第三方依赖项，并使用 Build 设置配置您的项目以正确链接这些组件。

注意

此脚本可能无法自动为某些平台配置第三方 SDK。 如果是这样，您必须手动集成它们。

要求

• Python 3.6+
• CocoaPods

提示

确保您使用的是 CocoaPods 的最新版本。 您可以通过执行以下指令来检查您的版本：

pod --version

要更新 CocoaPods，请运行以下指令之一：

Homebrew

brew upgrade cocoapods

RubyGems

sudo gem install cocoapods

说明

1. 从 AppLovin 的 MAX Unreal GitHub 库下载 install_pods.py。
2. 将此脚本复制到 AppLovin MAX Unreal 插件的 Source/ThirdParty/IOS/ 目录中。
3. 在该目录中为要集成的适配器创建 Podfile。
4. 运行 install_pods.py 下载适配器和依赖项。 请遵循脚本中的任何附加说明以完成安装。
5. 请按照准备聚合网络 (iOS) 中的说明进行操作。 在 AppLovinMAX_UPL_IOS.xml 中对 Info.plist 进行任何必要的更改。