本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# ORTB 字段参考
本页是OpenRTB出价请求中每个字段的完整参考。根据字段的 MediaTailor 处理方式以及 APS 是否需要或推荐它们以实现最佳广告填充来对字段进行分类。
有关完整的 OpenRTB 2.6 规范，请参阅 [ IAB OpenRTB 2.6 规范。](https://github.com/InteractiveAdvertisingBureau/openrtb2.x/blob/main/2.6.md)
## 字段类别
| 类别 | 含义 | 你的行动 |
| --- | --- | --- |
| 强制性的 | 必须存在于您的模板中。 MediaTailor 如果丢失则会引发错误。 | 你必须提供这些。 |
| 由 EMT 进行硬编码 | MediaTailor 始终使用控制台配置或当前可用上下文中的值来设置这些值。您的模板值被覆盖。 | 请勿在模板中设置这些。 |
| APS 推荐 | 并非严格要求 MediaTailor，但是 APS 建议使用这些来改善广告填充和定位。缺少推荐字段可能会导致填充率降低或不出价回复。 | 强烈推荐。 |
| 可选 | 仅当您提供时，才会将其包含在出价请求中。无默认值。 | 提供与您的用例相关的信息。 |
## `应用程序`对象
| 字段 | 类别 | 注意 |
| --- | --- | --- |
| app | 强制性的 | 该app对象必须存在于您的模板中。 |
| app.bundle | 强制性的 | 您的应用程序的捆绑包 ID（例如，G15147002586）。不能为空。 |
| app.storeurl | 强制性的 | 应用商店网址（例如，https://apps.apple.com/us/app/yourapp/id123）。 |
| app.publisher.id | 由 EMT 进行硬编码 | 请务必在控制台配置PublisherId中设置为您的配置。 |
| app.content | 必填项（对象） | MediaTailor 如果您省略此项，则会发送一个空Content对象。提供内容元数据以更好地定位。 |
| app.name | APS 推荐 | 用于识别的应用程序名称。 |
| app.id | APS 推荐 | 您在 APS 中的应用程序标识符。 |
| app.domain | APS 推荐 | 应用程序域。 |
| app.content.genre | APS 推荐 | 内容类型（例如，"Sport"，"News"）。 |
| app.content.contentrating | APS 推荐 | 内容分级（例如，"TV-G"，"TV-14"）。 |
| app.content.language | APS 推荐 | 内容语言 (ISO-639-1)。 |
| app.content.id | APS 推荐 | 内容标识符。 |
| app.content.title | APS 推荐 | 内容标题。 |
| app.content.episode | APS 推荐 | 剧集编号。 |
| app.content.len | APS 推荐 | 内容长度（以秒为单位）。 |
| app.cat | 可选 | 内容类别（IAB 分类法）。 |
| app.sectioncat | 可选 | 章节类别。 |
| app.pagecat | 可选 | 页面类别。 |
| app.ver | 可选 | 应用程序版本。 |
| app.privacypolicy | 可选 | 1 = 有隐私政策。 |
| app.paid | 可选 | 1 = 付费应用程序。 |
| app.keywords | 可选 | Comma-separated 关键词。 |
| app.kwarray | 可选 | 关键字作为数组。 |
| app.inventorypartnerdomain | 可选 | 库存合作伙伴域。 |
| app.ext | 可选 | 扩展对象（直通）。 |
## `设备`对象
| 字段 | 类别 | 注意 |
| --- | --- | --- |
| device | 强制性的 | 该device对象必须存在于您的模板中。 |
| device.ua | 强制性的 | 用户代理字符串。不能为空。使用 {{session.user\_agent}}。 |
| device.ip | 强制性的 | IPv4 地址。不能为空。使用 {{session.client\_ip}}。 |
| device.lmt | 可选（默认值：0） | 限制广告跟踪标志。0= 允许追踪，1= 追踪受限。如果您的模板中未提供，则默认为0。 |
| device.devicetype | 由 EMT 进行硬编码（默认值：3） | MediaTailor 套装3（联网电视）（如果未提供）。如果存在则使用您的值。 |
| device.make | APS 推荐 | 设备制造商（例如，"Samsung"，"Apple"）。 |
| device.model | APS 推荐 | 设备型号（例如，"Tizen TV"，"iPhone"）。 |
| device.os | APS 推荐 | 操作系统（例如，"Tizen"，"iOS"）。 |
| device.osv | APS 推荐 | 操作系统版本。 |
| device.h | APS 推荐 | 屏幕高度（以像素为单位）。 |
| device.w | APS 推荐 | 以像素为单位的屏幕宽度。 |
| device.language | APS 推荐 | 设备语言 (ISO-639-1)。 |
| device.ifa | APS 推荐 | 设备广告 ID。并非所有设备都有一个（例如，网络浏览器）。 |
| device.dnt | APS 推荐 | 请勿追踪标志。 |
| device.geo | 可选 | 带有country、lat、的地理对象lon。 |
| device.sua | 可选 | 结构化用户代理 (UA-CH)。 |
| device.ipv6 | 可选 | IPv6 地址。 |
| device.hwv | 可选 | 硬件版本。 |
| device.connectiontype | 可选 | 连接类型（WiFi、蜂窝网络等）。 |
| device.carrier | 可选 | 承运人名称。 |
| device.mccmnc | 可选 | 手机 country/network 代码。 |
| device.ext | 可选 | 扩展对象（直通）。 |
## `imp`（印象）对象
您的模板必须在数组中**`imp`仅包含**一个对象。
| 字段 | 类别 | 注意 |
| --- | --- | --- |
| imp[0].video | 强制性 | 该video对象必须存在。 |
| imp[0].video.mimes | 强制性 | 支持的 MIME 类型（例如["video/mp4"]）。 |
| imp[0].video.protocols | 可选 | 支持的 VAST 协议。如果省略，则 MediaTailor 使用硬编码的备[1, 2, 3, 4, 5, 6, 7, 8]用方法。请参阅下面的协议枚举参考。 |
| imp[0].video.minduration | 由 EMT 进行硬编码 | MinimumUnfilledDuration从控制台设置为你的。 |
| imp[0].video.maxduration | 由 EMT 进行硬编码 | 设置为实际未填充持续时间（秒）。 |
| imp[0].video.maxseq | 由 EMT 进行硬编码 | 已计算：floor(unfilled\_duration / 6)。APS 建议maxseq使用或poddur返回多个广告。 |
| imp[0].video.poddur | 由 EMT 进行硬编码 | 设置为未填充持续时间（秒）。 |
| imp[0].video.startdelay | 可选 | 启动延迟。0= 前卷，-1= 通用中卷，= 后卷，-2= 以秒为单位的中卷> 0偏移量。-1用于直播中场休息。硬编码后备:. 6 |
| imp[0].video.w | APS 推荐 | 以像素为单位的视频宽度。 |
| imp[0].video.h | APS 推荐 | 视频高度（以像素为单位）。 |
| imp[0].video.plcmt | APS 推荐 | 放置类型（1 = 直播中）。 |
| imp[0].video.podid | APS 推荐 | Pod 标识符。 |
| imp[0].video.slotinpod | APS 推荐 | 吊舱中的插槽位置。 |
| imp[0].video.ext.slotId | 可选（默认："default\_slot\_id"） | 来自 APS 控制台的 APS 插槽 ID。默认设置有效，但提供您的实际广告位ID允许APS应用特定广告位的定位和底价定价。 |
| imp[0].bidfloor | 可选（默认值：1.0） | 以 CPM 为单位的最低出价。 |
| imp[0].secure | 可选（默认值：1） | 1 = 需要 HTTPS 创意网址。 |
| imp[0].id | 可选 | 印象 ID。 Auto-generated 如果未提供。 |
| imp[0].tagid | 可选 | Tag/placement 身份证。 |
| imp[0].bidfloorcur | 可选 | 下限出价货币（默认为美元）。 |
| imp[0].ssai | 可选 | SSAI 指标。 |
| imp[0].exp | 可选 | 印象的到期时间。 |
| imp[0].rqddurs | 可选 | 请求的持续时间数组。 |
| imp[0].mincpmpersec | 可选 | 每秒最低 CPM。 |
| imp[0].pmp | 可选 | 私有市场对象。 |
| imp[0].ext | 可选 | 扩展对象（直通）。 |
### 协议枚举参考
| 值 | 协议 |
| --- | --- |
| 1 | VAST 1.0 |
| 2 | VAST 2.0 |
| 3 | VAST 3.0 |
| 4 | VAST 1.0 包装器 |
| 5 | VAST 2.0 包装器 |
| 6 | VAST 3.0 包装器 |
| 7 | 巨大的 4.0 |
| 8 | VAST 4.0 包装器 |
| 9\+ | DAAST |
## Top-level 字段
| 字段 | 类别 | 注意 |
| --- | --- | --- |
| id | 由 EMT 进行硬编码 | Auto-generated: {sessionId}\_{availId} 格式（例如，abc123-def456\_78901）。可用于将出价请求与会话日志关联起来。 |
| cur | 可选（默认：["USD"]） | 允许的货币。 |
| ext.integrationType | 由 EMT 进行硬编码 | 始终设置为"EMT"。 |
| bcat | 可选 | 屏蔽的广告类别（IAB 分类法）。您的模板值将按原样发送给 APS。 |
| badv | 可选 | 封锁的广告商域名。 |
| bapp | 可选 | 已屏蔽的应用程序包 ID。 |
| test | 可选 | 测试模式标志。 |
| at | 可选 | 拍卖类型。 |
| tmax | 可选 | 等待出价响应的最大时间（毫秒）。 |
| wseat | 可选 | 允许买家座位。 |
| bseat | 可选 | 买家座位被封锁。 |
| wlang | 可选 | 允许使用创意语言。 |
| source | 可选 | 供应链的源对象。 |
| ext | 可选 | 您的自定义扩展字段已与 EMT 合并。integrationType |
## `用户`对象
| 字段 | 类别 | 注意 |
| --- | --- | --- |
| user | APS 推荐（欧盟） | 获得 GDPR 同意的欧盟流量是必需的。 |
| user.consent | APS 推荐（欧盟） | GDPR 同意字符串 (TCF)。 |
| user.id | 可选 | 用户 ID。 |
| user.buyeruid | 可选 | Buyer-specific 用户 ID。 |
| user.eids | 可选 | 扩展标识符（LiveRamp、UID2 等）。 |
| user.data | 可选 | 用户数据段。 |
| user.ext | 可选 | 扩展对象。 |
## `regs 对象`
| 字段 | 类别 | 注意 |
| --- | --- | --- |
| regs | APS 推荐 | 包括在内，以符合法规。 |
| regs.coppa | APS 推荐（美国） | COPPA 旗帜（1 = 面向儿童）。 |
| regs.us\_privacy | APS 推荐（美国） | 美国隐私/CCPA 字符串。 |
| regs.gdpr | APS 推荐（欧盟） | GDPR 适用（1 = 是）。 |
| regs.gpp | APS 推荐 | 全球隐私平台字符串。相比于us\_privacy美国受众，更受欢迎，因此填充率更高。请参阅[最佳实践](yield-optimization-best-practices.md)。 |
| regs.gpp\_sid | APS 推荐 | GPP 分区 ID（[7]例如，美国国民）。存在时gpp为必填项。 |
| regs.ext | 可选 | 扩展对象。 |
## 后续步骤
+ 有关复制粘贴模板，请参阅。[示例 模板](yield-optimization-examples.md)
+ 有关最大化填充率的建议，请参阅[最佳实践](yield-optimization-best-practices.md)。