概览AndroidiOSUnityReact NativeFlutterCLIAPIMCP需求广告格式Dashboard更新日志

Thunder Monetize（BETA）

使用本指南在 CloudX 中启用 Thunder Monetize 竞价。

CloudX SDK 安装和广告加载步骤请参阅平台集成指南：

Thunder Monetize 是服务器端竞价方。CloudX 在服务器上请求出价，并使用 CloudX SDK 的内置渲染器展示获胜的广告素材。应用无需添加 Thunder Monetize SDK 或适配器。Thunder Monetize 需要 CloudX Android SDK 4.9.0 或更高版本，以及 CloudX iOS SDK 3.8.0 或更高版本。

Thunder Monetize 直接购买您的流量：您需要与 Thunder Monetize 签订自己的协议，Thunder Monetize 直接向您支付其购买的展示费用。

概述

Thunder Monetize 在 CloudX 中无需配置凭据或网络映射，包括 Thunder Monetize 账号 ID、应用 ID 或广告位 ID。完成对接后，添加 Thunder Monetize 的 app-ads.txt 条目、启用竞价方并添加广告项即可。

支持的广告格式

  • 横幅广告（320x50）
  • MREC（300x250）
  • 插屏广告
  • 激励视频广告

暂不支持原生广告和开屏广告（App Open）。

GDPR 流量的用户同意

如果您的应用通过 IAB TCF 同意管理平台（CMP）收集用户同意，请将 Thunder Monetize 的两个供应商都加入 CMP 的供应商列表：THUNDER MONETIZATION PTE. LTD.（IAB TCF 供应商 ID：1580）和 HONGKONG THUNDER SOLUTION LIMITED（IAB TCF 供应商 ID：1579）。添加后，请确保 CMP 重新向现有用户征求同意，使其同意字符串包含 Thunder Monetize。

第 1 步：完成 Thunder Monetize 对接

在 CloudX 中启用 Thunder Monetize 之前，请联系 Thunder Monetize 客户经理签订直接协议。如果您没有 Thunder Monetize 联系人，请让 CloudX 客户经理协助对接。

向 Thunder Monetize 提供您计划启用的应用：

  • Android 包名，例如 com.example.app
  • iOS 应用的数字 App Store ID，例如 6448392061

将以下 Thunder Monetize 条目添加到您的 app-ads.txt 文件中。以下是 CloudX 对 Thunder Monetize 要求的条目。CloudX 控制台中的 App-ads.txt 页面会显示您文件所需的完整列表。

正在加载 app-ads.txt 条目…

将这些条目发布到 https://yourdomain.com/app-ads.txt。其中 yourdomain.com 是 App Store 或 Google Play 中列出的开发者网站域名。保留您的 CloudX DIRECT 条目和其他广告网络的现有条目，包括文件中已有的 Thunder Monetize 条目。如果 Thunder Monetize 为您的账号提供了 app-ads.txt 条目，也请一并添加。

第 2 步：在 CloudX 中启用 Thunder Monetize

进入 Bidders，选择 Thunder Monetize，点击 Enable，然后点击 Confirm。

无需填写任何内容：Thunder Monetize 在 CloudX 中没有账号级凭据、应用映射或广告位映射。如果禁用 Thunder Monetize，CloudX 将不会为您的任何库存请求 Thunder Monetize 出价。

第 3 步：添加 Thunder Monetize 广告项

进入 Line Items，为需要 Thunder Monetize 参与竞价的每个 CloudX 广告单元创建竞价方为 Thunder Monetize 的广告项。

  • 选择竞价方 Thunder Monetize
  • 定向到横幅、MREC、插屏或激励视频广告单元
  • 为每个需要 Thunder Monetize 参与竞价的广告单元重复配置

广告项生效后，请通知您的 Thunder Monetize 联系人。Thunder Monetize 会检查来自您应用的首批请求，然后为您的应用开启需求。

第 4 步：测试和验证

Thunder Monetize 不为 CloudX 提供正式的 RTB 测试模式。在 Thunder Monetize 确认已为您的应用开启需求后，请使用受控的正式流量进行验证。

  1. 使用实体设备。在测试设备中注册该设备，关闭 Test traffic，并开启 Debug Mode 以收集诊断信息。
  2. 使用 CloudX app_key 和正确的 CloudX 广告单元标识符构建并运行应用。不要以测试模式启动 SDK 会话。
  3. 从已启用 Thunder Monetize 的每个横幅、MREC、插屏和激励视频广告单元请求广告。
  4. 确认 Thunder Monetize 按预期参与竞价或获胜，并且返回的广告正常展示。
  5. 流量开始后，与 Thunder Monetize 核对展示次数和收入。

开启 Test traffic 时，已注册的设备会收到测试广告，其数据不会计入收入报表。即使关闭 Test traffic，iOS 模拟器会话和 SDK 测试模式会话仍会发送测试请求。请使用正式流量完成上述广告和收入验证。

小规模测试中的无填充可能是正常情况，本身不能说明配置有问题。

故障排除

列表中没有 Thunder Monetize

Thunder Monetize 目前在 CloudX 中处于测试阶段。如果在 Bidders 中看不到它，请联系 CloudX 客户经理申请访问权限。

Thunder Monetize 未参与竞价

首先检查以下内容：

  • 已在 Bidders 中启用 Thunder Monetize
  • 广告单元已配置 Thunder Monetize 广告项
  • 广告单元为横幅、MREC、插屏或激励视频广告（暂不支持原生广告和开屏广告）
  • Thunder Monetize 已确认在其侧完成该应用的配置
  • 对于 iOS 应用，应用已在 App Store 上架，以便 CloudX 向 Thunder Monetize 发送应用的数字 App Store ID
  • 对于适用 GDPR 的用户，您的 CMP 已包含 Thunder Monetize（供应商 ID：1580 和 1579）；请参阅 GDPR 流量的用户同意

Thunder Monetize 出价，但广告未展示

请检查以下内容：

  • 应用使用 CloudX app_key，并加载预期的 CloudX 广告单元
  • 应用使用 CloudX Android SDK 4.9.0 或更高版本，或 CloudX iOS SDK 3.8.0 或更高版本

Thunder Monetize 素材通过 CloudX SDK 的内置渲染器展示。如果某个素材持续展示失败，请向 CloudX 支持提供应用、广告单元和大致故障时间。

需求低于预期

  • 向 Thunder Monetize 确认您启用的每个应用都已在其侧完成配置。
  • 检查 Thunder Monetize 广告项的底价。只有出价达到广告项底价时，Thunder Monetize 才能获胜。
  • 如果 GDPR 流量没有收到 Thunder Monetize 出价，请检查 CMP 是否已列出 Thunder Monetize，以及是否已重新向现有用户征求同意。
  • 使用受控的正式流量验证，因为 Thunder Monetize 不通过 CloudX 提供 RTB 测试需求。