For the complete documentation index, see llms.txt. This page is also available as Markdown.

开放 RTB 2.5 出价响应

对出价请求的响应将具有以下结构:

出价响应对象

属性
描述

id

出价请求的 ID(字符串)

seatbid

代表特定 seat 由竞标方提交的出价集合。

seatbid

属性
描述

bid

此出价适用的展示对象 ID(字符串)

seatbid.bid

属性
描述

id

由竞标方选定的出价对象 ID(字符串)

impid

此出价适用的展示对象 ID(字符串)

价格

以 CPM 或 CPC 计的出价价格(浮点数)

adm

ExoClick XML 广告标记(字符串)

nurl

赢标通知 URL(字符串)

burl

计费通知 URL(字符串)

cid

用于辅助广告质量检查的 Campaign ID(字符串)

crid

用于辅助广告质量检查的创意 ID(字符串)

adid

用于辅助广告质量检查的广告 ID(与 crid 相同)(字符串)

adomain

广告主域名,或交易平台域名(字符串数组)

cat

创意的 IAB 内容分类(字符串数组)

w

创意宽度(整数)

h

创意高度(整数)

ext

ExoClick 特定扩展(对象)

seatbid.bid.ext

属性
描述

btype

计价模型。取值:1 = CPM,2 = CPC。默认值 = 1(整数)。

注意:只有推送通知、原生广告、直链和邮件点击可以使用 CPC 计价模型出价。

无出价响应

若要在不实际出价的情况下响应出价请求,将返回 HTTP 响应码 204 “No Content”。

赢标通知

当参数 出价响应对象 -> Seat Bid 对象 -> Bid 对象 -> nurl 出现在出价响应中时,必须向该 URL 发起 GET 请求。

计费通知

当参数 出价响应对象 > Seat Bid 对象 > Bid 对象 > burl 出现在出价响应中时,当展示或点击变为可计费(按 btype 字段)时,将向该 URL 发起 GET 请求。这使展示或点击可以从可计费事件而不是基于客户端的跟踪中进行计数,并提供并行的 “Served” 指标 在 RTB 统计中。 用于显示实际渲染与计费之间差异。

如果 nurl 和 burl 都存在,则两者都应被调用。

计数逻辑

  • 当 BURL 禁用时 — 展示或点击完全依赖于由已渲染广告触发的客户端跟踪器。这是当前展示和点击计数的默认方式。

  • 当 BURL 启用时 — 展示或点击从 burl 调用中计数,而不是从客户端跟踪中计数。

  • 当 BURL 已启用但合作方未触发时 — 为计费目的,展示或点击计数降为零,而已展示的曝光(浏览器记录的内容)仍然保留。此差异表明存在技术集成问题。

哪些内容仍保留在客户端跟踪中

  • 频次控制。无论 BURL 开关如何,FC 仍继续依赖展示事件。

  • 所有“Served”,从定义上就是如此。

  • 直投(非 RTB)广告位,它们没有 BURL 概念。

示例

你可以在以下位置找到你可能收到的响应的详细示例: 示例页面.

最后更新于

这有帮助吗?