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 步:测试和验证
- 将设备注册为 CloudX 测试设备:进入
开发工具→测试设备,添加设备并将该应用纳入其范围,然后打开测试流量。 - 建议在 Pangle 支持的国家/地区使用真机进行测试,因为 Pangle 在模拟器上可能不会出价。在美国,仅测试 Rewarded 和 Interstitial 广告单元,且需在 CloudX 为您的账号开启美国的 Pangle 之后进行。
- 使用 CloudX
app_key和正确的 CloudX 广告单元标识符构建并运行应用。 - 从每个已映射的广告单元发起广告请求。
- 确认广告能够正常加载,并且 Pangle 会按预期参与竞价或胜出。
问题排查
列表中没有 Pangle
Pangle 目前在 CloudX 中处于测试阶段。如果在 Bidders 中看不到它,请联系 CloudX 客户经理申请访问权限。
Pangle 没有参与竞价
请先检查以下项目:
Pangle已在Bidders中启用- 应用已配置有效的
Pangle App ID - 广告单元已配置有效的
Pangle Placement ID,且该 placement 与广告单元格式匹配 - 该广告单元上已存在
Pangleline 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 ID | app_id | 应用 |
Pangle Placement ID | placement_id | 广告单元 |