Open RTB 2.5 出价请求

本页描述您将接收到的 RTB 请求的各个组成部分，以便出价。

竞价请求头

• OpenRTB 版本 HTTP 头： x-openrtb-version: 2.5
• Keep-Alive HTTP 头： Connection: Keep-Alive
• 内容 JSON：内容类型： application/json
• 数据编码头： Accept-Encoding

出价请求 2.5

当针对特定场景请求出价时，平台将发起一个 HTTP 请求，超时时间为 300ms 并在请求正文中发送以下以 JSON 编码的对象。 HTTP 由于使用 HTTPS 会增加额外延迟，建议使用。

属性	描述
id	唯一竞价请求 ID（字符串）
site	通过 Site 对象提供的有关发布商网站的详细信息（对象）
device	将投放该展示的用户设备详细信息（对象）
user	设备的人类用户；广告受众的详细信息（对象）
imp	正在拍卖的广告位或展示的详细信息（对象）
regs	本请求适用的任何行业、法律或政府法规的详细信息（对象）
ext	OpenRTB 扩展的占位符（对象）

site

属性	描述
id	唯一站点 ID（字符串）
domain	站点的域名（字符串）
cat	IAB 类别 ID（字符串数组）
page	将展示广告的页面完整 URL（字符串）
keywords	关键词可用于确保广告位获得正确类型的广告。关键词应为以逗号分隔的单词字符串
ext	交易所特定扩展的占位符（对象）

site.ext

属性	描述
exchangecat	自定义 ExoClick 类别 ID（整数）
idzone	自定义 ExoClick 广告位 ID（整数）
keyword	匹配关键词（如有）（字符串）

device

属性	描述
ua	浏览器用户代理（字符串）
sua	结构化的用户代理信息，可在客户端支持 User-Agent Client Hints 时使用（对象）
geo	设备的位置，假定为由 Geo 对象定义的用户当前位置
ip	用户的 IPv4 地址（字符串）*
ipv6	用户的 IPv6 地址（字符串）*
language	浏览器语言（字符串）
os	操作系统（字符串）
js	是否支持 JavaScript，其中 0 = 否，1 = 是（整数）
ext	用于 OpenRTB 交换方特定扩展的占位符（对象）

*竞价请求中只会出现 ip 或 ipv6 中的一个。

device.geo

属性	描述
country	国家 ISO3
ipservice	如适用，用于根据 IP 地址确定地理位置的服务或提供商（整数）

device.ext

属性	描述
remote_addr	用户的主 IP 地址（字符串）
x_forwarded_for	用户的 X-FORWARDED-FOR IP 地址；若未设置则为空（字符串）

device.sua

结构化用户代理信息。 device.sua 被认为是设备属性更准确的表示。

属性	描述
browsers	发送从 Sec-CH-UA-Full-Version-List 头部派生的品牌和版本。（ BrandVersion BrandVersion 对象数组）
platform	发送从 Sec-CH-UA-Platform 头部派生的品牌，以及从 Sec-CH-UA-Platform-Version 头部派生的版本。（BrandVersion 对象）
mobile	从 Sec-CH-UA-Mobile 头部派生此值。（整数）
architecture	从 Sec-CH-UA-Arch 头部获取此值。（字符串）
bitness	从 Sec-CH-UA-Bitness 头部获取此值。（字符串）
model	从 Sec-CH-UA-Model 头部获取此值。（字符串）
source	用于创建此对象的数据来源， 列表：User-Agent 来源 在 AdCOM 1.0 中（整数；默认 0）

device.sua.browsers | device.sua.platform

属性	描述
brand	该值可能来自 User-Agent Client Hints 头部，表示用户代理品牌（来自 Sec-CH-UA-Full-Version 头部）或平台品牌（来自 Sec-CH-UA-Platform 头部）。（字符串）
version	版本组件序列，按降序层级顺序 [主版本、次版本、微版本、…]（字符串数组）

user

属性	描述
id	唯一用户 ID（字符串）

user.ext

属性	描述
同意	这是 IAB 标准要求的同意字符串。目前仅支持否定同意（字符串）

regs

属性	描述
ext	用于 OpenRTB 交易平台特定扩展的占位符。

regs.ext

属性	描述
gdpr	如果调用方认为用户不受 GDPR 约束，则为 0；如果用户受 GDPR 约束，则为 1。若都不是，则该参数将未定义。

imp

属性	描述
id	在出价请求上下文中此展示的唯一标识符（字符串）
instl	1 = 该广告为插屏或全屏，0 = 非插屏（整数）
video	通过 Video 对象提供的、表示流内视频展示的详细信息
secure	指示该展示是否需要安全 HTTPS URL 的标志（整数）
ext	用于 OpenRTB 交换方特定扩展的占位符（对象）

imp.video

属性	描述
mimes	支持的内容 MIME 类型（例如，“video/mp4”）（字符串数组）
minduration	视频广告最小时长（秒）（整数)
maxduration	视频广告最长时长（秒）（整数)
protocols	支持的视频协议数组（整数）
linearity	指示该展示是否必须为线性、非线性等。如果未指定，则假定全部允许（整数）
boxingallowed	指示是否允许将 4:3 内容以黑边方式放入 16:9 窗口，其中 0 = 否，1 = 是（整数）
位置	屏幕上的广告位置（整数）
h	视频播放器宽度，单位为设备无关像素（DIPS）（整数）
w	视频播放器高度，单位为设备无关像素（DIPS）（整数）
ext	用于 OpenRTB 交换方特定扩展的占位符（对象）

imp.video.ext

属性	描述
区域类型	ExoClick 广告格式中的区域类型（例如：video_slider）