本指南将向您介绍如何使用 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 界面中设置配置
要设置 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
开启测试模式
请按照 AppLovin 的 MAX 测试模式 关于如何启用 AppLovin 测试广告的指南。
第 2 步:在界面中设置 AppLovin 需求 AdMob
为广告单元配置中介设置
将 AppLovin Corp. 添加到 GDPR 和美国州级法规广告合作伙伴名单中
按照 GDPR 设置 和 美国州级法规设置 中的步骤,将 AppLovin Corp. 添加到 AdMob 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。
第 3 步:导入 AppLovin 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 界面中启用测试模式。
验证测试广告
如需验证您收到的是来自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 版进行构建和测试。