本指南介绍了如何使用 Google 移动广告 SDK 使用中介加载和展示 Liftoff Monetize 中的广告,其中涵盖出价和广告瀑布流集成。其中介绍了如何将 Liftoff Monetize 添加到广告单元的 中介配置,以及如何将 Vungle SDK 和适配器集成到 Unity 应用。
支持的集成和广告格式
集成 | |
---|---|
出价 | 1 |
瀑布 | |
表现形式 | |
打开应用 | |
横幅 | |
插页式广告 | |
激励广告 | |
插页式激励广告 | 2 |
1 出价集成 目前处于公开测试阶段
2 插页式激励广告需要借助帮助才能设置。请与您的 Liftoff Monetize 客户经理或 monetize@liftoff.io
联系。
要求
- 最新版 Google 移动广告 SDK
- Unity 4 或更高版本
- (适用于出价):Liftoff Monetize 的 Google 移动广告中介插件 3.8.2 或更高版本 (建议使用最新版本)
- 在 Android 上部署
- Android API 级别 21 或更高级别
- 在 iOS 上部署
- iOS 部署目标为 12.0 或更高版本
- 一个使用 Google 移动广告 SDK 配置的 Unity 正常运行的项目。请参阅 如需了解详情,请开始使用。
- 完成中介流程 入门指南
第 1 步:在 Liftoff Monetize 界面中设置配置
第 2 步:在界面中设置 Liftoff Monetize 需求 Ad Manager
为广告单元配置中介设置
将 Liftoff 添加到 GDPR 和美国州级法规广告合作伙伴名单
按照 GDPR 设置 和 美国州级法规设置 中的步骤,将 Liftoff 添加到 Ad Manager 界面中的 GDPR 和美国州级法规广告合作伙伴列表中。
第 3 步:导入 Vungle SDK 和 Liftoff Monetize 适配器
下载适用于 Liftoff 的最新版 Google 移动广告中介插件
通过
更新日志,并从
zip 文件中的 GoogleMobileAdsVungleMediation.unitypackage
。
在 Unity 项目编辑器中,选择 Assets >导入软件包 >
自定义软件包,然后找到 GoogleMobileAdsVungleMediation.unitypackage
文件
。确保选择所有文件,然后点击 Import(导入)。
然后,依次选择 Assets > Play Services Resolver > Android Resolver > Force Resolve。Unity Play Services Resolver 库将执行
从头解析依赖项,并将声明的依赖项复制到
Assets/Plugins/Android
目录中。
第 4 步:在 Liftoff Monetize SDK 上实现隐私设置
欧盟地区用户意见征求和 GDPR
根据 Google 欧盟地区用户意见征求 政策,因此您必须确保向 Google 披露特定信息,并且 针对欧洲经济区 (EEA) 境内用户就 对设备标识符和个人数据的使用。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。在征求用户意见时,您必须指明每个广告联盟 可能会收集、接收或使用个人数据的中介链 提供有关每个网络使用情况的信息。Google 目前无法 自动将用户的意见选择传递给此类广告网络。
Liftoff Monetize 的 Google 移动广告中介插件包含如下方法: 将意见征求信息传递给 Vungle SDK。以下示例代码展示了如何 将意见征求信息传递给 Vungle SDK。如果您选择调用此方法, 方法,建议您在通过 Google 移动广告 SDK。
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif
请参阅 GDPR 推荐的实现方式说明: Android 和 iOS,了解更多详情 以及可在方法中提供的值。
美国州级隐私保护法律
美国州级隐私保护法律 要求向用户提供 以拒绝“销售”交易的“个人信息”(因为法律规定 这些条款),同时在其页面上以醒目方式显示“Do Not Sell My Personal”(不出售我的个人数据) 信息”请点击“销售”链接主页。通过 美国州/省/自治区/直辖市隐私权 法律合规指南提供了一项新功能, 受限的数据处理 用于 Google 广告投放,但 Google 无法将此设置应用于每个广告, 您的中介链中的广告联盟。因此,您必须找出每个广告联盟 可能参与销售个人数据或 并遵循每个广告联盟提供的指导, 合规性。
Liftoff Monetize 的 Google 移动广告中介插件包含如下方法: 将意见征求信息传递给 Vungle SDK。以下示例代码展示了如何将意见征求信息传递给 Vungle SDK。如果您选择调用此方法,建议您先调用此方法,然后再通过 Google 移动广告 SDK 请求广告。
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
请参阅 CCPA 推荐的植入方式说明: Android 和 iOS,了解更多详情和 可以在方法中提供的值。
第 5 步:添加所需的代码
Android
无需添加额外的代码,即可与 Liftoff Monetize 集成。
iOS
SKAdNetwork 集成
关注 Liftoff Monetize's
文档
将 SKAdNetwork 标识符添加到项目的 Info.plist
文件中。
第 6 步:测试实现效果
启用测试广告
请务必为Ad Manager 注册您的测试设备,并在 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 Unity 中介插件变更日志
版本 5.2.1
- 将
DummyClient
重命名为了PlaceholderClient
。 - 支持 Liftoff Monetize Android 适配器版本 7.4.0.1。
- 支持 Liftoff Monetize iOS 适配器版本 7.4.0.1。
- 利用 Google 移动广告 Unity 插件 9.2.0 版进行制作和测试。
版本 5.2.0
- 支持 Liftoff Monetize Android 适配器版本 7.4.0.0。
- 支持 Liftoff Monetize iOS 适配器版本 7.4.0.0。
- 使用 Google 移动广告 Unity 插件 9.1.1 版构建和测试。
版本 5.1.1
- 支持 Liftoff Monetize Android 适配器版本 7.3.2.0。
- 支持 Liftoff Monetize iOS 适配器版本 7.3.2.0。
- 利用 Google 移动广告 Unity 插件 9.1.0 版进行制作和测试。
版本 5.1.0
- 修复了在导出为 Android 项目时导致构建失败的
NullPointerException
。 - 更新了隐私权 API:
- 移除了
UpdateConsentStatus()
和UpdateCCPAStatus()
方法。 - 移除了
VungleConsentStatus
和VungleCCPAStatus
枚举。 - 将
SetGDPRStatus(bool)
方法更新为SetGDPRStatus(bool, String)
。
- 移除了
- 从
LiftoffMonetizeMediationExtras
类中移除了以下方法: <ph type="x-smartling-placeholder">- </ph>
SetAllPlacements(String[])
SetSoundEnabled(bool)
- 支持 Liftoff Monetize Android 适配器版本 7.3.1.0。
- 支持 Liftoff Monetize iOS 适配器版本 7.3.1.0。
- 利用 Google 移动广告 Unity 插件 9.1.0 版进行制作和测试。
版本 5.0.0
- 修复了针对
MediationExtras
的重复定义警告。 - 支持 Liftoff Monetize Android 适配器版本 7.1.0.0。
- 支持 Liftoff Monetize iOS 适配器版本 7.2.1.1。
- 使用 Google 移动广告 Unity 插件 8.7.0 版进行构建和测试。
版本 4.0.0
- 将 Unity 中介插件从 Vungle 更名为 Liftoff Monetize。
- 将适配器内容移到了
GoogleMobileAds/Mediation/LiftoffMonetize/
。 - 重构了适配器命名空间,以使用
GoogleMobileAds.Mediation.LiftoffMonetize
。 - 向
LiftoffMonetize
类添加了以下方法: <ph type="x-smartling-placeholder">- </ph>
SetGDPRStatus(bool)
SetGDPRMessageVersion(String)
SetCCPAStatus(bool)
- 支持 Liftoff Monetize Android 适配器版本 6.12.1.1。
- 支持 Liftoff Monetize iOS 适配器版本 7.0.1.0。
- 利用 Google 移动广告 Unity 插件 8.4.1 版进行制作和测试。
版本 3.9.2
- 更新了
Vungle
类: <ph type="x-smartling-placeholder">- </ph>
- 添加了
UpdateCCPAStatus(VungleCCPAStatus)
方法。 - 移除了
GetCurrentConsentStatus()
方法。 - 移除了
GetCurrentConsentMessageVersion()
方法。
- 添加了
- 支持 Vungle Android 适配器版本 6.12.1.0。
- 支持 Vungle iOS 适配器版本 6.12.2.0。
- 使用 Google 移动广告 Unity 插件 7.4.1 版进行构建和测试。
版本 3.9.1
- 支持 Vungle Android 适配器版本 6.12.1.0。
- 支持 Vungle iOS 适配器版本 6.12.1.1。
- 使用 Google 移动广告 Unity 插件 7.4.0 版进行制作和测试。
版本 3.9.0
- 支持 Vungle Android 适配器版本 6.12.0.0。
- 支持 Vungle iOS 适配器版本 6.12.0.0。
- 使用 Google 移动广告 Unity 插件 7.2.0 版进行构建和测试。
版本 3.8.2
- 支持 Vungle Android 适配器版本 6.11.0.2。
- 支持 Vungle iOS 适配器版本 6.11.0.1。
- 使用 Google 移动广告 Unity 插件 7.1.0 版进行构建和测试。
版本 3.8.1
- 支持 Vungle Android 适配器版本 6.11.0.1。
- 支持 Vungle iOS 适配器版本 6.11.0.0。
- 使用 Google 移动广告 Unity 插件 7.0.2 版进行构建和测试。
版本 3.8.0
- 支持 Vungle Android 适配器版本 6.11.0.0。
- 支持 Vungle iOS 适配器版本 6.11.0.0。
- 使用 Google 移动广告 Unity 插件 7.0.0 版进行构建和测试。
版本 3.7.5
- 支持 Vungle Android 适配器版本 6.10.5.0。
- 支持 Vungle iOS 适配器版本 6.10.6.1。
- 使用 Google 移动广告 Unity 插件 7.0.0 版进行构建和测试。
版本 3.7.4
- 支持 Vungle Android 适配器版本 6.10.4.0。
- 支持 Vungle iOS 适配器版本 6.10.6.1。
- 使用 Google 移动广告 Unity 插件 7.0.0 版进行构建和测试。
版本 3.7.3
版本 3.7.2
版本 3.7.1
版本 3.7.0
版本 3.6.0
版本 3.5.1
版本 3.5.0
版本 3.4.1
版本 3.4.0
版本 3.3.1
- 将
vungle-extras-library.jar
重新打包为vungle-unity-android-library.aar
,使用.aar
build 以支持 Unity 2020。- 升级到此版本时,请从您的项目中移除
vungle-extras-library.jar
。
- 升级到此版本时,请从您的项目中移除
- 支持 Vungle Android 适配器版本 6.5.3.0。
- 支持 Vungle iOS 适配器版本 6.5.3.0。
版本 3.3.0
版本 3.2.0
版本 3.1.4
- 支持 Android 适配器版本 6.3.24.1。
- 支持 iOS 适配器版本 6.3.2.3。
版本 3.1.3
- 支持 Android 适配器版本 6.3.24.1。
- 支持 iOS 适配器版本 6.3.2.2。
版本 3.1.2
- 更新了插件,以支持新的开放式 Beta 版激励广告 API。
- 支持 Android 适配器版本 6.3.24.1。
- 支持 iOS 适配器版本 6.3.2.1。
版本 3.1.1
- 支持 Android 适配器版本 6.3.24.0。
- 支持 iOS 适配器版本 6.3.2.0。
- 更新了
Vungle.UpdateConsentStatus()
方法,使consentMessageVersion
参数成为可选参数。现在,系统会忽略 iOS 设备上的consentMessageVersion
值。 - 针对 iOS 废弃了
Vungle.GetCurrentConsentMessageVersion()
。
版本 3.1.0
- 支持 Android 适配器版本 6.3.17.0。
- 支持 iOS 适配器版本 6.3.0.0。
- 更新了
Vungle.UpdateConsentStatus()
方法,以便针对发布商提供的用户意见征求消息版本接受额外的String
参数。 - 添加了
Vungle.GetCurrentConsentMessageVersion()
方法,用于获取发布商提供的用户意见征求消息版本。
版本 3.0.1
- 支持 Android 适配器版本 6.2.5.1。
- 支持 iOS 适配器版本 6.2.0.3。
版本 3.0.0
- 支持 Android 适配器版本 6.2.5.0。
- 支持 iOS 适配器版本 6.2.0.2。
- 添加了以下方法:
Vungle.UpdateConsentStatus()
方法设置将记录在 Vungle SDK 中的同意情况。Vungle.GetCurrentConsentStatus()
方法来获取用户的当前意见征求状态。
版本 2.0.0
- 支持 Android 适配器版本 5.3.2.1。
- 支持 iOS 适配器版本 6.2.0.0。
版本 1.1.0
- 支持 Android 适配器版本 5.3.2.1。
- 支持 iOS 适配器版本 5.4.0.0。
版本 1.0.0
- 首次发布!
- 支持 Android 适配器版本 5.3.0.0。
- 支持 iOS 适配器版本 5.3.0.0。