View a markdown version of this page

ORTB 字段参考 - AWS Elemental MediaTailor
字段类别应用程序对象设备对象imp（印象）对象Top-level 字段用户对象regs 对象后续步骤

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

ORTB 字段参考

本页是OpenRTB出价请求中每个字段的完整参考。根据字段的 MediaTailor 处理方式以及 APS 是否需要或推荐它们以实现最佳广告填充来对字段进行分类。

有关完整的 OpenRTB 2.6 规范，请参阅 IAB OpenRTB 2.6 规范。

字段类别

类别 含义 你的行动
强制性的 必须存在于您的模板中。 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美国受众，更受欢迎，因此填充率更高。请参阅最佳实践。
regs.gpp_sid APS 推荐 GPP 分区 ID（[7]例如，美国国民）。存在时gpp为必填项。
regs.ext 可选 扩展对象。

后续步骤