BIGO Ads

使用本指南在 CloudX 中配置 BIGO Ads 竞价。

SDK 安装和广告加载方式请继续参考平台集成文档：

• Android 集成指南

如需查看各平台特有的 BIGO Ads 适配器要求，请参阅：

• Android BIGO Ads 适配器页面

BIGO Ads 适配器目前仅提供 Android 版本。

概览

请使用以下值：

• 在 CloudX 应用映射中填写 Bigo App ID
• 在 CloudX 广告单元映射中填写 Bigo Slot ID
• 在应用代码中使用 CloudX app_key 和 CloudX 广告单元标识符

CloudX 在控制台中使用的 bidder 名称为 Bigo Ads，与 BIGO Ads 平台上的 BIGO Ads 是同一广告网络。

CloudX 会在内部收集 BIGO Ads 的 bidder token，因此您无需在应用代码中自行获取 BIGO Ads bidder token。

支持的广告格式：

• Banner（320x50）
• MREC（300x250）
• Interstitial
• Rewarded

不支持 Native 和 App Open。

第 1 步：完成 BIGO Ads 侧配置

1. 登录 BIGO Ads 平台。
2. 添加您要变现的应用，并填写其商店页面 URL。您填写的应用域名必须与该应用商店页面上的开发者网站一致；BIGO Ads 会对两者进行核验。
3. 复制该应用对应的 BIGO Ads App ID。
4. 将 BIGO Ads 平台为您的账号列出的 app-ads.txt 条目添加到该开发者网站上托管的 app-ads.txt 文件中。
5. 为您要使用的每种广告格式创建 slot，并选择 Server Bidding 竞价类型。只有 Server Bidding 类型的 slot 可与 CloudX 配合使用。
6. 在 BIGO Ads 平台上，为与 CloudX 配合使用的 slot 关闭横幅自动刷新。横幅刷新由 CloudX SDK 负责；BIGO Ads SDK 内部的第二个刷新循环会加载从未在 CloudX 竞价中胜出的素材。
7. 复制每个 Slot ID。
8. 在预期接入正式流量前，先完成 BIGO Ads 应用审核和收款设置。

第 2 步：在 CloudX 中启用 BIGO Ads

前往控制台导航中的 Bidders，在 bidder 列表中选择 Bigo Ads，然后点击 Enable。

如果 Bigo Ads 未启用，即使映射配置正确，CloudX 也不会发起竞价请求。如果 Bidders 中未显示 Bigo Ads，请联系您的 CloudX 客户经理。

启用后，您可以在同一页面填写 Bigo App ID 和 Slot ID：搜索应用、选中它，然后为每个符合条件的广告单元填写 App ID 和 Slot ID。也可以在后续步骤中从应用页面和广告单元页面配置相同的值。

第 3 步：配置 CloudX 应用

前往 Inventory -> Apps，创建或打开与您的移动应用对应的应用。填写该应用的 Bigo App ID。

同时从应用详情页复制 CloudX app_key。在 Android 代码中使用该 CloudX app_key。

第 4 步：配置 CloudX 广告单元

前往 Inventory -> Ad units，为每个符合条件的广告单元添加以下映射。

• 应将 Bigo Slot ID 视为必填。
• 让 slot 的广告格式与 CloudX 广告单元格式匹配。
• 按需为每个 CloudX 广告单元或广告格式使用单独的 Server Bidding slot。

第 5 步：添加 BIGO Ads line item

前往 Line Items，在每个需要让 BIGO Ads 参与竞争的 CloudX 广告单元上，为 bidder Bigo Ads 创建 line item。

• 使用 bidder Bigo Ads
• 让 line item 与正确的广告格式匹配
• 对每个需要 BIGO Ads 参与竞价的广告单元重复上述配置

第 6 步：完成应用集成

请完成对应平台的集成和适配器配置：

• Android 集成指南
• Android BIGO Ads 适配器页面

在应用代码中：

• 使用 CloudX app_key 初始化 CloudX
• 使用 CloudX 广告单元标识符加载广告
• 不要在应用代码中传入 Bigo App ID 或 Slot ID
• 对于插屏和激励广告，仅在广告准备完成后再调用 show()

第 7 步：测试和验证

1. 将设备注册为 CloudX 测试设备：打开应用页面，点击 ⋮ 菜单，选择 Test devices，添加设备，并打开 Test Traffic。
2. 也可以选择在开发构建中映射 BIGO Ads 平台文档提供的测试 App ID 和 Slot ID，它们会返回测试广告。发布前请切换回正式 ID。
3. 使用 CloudX app_key 和正确的 CloudX 广告单元标识符构建并运行应用。
4. 从每个已映射的广告单元发起广告请求。
5. 确认广告能够正常加载，并且 BIGO Ads 会按预期参与竞价或胜出。

问题排查

BIGO Ads 没有参与竞价

请先检查以下项目：

• Bigo Ads 已在 Bidders 中启用
• 应用已配置有效的 Bigo App ID
• 广告单元已配置有效的 Bigo Slot ID
• 该广告单元上已存在 Bigo Ads line item
• 应用已在 BIGO Ads 平台通过审核，且其应用域名与商店页面上的开发者网站一致
• 您的 app-ads.txt 文件包含 BIGO Ads 平台为您的账号列出的条目

BIGO Ads 已出价但广告未正常展示

请检查以下项目：

• 您的应用使用的是 CloudX app_key，而不是 BIGO Ads ID
• 您的应用加载的是目标 CloudX 广告单元
• 该 slot 属于正确的 BIGO Ads 应用和广告格式，并使用 Server Bidding 竞价类型
• 已安装 BIGO Ads 适配器，并完成 Android BIGO Ads 适配器页面中的网络安全配置

Slot 看起来正确，但仍然加载失败

移动端适配器在加载时要求有效的 Bigo Slot ID。请重新检查 CloudX 中广告单元级别的 slot 映射。

映射参考