本指南介绍了如何使用 Google 移动广告 SDK 使用中介加载和展示 Liftoff Monetize 中的广告,其中涵盖出价和广告瀑布流集成。其中介绍了如何将 Liftoff Monetize 添加到广告单元的 中介配置,以及如何将 Vungle SDK 和适配器集成到 Flutter 应用。
支持的集成和广告格式
集成 | |
---|---|
出价 | |
瀑布 | |
表现形式 | |
打开应用 | 1、 3 |
横幅 | 2 |
插页式广告 | |
激励广告 | |
插页式激励广告 | 2 |
1 出价 此格式的集成功能目前处于封闭式 Beta 版测试阶段。
2 出价 此格式的集成功能目前处于公开测试阶段。
3 此格式的广告瀑布流集成功能目前处于封闭式 Beta 版测试阶段。
要求
- 最新版 Google 移动广告 SDK
- Flutter 3.7.0 或更高版本
- 在 Android 上部署
- Android API 级别 21 或更高级别
- 在 iOS 上部署
- iOS 部署目标为 12.0 或更高版本
- 一个使用 Google 移动广告 SDK 配置的 Flutter 正常运行的项目。请参阅 如需了解详情,请开始使用。
- 完成中介流程 入门指南
第 1 步:在 Liftoff Monetize 界面中设置配置
第 2 步:在界面中设置 Liftoff Monetize 需求 AdMob
为广告单元配置中介设置
将 Liftoff 添加到 GDPR 和美国州级法规广告合作伙伴名单
按照 GDPR 设置 和 美国州级法规设置 中的步骤,将 Liftoff 添加到 AdMob 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。
第 3 步:导入 Vungle SDK 和 Liftoff Monetize 适配器
通过 pub.dev 进行集成
将以下依赖项与最新版本的
Liftoff Monetize 软件包的
pubspec.yaml
文件:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
手动集成
下载针对以下指标的最新版 Google 移动广告中介插件:
Liftoff Monetize、
将下载的文件解压缩,然后添加提取的插件文件夹
(及其内容)添加到您的 Flutter 项目中。然后,在
pubspec.yaml
文件,通过添加以下依赖项:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
第 4 步:在 Liftoff Monetize SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求 政策,因此您必须确保向 Google 披露特定信息,并且 针对欧洲经济区 (EEA) 境内用户就 对设备标识符和个人数据的使用。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时,您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法 自动将用户的意见选择传递给此类广告网络。
Liftoff Monetize 的 Google 移动广告中介插件包含
GmaMediationLiftoffmonetize.setGDPRStatus()
方法结合使用。以下示例代码
展示了如何将意见征求信息传递给 Vungle SDK。如果您选择
调用此方法,但建议先调用此方法,然后再通过
Google 移动广告 SDK
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
请参阅 GDPR 推荐的实现方式说明: Android 和 iOS,了解更多详情 以及可在方法中提供的值。
美国州级隐私保护法律
美国州级隐私保护法 要求向用户提供 以拒绝“销售”交易的“个人信息”(因为法律规定 这些条款),同时在其页面上以醒目方式显示“Do Not Sell My Personal”(不出售我的个人数据) 信息”请点击“销售”链接主页。通过 美国州/省/自治区/直辖市隐私权 法律合规指南提供了一项新功能, 受限的数据处理 用于 Google 广告投放,但 Google 无法将此设置应用于每个广告, 您的中介链中的广告联盟。因此,您必须找出每个广告联盟 可能参与销售个人数据或 并遵循每个广告联盟提供的指导, 合规性。
适用于 Liftoff Monetize 的 Google 移动广告中介插件包含 GmaMediationLiftoffmonetize.setCCPAStatus()
方法。以下示例代码
展示了如何将意见征求信息传递给 Vungle SDK。如果您选择
调用此方法,但建议先调用此方法,然后再通过
Google 移动广告 SDK
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
请参阅 CCPA 推荐的植入方式说明: Android 和 iOS,了解更多详情和 可以在方法中提供的值。
第 5 步:添加所需的代码
Android
无需添加额外的代码,即可与 Liftoff Monetize 集成。
iOS
SKAdNetwork 集成
关注 Liftoff Monetize's
文档
将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 6 步:测试实现效果
启用测试广告
请务必为AdMob 注册您的测试设备,并在 Liftoff Monetize 界面中启用测试模式。
验证测试广告
如需验证您收到的是来自Liftoff Monetize的测试广告,请使用相应广告来源在广告检查器中启用单一广告来源测试。 Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall)
错误代码
如果适配器未能收到来自 Liftoff Monetize 的广告,发布商可以
使用
ResponseInfo
,位于以下类下:
Android
格式 | 类名称 |
---|---|
开屏广告(出价) | com.google.ads.mediation.vungle.VungleMediationAdapter |
开屏广告(广告瀑布流) | com.google.ads.mediation.vungle.VungleMediationAdapter |
横幅(出价) | com.google.ads.mediation.vungle.VungleMediationAdapter |
横幅广告(广告瀑布流) | com.vungle.mediation.VungleInterstitialAdapter |
插页式广告(出价) | com.google.ads.mediation.vungle.VungleMediationAdapter |
插页式广告(广告瀑布流) | com.vungle.mediation.VungleInterstitialAdapter |
激励广告(出价) | com.google.ads.mediation.vungle.VungleMediationAdapter |
激励广告(广告瀑布流) | com.vungle.mediation.VungleAdapter |
插页式激励广告(出价) | com.google.ads.mediation.vungle.VungleMediationAdapter |
插页式激励广告(广告瀑布流) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
格式 | 类名称 |
---|---|
开屏广告(出价) | GADMediationAdapterVungle |
开屏广告(广告瀑布流) | GADMediationAdapterVungle |
横幅(出价) | GADMediationAdapterVungle |
横幅广告(广告瀑布流) | GADMAdapterVungleInterstitial |
插页式广告(出价) | GADMediationAdapterVungle |
插页式广告(广告瀑布流) | GADMAdapterVungleInterstitial |
激励广告(出价) | GADMediationAdapterVungle |
激励广告(瀑布流) | GADMAdapterVungleRewardBasedVideoAd |
插页式激励广告(出价) | GADMediationAdapterVungle |
插页式激励广告(广告瀑布流) | GADMediationAdapterVungle |
下面是 Liftoff Monetize 提供的代码和随附的消息 适配器:
Android
错误代码 | 原因 |
---|---|
101 | 服务器参数(如应用 ID 或展示位置 ID)无效。 |
102 | 请求的横幅尺寸未映射到有效的 Liftoff Monetize 广告 。 |
103 | Liftoff Monetize 需要 Activity 上下文才能请求广告。 |
104 | Vungle SDK 无法为同一展示位置加载多个广告 ID。 |
105 | Vungle SDK 初始化失败。 |
106 | Vungle SDK 返回了成功加载回调,但 Banners.getBanner() 或 Vungle.getNativeAd() 返回了 null。 |
107 | Vungle SDK 尚未准备好播放广告。 |
108 | Vungle SDK 返回的出价令牌无效。 |
iOS
错误代码 | 原因 |
---|---|
101 | 服务器参数(如应用 ID 或展示位置 ID)无效。 |
102 | 已加载此广告联盟配置的广告。Vungle SDK 无法为相同的展示位置 ID 加载第二个广告。 |
103 | 请求的广告尺寸与支持的 Liftoff Monetize 不符 横幅广告尺寸 |
104 | Vungle SDK 无法呈现横幅广告。 |
105 | Vungle SDK 仅支持一次加载 1 个横幅广告,无论 。 |
106 | Vungle SDK 发送了一个回调,指出该广告无法播放。 |
107 | Vungle SDK 尚未准备好播放广告。 |
对于 Vungle SDK 引起的错误,请参阅错误代码:iOS 版和 Android 版 Vungle SDK。
Liftoff Monetize Flutter 中介适配器变更日志
版本 1.0.0
- 初始版本。
- 已验证与 Liftoff Monetize Android 适配器版本 7.3.1.0 的兼容性
- 已验证与 LiftoffMonetize iOS 适配器版本 7.3.2.0 的兼容性
- 使用 Google 移动广告 Flutter 插件 5.1.0 版进行构建和测试。