Documentation Index
Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
Use this file to discover all available pages before exploring further.

创建广告单元
您可以从侧边栏的广告单元页面或直接从应用页面创建广告单元。从应用页面创建时,系统会自动为您预选该应用。 创建广告单元:- 点击 + 添加广告单元
- 为广告单元命名,名称须与 SDK 代码中的名称完全一致
- 选择该广告单元所属的应用(如尚未选择)
- 选择广告格式
- 配置特定格式的设置
- 点击保存
广告格式
| 格式 | 尺寸 | 说明 |
|---|---|---|
| 横幅广告 | 320x50 | 支持自动刷新的标准横幅广告 |
| MREC | 300x250 | 适用于内容信息流的中等矩形广告 |
| 插屏广告 | 全屏 | 在自然过渡时展示的全屏广告 |
| 激励视频广告 | 全屏 | 用户观看后可获得奖励的视频广告(如额外生命、游戏货币) |
广告格式设置
1. 横幅广告、MREC:

- 奖励金额 - 用户观看广告后获得的物品数量。例如,10 枚金币或 1 条额外生命。
- 奖励货币 - 奖励的名称。例如,金币、宝石或额外生命。
- 奖励回调 URL - 服务器到服务器的回调 URL,当用户完成激励视频广告后,CloudX 会调用此 URL。在向用户发放奖励前,可使用此功能在您的后端验证奖励。详见激励回调。
激励回调
当用户完成激励广告后,CloudX 会向您配置的回调 URL 发送 HTTP GET 请求。您可以在服务器端验证奖励后再向用户发放。 在奖励回调 URL 字段中,粘贴包含以下宏的 URL。CloudX 在发送请求前会将每个宏替换为实际值。 示例:支持的宏
| 宏 | 描述 | URL 编码 |
|---|---|---|
{EVENT_ID} | 奖励事件的唯一标识符。 | 否 |
{EVENT_TOKEN} | 基于 Event ID 生成的验证令牌,可用于服务端回调验证。 | 否 |
{AMOUNT} | 广告单元上配置的奖励数量(数字)。始终存在,默认为 0。 | 否 |
{CURRENCY} | 广告单元上配置的奖励货币名称。 | 是 |
{CUSTOM_DATA} | SDK 传递的自定义字符串。可用于将游戏关卡或用户状态等上下文附加到回调中。 | 是 |
{REVENUE} | 单次展示收入值(数字)。如不可用,默认为 0。 | 否 |
重试行为
如果您的服务器超时,CloudX 最多重试 2 次。非超时错误(4xx、5xx)不会重试。请确保您的端点在几秒内响应。创建广告单元后
广告单元创建完成后:- 在 SDK 代码中使用完全相同的广告单元名称进行引用
- 创建行项目,定义哪些需求来源投放广告及其出价
- 配置网络映射,将广告单元与需求合作伙伴连接