本指南介绍了如何使用 Google Mobile Ads Unity Plugin 通过 AdMob 中介加载和展示来自 BIGO Ads SDK 的广告(内容涵盖出价集成)。本指南介绍了如何将 BIGO Ads SDK 添加到广告单元的中介配置中,以及如何将 BIGO Ads SDK 和适配器集成到 Unity 应用中。
支持的集成和广告格式
适用于 BIGO Ads SDK 的 AdMob 中介适配器具有以下功能:
| 集成 | |
|---|---|
| 出价 | 1 |
| 瀑布 | |
| 格式 | |
| 开屏广告 | |
| 横幅广告 | |
| 插页式广告 | |
| 已获得奖励 | |
| 插页式激励广告 | |
| 原生 | |
1 出价集成功能目前处于非公开 Beta 版阶段,请与您的客户经理联系以申请访问权限。
要求
- 最新版 Google Mobile Ads Unity Plugin
- Unity 2019.4 或更高版本
- 如需在 Android 上部署,则要求:
- Android API 级别 23 或更高级别
- 如需在 iOS 上部署,则要求:
- iOS 部署目标版本为 13.3 或更高版本
- 已配置 Google Mobile Ads Unity Plugin 的有效 Unity 项目。如需了解详情,请参阅使用入门。
- 设置 AdMob 中介
第 1 步:在 BIGO Ads SDK 界面中设置配置
登录您的 BIGO Ads 信息中心。
创建应用
前往广告资源标签页,然后在应用和网站表格下选择 + 添加按钮。
填写表单的其余部分,然后点击提交。
记下您的应用 ID。
Android
iOS
创建广告位
您的申请获得审核后,前往广告位表格,然后选择 + 添加按钮。
为 Auction Type(竞价类型)选择 Server Bidding(服务器出价),填写表单的其余部分,然后点击 Submit(提交)。
记下插槽 ID
Android
iOS
更新 app-ads.txt
应用授权卖方 (app-ads.txt) 是一项 IAB Tech Lab 计划,有助于确保只通过您认定的授权渠道销售您的应用广告资源。为避免损失大量广告收入,您需要实施 app-ads.txt 文件。
如果您尚未完成此项设置,请为您的应用设置 app-ads.txt 文件。
如需为 BIGO Ads SDK 实现 app-ads.txt,请从信息中心前往 APP-ads.txt 标签页,然后按照该标签页中的说明操作。
第 2 步:在 AdMob 界面中设置 BIGO Ads SDK 需求
为广告单元配置中介设置
将 BIGO TECHNOLOGY PTE LTD 添加到 GDPR 和美国州级法规广告合作伙伴名单中
请按照欧洲法规设置和美国州级法规设置中的步骤,将 BIGO TECHNOLOGY PTE LTD 添加到 AdMob 界面内的欧洲法规和美国州级法规广告合作伙伴名单中。
第 3 步:导入 BIGO Ads SDK 和适配器
OpenUPM-CLI
如果您已安装 OpenUPM-CLI,则可以运行以下命令,将 Google 移动广告 BIGO Ads SDK 中介插件(适用于 Unity)安装到您的项目中(从项目的根目录运行):
openupm add com.google.ads.mobile.mediation.bigoOpenUPM
在 Unity 项目编辑器中,依次选择 Edit(修改)> Project Settings(项目设置)> Package Manager(资源包管理器),打开 Unity 资源包管理器设置。
在限定范围的注册表标签页下,添加 OpenUPM 作为限定范围的注册表,并提供以下详细信息:
- 名称:
OpenUPM - URL:
https://package.openupm.com - 范围:
com.google
然后,依次前往 Window > Package Manager,打开 Unity Package Manager,并从下拉菜单中选择 My Registries。
选择 Google Mobile Ads Bigo Mediation 软件包,然后点击 Install。
Unity 软件包
从更改日志中的下载链接下载最新版 Google 移动广告中介插件(适用于 BIGO 广告 SDK),然后从 ZIP 文件中提取 GoogleMobileAdsBigoMediation.unitypackage。
在 Unity 项目编辑器中,依次选择 Assets > Import Package > Custom Package,然后找到您下载的 GoogleMobileAdsBigoMediation.unitypackage 文件。确保已选择所有文件,然后点击导入。
然后,依次选择 Assets > External Dependency Manager > Android Resolver > Force Resolve。外部依赖项管理器库将从头开始执行依赖项解析,并将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。
第 4 步:在 BIGO Ads SDK 上实现隐私设置
如需为 BIGO Ads SDK 实现隐私设置并遵守相关隐私权法规,请阅读以下部分。
欧盟地区意见征求和《一般数据保护条例》(GDPR)
为了遵守 Google 的《欧盟地区用户意见征求政策》,您必须向欧洲经济区 (EEA)、英国和瑞士的用户披露某些信息,并征得他们同意,才能在法律要求的情况下使用 Cookie 或其他本地存储空间,以及收集、分享和使用个人数据以实现广告个性化。此政策反映了欧盟《电子隐私指令》和《一般数据保护条例》(GDPR) 的要求。您要负责验证用户意见是否已传播到中介链中的每个广告来源。Google 无法自动将用户意见传递给此类广告资源网。
BIGO 广告 SDK 会自动读取由意见征求管理平台(包括 UMP SDK)设置的 GDPR 意见征求。如需了解详情,请参阅 BIGO Ads SDK 的 GDPR 指南(Android 版和 iOS 版)。
美国州级隐私保护法律
美国各州隐私保护法律要求向用户提供选择拒绝“出售”其“个人信息”(该法律中对这些术语做出了定义)的权利,“出售”方须在首页醒目位置提供“Do Not Sell My Personal Information”(不出售我的个人信息)链接,以供这些用户选择。美国州级隐私保护法律合规性指南可让您为 Google 广告投放启用受限的数据处理,但 Google 无法将此设置应用于您的中介链中的每个广告联盟。因此,您必须确定中介链中可能参与个人信息出售的每个广告联盟,并遵循这些广告联盟的指南来确保合规性。
以下示例代码展示了如何将用户意见标志传递给 BIGO Ads SDK。在通过 Google Mobile Ads Unity Plugin 请求广告之前调用此方法。
using GoogleMobileAds.Mediation.Bigo.Api;
// ...
Bigo.SetCcpaConsent(true);
第 5 步:添加必需的代码
Android
集成 BIGO Ads SDK 无需添加其他代码。
iOS
SKAdNetwork 集成
按照 BIGO Ads SDK 的文档将 SKAdNetwork 标识符添加到项目的 Info.plist 文件中。
第 6 步:测试您的实现
启用测试广告
确保针对 AdMob 注册测试设备。
BIGO Ads 针对 Android 和 iOS 提供了测试应用 ID 和广告资源 ID,以帮助您进行测试和集成。
验证测试广告
若要验证您是否能收到来自 BIGO Ads SDK 的测试广告,请在广告检查器中启用 single ad source testing(单个广告来源测试),并选择 BIGO Ads SDK (Bidding)(BIGO Ads SDK [出价])作为广告来源。
错误代码
如果适配器未能收到来自 BIGO Ads SDK 的广告,您可以使用 ResponseInfo 来检查广告响应中归属于以下类的底层错误:
Android
sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter
iOS
GADMediationAdapterBigo
以下是当广告加载失败时,BIGO Ads SDK 适配器会抛出的代码和随附的消息:
Android
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.mediation.bigoadapter | Bigo 广告位 ID 缺失或为空。 |
| 1000-1100 | 由 BIGO Ads SDK 发送 | BIGO Ads SDK 返回了错误。如需了解详情,请参阅 BIGO Ads SDK 的文档。 |
iOS
| 错误代码 | 网域 | 原因 |
|---|---|---|
| 101 | com.google.ads.mediation.bigo | 服务器配置缺少必需的应用 ID。 |
| 102 | com.google.ads.mediation.bigo | 广告配置无效。 |
| 103 | com.google.ads.mediation.bigo | 广告展示失败。 |
| 104 | com.google.ads.mediation.bigo | 横幅广告尺寸不受支持。 |
| 105 | com.google.ads.mediation.bigo | Bigo 成功加载了横幅广告,但缺少广告浏览量。 |
| 1000-1100 | 由 BIGO Ads SDK 发送 | BIGO Ads SDK 返回了错误。如需了解详情,请参阅 BIGO Ads SDK 的文档。 |
BIGO Ads SDK Unity 中介插件变更日志
版本 1.0.0
- 初始版本!
- 支持 BIGO Ads SDK Android 适配器版本 5.8.0.0。
- 支持 BIGO Ads SDK iOS 适配器版本 5.1.2.0。
- 使用 Google 移动广告 Unity 插件 11.0.0 版构建并测试。