管理广告单元

广告单元代表应用中展示广告的具体位置。

创建广告单元

您可以从侧边栏的广告单元页面或直接从应用页面创建广告单元。从应用页面创建时，系统会自动为您预选该应用。

创建广告单元：

1. 点击 + 添加广告单元
2. 为广告单元输入名称
3. 选择该广告单元所属的应用（如尚未选择）
4. 选择广告单元类型
5. 配置特定格式的设置
6. 点击保存

广告单元类型

广告格式设置

1. 横幅广告、MREC：

刷新率 - 横幅广告的刷新间隔，以秒为单位（默认值：30）。常用值为 30、60 或 90 秒，最小值为 1 秒。若要完全停止刷新，请使用禁用自动刷新复选框——输入 0 不会被接受。

2. 激励视频广告：

• 奖励金额 - 用户观看广告后获得的物品数量。例如，10 枚金币或 1 条额外生命。

• 奖励货币 - 奖励的名称。例如，金币、宝石或额外生命。

• 奖励回调 URL - 服务器到服务器的回调 URL，当用户完成激励视频广告后，CloudX 会调用此 URL。在向用户发放奖励前，可使用此功能在您的后端验证奖励。详见激励回调。

广告位置回传信号

广告位置设置用于控制 CloudX 针对某个广告单元向竞价方发送的位置回传信号。该信号可帮助竞价方了解广告在屏幕上的实际展示位置，从而更准确地评估竞价机会。

除非当前格式的默认值与广告的实际展示位置不符，否则请保持默认（推荐）。**默认（推荐）**会使用以下各广告格式的默认值：

• 横幅广告发送 1（首屏）。
• MREC 不发送位置回传信号。
• 全屏广告格式发送 7（全屏）。

根据竞价请求中的媒体类型，该值会通过 banner.pos 或 video.pos 字段发送。

设置覆盖值：

1. 打开广告单元
2. 创建广告单元，或选择一个现有广告单元进行编辑
3. 选择与广告实际展示位置相符的值
4. 点击保存或保存更改

在现有广告单元上选择**默认（推荐）**会清除已保存的覆盖值。此设置仅针对支持的广告格式显示；切换到不支持的格式也会清除覆盖值。

频次控制

您可以使用频次控制来限制同一用户在指定时间窗口内看到某个广告单元的展示次数。

CloudX 当前支持以下广告单元频次窗口：

• hour
• day
• session

配置广告单元频次上限

1. 打开广告单元
2. 选择要更新的广告单元
3. 在频次控制区域启用该功能
4. 设置最大展示次数
5. 选择时间窗口
6. 点击保存更改

示例：

• 2 / hour 表示同一用户在一个小时内最多只能看到该广告单元的 2 次展示

生效方式

频次控制会在竞价前检查，但会在展示成功后才计数。

这意味着：

• 仅仅发起一次请求或完成一次竞价不会消耗频次
• 只有广告真正展示后，计数器才会增加
• 当用户达到上限后，受限库存会返回 no fill

说明

• 会话级频次控制要求 SDK 在广告请求中发送 session ID。
• 广告单元频次控制与分群频次控制是独立校验的。如果两者都已配置，请求必须同时通过两种检查才会投放。
• 控制台中的分群页面也支持为分群流量以及未分群流量的默认流量配置频次控制。

激励回调

当用户完成激励广告后，CloudX 会向您配置的回调 URL 发送 HTTP GET 请求。您可以在服务器端验证奖励后再向用户发放。

在奖励回调 URL 字段中，粘贴包含以下宏的 URL。CloudX 在发送请求前会将每个宏替换为实际值。

示例：

https://your-server.com/rewards?event_id={EVENT_ID}&token={EVENT_TOKEN}&amount={AMOUNT}&currency={CURRENCY}&data={CUSTOM_DATA}&revenue={REVENUE}

支持的宏

标记为 URL 编码的宏会进行百分号编码，确保可安全用作查询参数值。如果宏的值未设置，将替换为空字符串——占位符不会被原样发送。

重试行为

如果您的服务器超时，CloudX 最多重试 2 次。非超时错误（4xx、5xx）不会重试。请确保您的端点在几秒内响应。

创建广告单元后

广告单元创建完成后：

1. 在 SDK 代码中使用广告单元 ID 进行引用，可从广告单元页面复制
2. 创建行项目，定义哪些需求来源投放广告及其出价
3. 配置网络映射，将广告单元与需求合作伙伴连接