本页描述了您在竞价时将收到的 RTB 请求的不同组成部分。
投标请求标题
- OpenRTB 版本 HTTP 标头： x-openrtb-version: 2.5
- Keep-Alive HTTP Header: 连接：Keep-Alive
- 内容 JSON：Content-Type： application/json
- 数据编码头： Accept-Encoding
投标申请 2.5
请求特定上下文的投标时，平台将执行超时300 毫秒的 HTTP 请求，并在请求正文中发送以下编码为 JSON 的对象。 由于使用 HTTPS 时会产生额外延迟，建议使用 HTTP**。
| 属性 | 说明 |
|---|
| 本我 | 唯一投标请求 ID(字符串) |
| 地点 | 通过网站对象了解出版商网站的详细信息（对象） |
| 装置 | 用户设备的详细信息，印象信息将被发送到该设备（对象） |
| 用户 | 设备人类用户的详细信息；广告受众（对象） |
| 小鬼 | 拍卖的广告位置或印象的详细信息（对象） |
| 条例 | 针对此请求的任何现行行业、法律或政府法规的详细信息（对象） |
| 绵延 | 用于扩展 OpenRTB 的占位符（对象） |
| 属性 | 说明 |
|---|
| 本我 | 唯一站点 ID(字符串) |
| 领域 | 网站域名(字符串) |
| 猫 | IAB 类别 ID(字符串数组) |
| 页码 | 显示广告的页面的完整 URL(字符串) |
| 关键词 | 关键字可用于确保广告区获得正确类型的广告。关键词应是一串用逗号分隔的单词 |
| 绵延 | 交易所特定扩展名的占位符(对象) |
site.ext
| 属性 | 说明 |
|---|
| 交换猫 | 自定义 ExoClick 类别 ID(整数) |
| idzone | 自定义 ExoClick 广告区 ID(整数) |
| 关键词 | 匹配关键字(如果有)(字符串 |
| 属性 | 说明 |
|---|
| a | 浏览器用户代理(字符串) |
| sua | 结构化用户代理信息，可在客户端支持用户代理客户端提示（对象）时使用 |
| 地理 | 设备位置假定为用户当前所在位置，由地理对象定义 |
| ip | 用户的 IPv4 地址（字符串）* |
| ipv6 | 用户的 IPv6 地址(字符串)* |
| 语言 | 浏览器语言（字符串） |
| os | 操作系统(字符串) |
| js | 支持 JavaScript，0 = 否，1 = 是(整数) |
| 绵延 | 用于对 OpenRTB 进行交易所特定扩展的占位符（对象） |
*投标请求中将包含 ip 或 ipv6 中的一个。
device.geo
| 属性 | 说明 |
|---|
| 国家 | 国家 ISO3 |
| ipservice | 用于根据 IP 地址确定地理位置的服务或提供商（如果适用）（整数 |
device.ext
| 属性 | 说明 |
|---|
| 远程地址 | 用户的主 IP 地址(字符串) |
| x_forward_for | 用户的 X-FORWARDED-FOR IP 地址，未设置时为空(字符串) |
device.sua
结构化用户代理信息。device.sua "被认为是更准确的设备属性表示。
| 属性 | 说明 |
|---|
| 浏览器 | 发送来自 Sec-CH-UA-Full-Version-List 标头的品牌和版本。(品牌版本对象数组） |
| 平台 | 发送源自 Sec-CH-UA-Platform 标头的品牌和源自 Sec-CH-UA-Platform-Version 标头的版本。(品牌版本对象）。 |
| 手机 | 该值来自 Sec-CH-UA-Mobile 标头。（整数） |
| 建筑学 | 从 Sec-CH-UA-Arch 标头读取该值。（字符串） |
| 比特度 | 从 Sec-CH-UA-Bitness 标头读取该值。（字符串） |
| 模型 | 从 Sec-CH-UA-Model 标头读取该值。（字符串） |
| 消息来源 | The source of data used to create this object, List: User-Agent Source in AdCOM 1.0 (integer; default 0) |
| 属性 | 说明 |
|---|
| 品牌 | 该值可能来自用户代理客户端提示标头，代表用户代理品牌（来自 Sec-CH-UA-Full-Version 标头）或平台品牌（来自 Sec-CH-UA-Platform 标头）。(字符串） |
| 版本 | 按降序排列的版本组件序列[大、小、微、......]（字符串数组） |
user.ext
| 属性 | 说明 |
|---|
| 同意 | 这是 IAB 标准所要求的同意字符串。目前只有否定同意（字符串） |
| 属性 | 说明 |
|---|
| 绵延 | 用于对 OpenRTB 进行交易所特定扩展的占位符。 |
regs.ext
| 属性 | 说明 |
|---|
| gdpr | 如果调用者认为用户不在 GDPR 范围内，则该值为 0；如果用户在 GDPR 范围内，则该值为 1。如果两者都不适用，则该参数未定义。 |
| 属性 | 说明 |
|---|
| 本我 | 该印象在投标请求中的唯一标识符（字符串） |
| instl | 1 = 广告为插屏或全屏，0 = 非插屏（整数） |
| 视频 | 通过代表流内视频印象的视频对象提供详细信息 |
| 巩 | 表示印象是否需要安全 HTTPS URL 的标志（整数） |
| 绵延 | 用于对 OpenRTB 进行交易所特定扩展的占位符（对象） |
| 属性 | 说明 |
|---|
| 哑剧 | 支持的内容 MIME 类型（如 "video/mp4"）（字符串数组） |
| 心形 | 视频广告最短持续时间（秒）（整数 |
| 最大持续时间 | 视频广告最长持续时间（秒）（整数 |
| 协议 | 支持的视频协议数组（整数） |
| 线性度 | 表示印象是否必须是线性、非线性等。如果未指定，则假定全部允许（整数） |
| 允许拳击 | 表示是否允许将 4:3 的内容以字母格式转换到 16:9 的窗口中，0 = 否，1 = 是（整数）。 |
| 姿势 | 广告在屏幕上的位置（整数） |
| h | 视频播放器的宽度，单位为独立于设备的像素 (DIPS)（整数） |
| w | 视频播放器的高度，单位为独立于设备的像素 (DIPS)（整数） |
| 绵延 | 用于对 OpenRTB 进行交易所特定扩展的占位符（对象） |
imp.video.ext
| 属性 | 说明 |
|---|
| 区域类型 | ExoClick 广告格式中的区域类型（例如：视频_滑块） |