跳转到主要内容

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.

管理广告单元

创建广告单元

您可以从侧边栏的广告单元页面或直接从应用页面创建广告单元。从应用页面创建时,系统会自动为您预选该应用。 创建广告单元:
  1. 点击 + 添加广告单元
  2. 为广告单元命名,名称须与 SDK 代码中的名称完全一致
  3. 选择该广告单元所属的应用(如尚未选择)
  4. 选择广告格式
  5. 配置特定格式的设置
  6. 点击保存

广告格式

格式尺寸说明
横幅广告320x50支持自动刷新的标准横幅广告
MREC300x250适用于内容信息流的中等矩形广告
插屏广告全屏在自然过渡时展示的全屏广告
激励视频广告全屏用户观看后可获得奖励的视频广告(如额外生命、游戏货币)

广告格式设置

1. 横幅广告、MREC: 横幅广告、MREC 刷新率 - 横幅广告的刷新间隔,以秒为单位。常用值为 30、60 或 90 秒。设置为 0 可禁用自动刷新。 2. 激励视频广告: 激励视频广告
  • 奖励金额 - 用户观看广告后获得的物品数量。例如,10 枚金币或 1 条额外生命。
  • 奖励货币 - 奖励的名称。例如,金币、宝石或额外生命。
  • 奖励回调 URL - 服务器到服务器的回调 URL,当用户完成激励视频广告后,CloudX 会调用此 URL。在向用户发放奖励前,可使用此功能在您的后端验证奖励。详见激励回调

激励回调

当用户完成激励广告后,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 编码
{EVENT_ID}奖励事件的唯一标识符。
{EVENT_TOKEN}基于 Event ID 生成的验证令牌,可用于服务端回调验证。
{AMOUNT}广告单元上配置的奖励数量(数字)。始终存在,默认为 0
{CURRENCY}广告单元上配置的奖励货币名称。
{CUSTOM_DATA}SDK 传递的自定义字符串。可用于将游戏关卡或用户状态等上下文附加到回调中。
{REVENUE}单次展示收入值(数字)。如不可用,默认为 0
标记为 URL 编码的宏会进行百分号编码,确保可安全用作查询参数值。如果宏的值未设置,将替换为空字符串——占位符不会被原样发送。

重试行为

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

创建广告单元后

广告单元创建完成后:
  1. 在 SDK 代码中使用完全相同的广告单元名称进行引用
  2. 创建行项目,定义哪些需求来源投放广告及其出价
  3. 配置网络映射,将广告单元与需求合作伙伴连接