将 AppLovin 与中介集成

本指南将向您介绍如何使用 Google 移动广告 SDK 加载和展示 使用中介从 AppLovin 投放的广告， 包括出价和广告瀑布流集成其中介绍了如何添加 AppLovin 广告单元的中介配置，以及如何集成 AppLovin SDK 和适配器集成到 Flutter 应用中。

支持的集成和广告格式

AppLovin 的 AdMob 中介适配器具有 以下功能：

集成
出价
瀑布
表现形式
横幅	^1
插页式广告
激励广告

¹ 横幅广告（不包括 MREC） 横幅广告）仅适用于中介。出价功能不支持任何类型 各种横幅广告

要求

• 最新版 Google 移动广告 SDK
• Flutter 3.7.0 或更高版本
• 在 Android 上部署 <ph type="x-smartling-placeholder">
  </ph>
  • Android API 级别 21 或更高级别
• 在 iOS 上部署 <ph type="x-smartling-placeholder">
  </ph>
  • iOS 部署目标为 12.0 或更高版本
• 使用 Google 配置的有效 Flutter 项目 移动广告 SDK。请参阅 如需了解详情，请开始使用。
• 完成中介流程 入门指南

第 1 步：在 AppLovin 界面中设置配置

注册或登录 您的 AppLovin 账号

要设置 AdMob 广告单元，您需要 AppLovin SDK 密钥和报告密钥。如需查找它们，请转到 AppLovin 界面 >账号 >要查看的键 两个值。

如果您只打算集成出价功能，则可以继续 配置中介设置。

选择要使用中介的应用

出价

对于出价集成，不需要执行此步骤。

瀑布

在 AppLovin 界面中，选择 创收部分，找到已注册的应用。选择应用 找到您想与中介搭配使用的应用

创建区域

出价

对于出价集成，不需要执行此步骤。

瀑布

在 AppLovin 界面中，选择创收下的 Zones（区域） 部分可以找到已注册的区域 ID。如果您已经创建了 所需的可用区，请直接跳到第 2 步。 如需创建新的区域 ID，请点击创建区域。

输入 Zone ID（区域 ID）名称，选择 Android 作为 Platform（平台），并且 选择广告类型。

选择固定 CPM 或固定 CPM，为区域配置价格 由 AppLovin 优化。您可以按国家/地区配置每千次展示费用 固定 CPM 选项。然后，点击保存。

Android

iOS

创建区域后，可以在区域 ID 下找到区域 ID 列。

Android

iOS

注意 ：我们强烈建议您创建与 每个 AdMob 广告单元 AdMob 可以更高效地 优化中介中的广告来源。

开启测试模式

请按照 AppLovin 的 MAX 测试模式 关于如何启用 AppLovin 测试广告的指南。

第 2 步：在界面中设置 AppLovin 需求 AdMob

为广告单元配置中介设置

Android

如需了解相关说明，请参阅 Android 指南中的第 2 步。

iOS

如需了解相关说明，请参阅 iOS 指南中的第 2 步。

将 AppLovin Corp. 添加到 GDPR 和美国州级法规广告合作伙伴名单中

重要提示： 请确认您拥有完成账号管理的权限， 适用于欧盟地区用户意见征求和 GDPR、CPRA 和 User Messaging Platform 的配置。请参阅 管理用户对应用的访问权限 账号。

按照 GDPR 设置 和 美国州级法规设置 中的步骤，将 AppLovin Corp. 添加到 AdMob 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。

第 3 步：导入 AppLovin SDK 和适配器

注意 ：未能集成兼容的 AppLovin 和 Google 移动广告 SDK 可能会导致构建问题。

Integration through pub.dev

Add the following dependency with the latest versions of the AppLovin SDK and adapter in your package's pubspec.yaml file:

dependencies:
  gma_mediation_applovin: ^1.0.0

Manual Integration

Download the latest version of Google Mobile Ads mediation plugin for AppLovin, extract the downloaded file, and add the extracted plugin folder (and its contents) to your Flutter project. Then, reference the plugin in your pubspec.yaml file by adding the following dependency:

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

第 4 步：在 AppLovin SDK 上实现隐私设置

欧盟地区用户意见征求和 GDPR

根据 Google 欧盟地区用户意见征求 政策，因此您必须确保向 Google 披露特定信息，并且 针对欧洲经济区 (EEA) 境内用户就 设备标识符和个人数据的使用。此政策反映了 欧盟《电子隐私指令》和《一般数据保护条例》的要求 条例 (GDPR)。在征求用户意见时，您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法 自动将用户的意见选择传递给此类广告网络。

AppLovin 支持从共享偏好设置和设置中读取意见征求字符串 来相应地调整用户同意情况

