Pangle(BETA)

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

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

如需查看各平台特有的 Pangle 适配器要求,请参阅:

概览

请使用以下值:

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

CloudX 会通过 Pangle 适配器收集 Pangle 的 bid token,因此您无需在应用代码中自行获取或传入该 token。

支持的广告格式:

  • Banner(320x50)
  • MREC(300x250)
  • Interstitial
  • Rewarded
  • Native
  • App Open

Native-in-banner 和 native-in-MREC 使用单独的 Pangle Native 出价方。请参阅设置 native-in-banner 和 native-in-MREC。在 Unity 应用中,Native 仅支持 iOS。

支持的国家/地区

Pangle 仅在 Pangle 支持的地区购买流量,因此 CloudX 仅为这些国家/地区的用户请求 Pangle 出价。在设置了国家/地区定向的 line item 上,Bidders 选择器会显示 Pangle 是否符合条件。

美国

在美国,Pangle 仅对 Rewarded 和 Interstitial 广告单元出价,报表中这部分流量显示为 Pangle US。

美国流量使用您现有的 Pangle 配置,您无需单独配置任何内容。CloudX 按账号开启此功能,请联系 CloudX 客户经理。开启之前,CloudX 不会为美国用户请求 Pangle 出价。

第 1 步:完成 Pangle 对接并更新 app-ads.txt

在 CloudX 中启用 Pangle 之前,请联系 CloudX 客户经理开始 Pangle 对接。

您需要:

  • 每个要变现的应用对应的 Pangle App ID。
  • 每个要变现的广告单元和广告格式对应的 Pangle Placement ID。

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

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

请将这些条目发布到 https://yourdomain.com/app-ads.txt,其中 yourdomain.com 是 App Store 或 Google Play 中列出的开发者网站域名,并保留 CloudX 和其他广告网络的现有条目。

第 2 步:在 CloudX 中启用 Pangle

前往 Bidders,选择 Pangle,点击 Enable,然后点击 Confirm。

如果 Pangle 未启用,即使映射配置正确,CloudX 也不会向 Pangle 发起竞价请求。

您也可以在此页面填写 Pangle App ID 和 Placement ID,无需在后续两步中填写。

第 3 步:配置 CloudX 应用

前往 Apps,创建或打开与您的移动应用对应的应用。

CloudX 字段填写内容必填
Pangle App ID该应用对应的 Pangle App ID是

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

第 4 步:配置 CloudX 广告单元

前往 Ad Units,为每个符合条件的广告单元添加以下映射。

CloudX 字段填写内容必填
Pangle Placement ID该广告单元和广告格式对应的 Pangle Placement ID是
  • 让每个 Placement ID 与 CloudX 广告单元格式匹配。
  • 按需为每个 CloudX 广告单元或广告格式使用单独的 Pangle placement。

第 5 步:添加 Pangle line item

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

  • 定向到 Banner、MREC、Interstitial、Rewarded、Native 或 App Open 广告单元
  • 对每个需要 Pangle 参与竞价的广告单元重复上述配置

第 6 步:完成应用集成

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

在应用代码中:

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

第 7 步:测试和验证

  1. 将设备注册为 CloudX 测试设备:进入 开发工具 → 测试设备,添加设备并将该应用纳入其范围,然后打开 测试流量。
  2. 建议在 Pangle 支持的国家/地区使用真机进行测试,因为 Pangle 在模拟器上可能不会出价。在美国,仅测试 Rewarded 和 Interstitial 广告单元,且需在 CloudX 为您的账号开启美国的 Pangle 之后进行。
  3. 使用 CloudX app_key 和正确的 CloudX 广告单元标识符构建并运行应用。
  4. 从每个已映射的广告单元发起广告请求。
  5. 确认广告能够正常加载,并且 Pangle 会按预期参与竞价或胜出。

问题排查

列表中没有 Pangle

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

Pangle 没有参与竞价

请先检查以下项目:

  • Pangle 已在 Bidders 中启用
  • 应用已配置有效的 Pangle App ID
  • 广告单元已配置有效的 Pangle Placement ID,且该 placement 与广告单元格式匹配
  • 该广告单元上已存在 Pangle line item
  • 用户或测试设备位于 Pangle 支持的国家/地区;在设置了国家/地区定向的 line item 上,Bidders 选择器会显示 Pangle 是否符合条件
  • 您在使用真机进行测试;模拟器可能收不到 Pangle 出价
  • 在美国,广告单元为 Rewarded 或 Interstitial,且 CloudX 已为您的账号开启美国的 Pangle
  • 已安装 Pangle 适配器,以便 CloudX SDK 收集 Pangle 的 bid token
  • 您的 app-ads.txt 文件包含第 1 步中带有您 Pangle 账号 ID 的 Pangle 条目

Pangle 已出价但广告未正常展示

请检查以下项目:

  • 您的应用使用的是 CloudX app_key,而不是 Pangle ID
  • 您的应用加载的是目标 CloudX 广告单元
  • Pangle App ID 和 Placement ID 属于同一个 Pangle 应用和广告格式
  • 已安装 Pangle 适配器,并完成各平台的要求
  • 插屏和激励广告仅在准备完成后才展示

映射参考

CloudX 字段内部 key作用范围
Pangle App IDapp_id应用
Pangle Placement IDplacement_id广告单元