如果您 使用的 CMP 会将意见征求字符串写入共享的 你可以使用 GmaMediationApplovin.setHasUserConsent() 和 GmaMediationApplovin.setIsAgeRestrictedUser() 方法。以下示例代码展示了如何 将意见征求信息传递给 AppLovin SDK。必须设置这些选项 初始化 Google 移动广告 SDK 之前 以确保将其正确转发到 AppLovin SDK。

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

请参阅 AppLovin 的隐私设置 。

美国州级隐私保护法律

美国州级隐私保护法 要求向用户提供 来退出“促销”的“个人信息”（因为法律规定 这些条款），同时在其页面上以醒目方式显示“Do Not Sell My Personal 信息”请点击“销售”链接主页。通过 美国州/省/自治区/直辖市隐私权 法律合规指南提供了一项新功能， 受限的数据处理 用于 Google 广告投放，但 Google 无法对每个广告应用此设置 您的中介链中的广告联盟。因此，您必须找出每个广告联盟 可能参与销售个人数据或 并遵循每个广告联盟提供的指导， 合规性。

适用于 AppLovin 的 Google 移动广告中介插件 包含 GmaMediationApplovin.setDoNotSell() 方法。以下示例代码展示了如何将 意见征求信息。您必须先设置这些选项 将 Google 移动广告初始化 SDK 以确保将其正确转发到 AppLovin SDK。

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

请参阅 AppLovin 的隐私权 文档 。

第 5 步：添加所需的代码

Android

AppLovin 集成不需要其他代码。

iOS

SKAdNetwork 集成

按照 AppLovin 文档中的说明操作 将 SKAdNetwork 标识符添加到项目的 Info.plist` 文件中。

第 6 步：测试实现效果

启用测试广告

请务必为AdMob 注册您的测试设备，并在 AppLovin 界面中启用测试模式。

重要提示： 在发布应用前，请为 AdMob 和AppLovin 停用测试模式。

验证测试广告

如需验证您收到的是来自AppLovin的测试广告，请使用相应广告来源在广告检查器中启用单一广告来源测试。 AppLovin (Bidding) and AppLovin (Waterfall)

可选步骤

广告联盟专有参数

AppLovin 适配器支持将 AppLovinMediationExtras 对象传递给 以设置广告联盟专有的参数。以下示例代码显示 如何使用 isMuted 参数停用视频广告中的音频：

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

优化

添加来电提醒 GmaMediationApplovin.initializeSdk('sdkKey') 为您的启动活动提供 AppLovin 能够在应用启动后立即跟踪事件。

错误代码

如果适配器无法接收来自 AppLovin 的广告， 发布商可以使用 ResponseInfo（位于 以下类：

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

以下是 AppLovin 适配器抛出的代码和附带消息 当广告加载失败时：

Android

错误代码	原因
-1009 至 -1、204	AppLovin SDK 返回了错误。请参阅 AppLovin 文档 了解详情。
101	请求的广告尺寸与 AppLovin 支持的横幅广告尺寸不匹配。
103	上下文为 null。
104	AppLovin 出价令牌为空。
105	为同一区域请求了多个广告。AppLovin 一次只能在每个区域加载 1 个广告。
106	广告尚未准备好展示。
108	AppLovin Adapter 不支持所请求的广告格式。

iOS

错误代码	原因
-1009 至 -1、204	AppLovin SDK 返回了错误。请参阅 AppLovin 的文档 了解详情。
101	请求的广告尺寸与 AppLovin 支持的横幅广告尺寸不匹配。
102	界面中配置的 AppLovin 服务器参数缺失/无效。 AdMob
103	未能展示 AppLovin 广告。
104	为同一区域请求了多个广告。AppLovin 一次只能在每个区域加载 1 个广告。
105	找不到 AppLovin SDK 密钥。
107	出价令牌为空。
108	AppLovin Adapter 不支持所请求的广告格式。
110	AppLovin 成功发送了加载回调，但加载了零个广告。

AppLovin Flutter 中介适配器更新日志

1.2.0

• 已验证与 AppLovin Android 适配器版本 12.6.1.0 的兼容性。
• 已验证与 AppLovin iOS 适配器版本 12.6.1.0 的兼容性。
• 使用 Google 移动广告 Flutter 插件 5.1.0 版进行构建和测试。

1.1.0

• GmaMediationApplovin 的 API 不再是静态的。
• 已验证与 AppLovin Android 适配器版本 12.4.3.0 的兼容性。
• 已验证与 AppLovin iOS 适配器版本 12.4.2.0 的兼容性。
• 使用 Google 移动广告 Flutter 插件 5.1.0 版进行构建和测试。

1.0.0

• 初始版本。
• 已验证与 AppLovin Android 适配器版本 12.3.0.0 的兼容性
• 已验证与 AppLovin iOS 适配器版本 12.2.1.0 的兼容性
• 使用 Google 移动广告 Flutter 插件 5.0.0 版进行构建和测试。