结构化数据 - v8 - 订单项

如需了解格式,请参阅概览

字段必需类型可写入说明
订单项 ID仅当修改现有订单项时才必须指定这项设置整数相应订单项的数字 ID 值。如果留空,系统会创建一个新订单项并为其分配唯一 ID。(可选)创建新订单项时,您可以使用自定义标识符为新订单项分配 TrueView 广告组。自定义标识符的格式为“ext[自定义标识符]”,例如 ext123。待文件被上传并处理后,系统会将所有自定义标识符替换为由 DBM 分配的 ID,并会根据所用的自定义标识符将相关对象(例如广告组与订单项)关联起来。
Io ID整数相应广告订单的数字 ID 值。您可为要与此订单项同时创建的插单指定一个自定义标识符(例如,“ext[custom IO identifier]”)。
Io 名称字符串广告订单名称
类型字符串条目的类型。

仅在创建时可写入,编辑时不可写入。

选择以下值之一:
  • 显示
  • 视频
  • TrueView 广告
  • 音频
  • 需求开发
子类型字符串用于区分不同格式的订单项的必需字段。

请选择以下某个值:
  • 简单
  • 不可跳过
  • 操作
  • 覆盖面
  • 查看
  • 音频
  • Over The Top
  • 移动应用安装
  • 移动应用购买
  • Simple Over The Top
  • 不可跳过的 OTT 广告
  • Reach Over The Top
  • 目标频次
  • 需求开发


“行动”与 TrueView 订单项不兼容。
名称字符串条目的名称。
时间戳修改现有条目时必须指定整数相应条目的时间戳。
  • 对于非需求开发广告系列订单项,此时间戳是“上次修改”时间戳,系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。
  • 对于需求开发广告订单项,此时间戳是文件生成的时间,用于验证相应订单项是否是最近下载的,但不能保证相应订单项自首次下载以来未发生更新。
状态字符串相应条目的状态设置。
  • 有效
  • 已暂停
  • 草稿
  • 已归档
开始日期字符串相应条目的排期开始日期的时间戳,格式为 MM/DD/YYYY;也可以设置为“与广告订单相同”,以使用与父广告订单相同的开始日期。
结束日期字符串相应条目的排期结束日期的时间戳,格式为 MM/DD/YYYY;也可以设置为“与广告订单相同”,以使用与父广告订单相同的结束日期。
预算类型字符串指定预算是基于货币还是基于展示次数。如果相应广告订单已启用自动分配预算功能,您可以将此字段设置为“自动”,以允许 DBM 自动为相应条目分配预算。
  • 金额
  • 展示次数
  • 无限制
  • 自动
  • TrueView 预算
预算金额当“Type”为“Display”“Video”或“Audio”时,此列为必需列float相应预算类型的正预算金额。可以是简单的整数展示价值,也可以是表示货币金额的浮点数。币种将以广告客户的币种显示,单位为标准单位(而非货币单位的 1/1,000,000)。如果为条目设置了“自动”预算分配,您可以指定最低支出金额(例如,“至少支出”此金额)。
节奏字符串用于支出达到步调金额的时间段。TrueView 订单项和需求开发广告订单项只能为“每日”或“整个广告系列”
支出速率字符串相应广告资源的投放速率。

请选择以下某个值:
  • 尽快
  • 均匀
  • 提前
TrueView 订单项和需求开发订单项只能选择“尽快”或“均匀”
投放量当“类型”为“展示”“视频”或“音频”时,此字段为必填项。如果“类型”为“TrueView”或“需求开发广告系列”,且“投放节奏”为“每日”,则为必填项。float根据支出节奏类型设置的时间段内要支出的金额。
频次已启用当“子类型”不是“需求开发广告系列”时,必须设置此参数字符串启用/停用基于展示次数的订单项频次上限。

选择以下某个值:
  • TRUE
  • FALSE
频次曝光当“Frequency Enabled”(频次启用)为“TRUE”时,此字段为必填项整数一个正整数值,表示指定频次金额的展示次数,即“在 y 时间段内展示 x 次”中的 x。
频次周期当“Frequency Enabled”(频次启用)为“TRUE”时,此字段为必填项字符串指定频次上限的时间段单位。

选择以下某个值:
  • 分钟
  • 小时
  • 数天
  • 数周
  • 月份
对于 TrueView 订单项和需求开发广告系列订单项,支持的周期为天、周、月。
频次金额当“Frequency Enabled”(频次启用)为“TRUE”时,此字段为必填项整数频次周期的时长(正整数),即“在 y 周期内展示 x 次”中的 y。此金额不支持 TrueView 订单项或需求开发广告订单项。

频次上限的时间段不得超过 30 天。
TrueView 观看频次已启用当“Type”为“TrueView”时,此字段为必需字段字符串启用/停用 TrueView 订单项上基于观看次数的频次上限
  • TRUE
  • FALSE
TrueView 观看频次曝光次数当“TrueView 查看频次已启用”为“TRUE”时,必须设置此参数整数一个正整数,表示 TrueView 观看次数,即“在相应时间段内显示 x 次观看”中的 x
TrueView 观看频次周期当“TrueView 查看频次已启用”为“TRUE”时,必须设置此参数字符串指定 TrueView 观看频次上限的时间段单位
  • 数周
  • 月份
合作伙伴收入模式字符串合作伙伴收入模式是yon控制 Bid Manager 中收入计算方式的机制。使用合作伙伴收入模式可跟踪服务费的加价。如果包含“合作伙伴收入模式”列,则应指定“合作伙伴收入金额”列。
  • TMCM - 总媒体费用加价
  • MCM - 媒体费用加价
  • CPM - 每千次展示费用
合作伙伴收入金额仅在指定“合作伙伴收入模型”列时需要。float与合作伙伴收入模式对应的正浮点值。仅在指定“合作伙伴收入模式”列时适用。
转化统计类型当“Type”为“Display”“Video”“Audio”或“TrueView”时,此属性为必需属性字符串选择要统计的转化类型。
  • 统计所有内容
  • 统计点击后转化次数
  • 数量百分比
转化统计百分比当“Type”为“Display”“Video”“Audio”或“TrueView”时,此属性为必需属性float为“按百分比统计”转化统计类型指定百分比。将百分比格式化为浮点数(3.123% = 3.123),精度限制为千位(小数点后 3 位)。
转化 Floodlight 活动 ID字符串,列表的列表

用于转化的 Floodlight 活动和相关设置。

此列使用 Display & Video 360 API FloodlightActivity 资源 ID,并以分钟为单位显示观看后转化和点击后转化时间范围。

列表格式的列表 = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);)。

如果设置了“算法 ID”列,则无法更新此字段。如果尝试这样做,会导致错误

主要归因模型 ID整数用于关联订单项的归因模型 ID。
费用字符串,列表的列表相应条目的所有费用。列表格式 =(费用类别;费用金额;费用类型;已开具账单)。
  • 费用类别
    • 每千次展示费用
    • 媒体
  • 费用金额
    • 浮点数
    • 以浮点数表示的百分比
  • 费用类型
    • (字符串,请参阅费用表)
  • 已开具账单
    • 正确
    • 错误
    • 空白

示例:'(CPM; 2; Display & Video 360 Fee; False) ; (Media; 13; Default; True);'
下表提供了可接受的值:

费用类别费用类型账单结算选项
每千次展示费用/媒体默认不允许(留空)
每千次展示费用/媒体第三方广告服务器不允许(留空)
每千次展示费用/媒体DoubleVerify是否允许 (True/False)
每千次展示费用/媒体Adsafe不允许(留空)
每千次展示费用/媒体AdXpose 费用不允许(留空)
每千次展示费用/媒体Vizu不允许(留空)
每千次展示费用/媒体Aggregate Knowledge不允许(留空)
每千次展示费用/媒体Teracent不允许(留空)
每千次展示费用/媒体Evidon不允许(留空)
每千次展示费用/媒体代理机构交易公司费用不允许(留空)
每千次展示费用/媒体Adloox是否允许 (True/False)
每千次展示费用ShopLocal必需 (True)
每千次展示费用TrustMetrics不允许(留空)
每千次展示费用Integral Ad Science视频是否允许 (True/False)
每千次展示费用MOAT视频不允许(留空)
媒体Display & Video 360 费用必需 (True)
媒体媒体费用数据不允许(留空)
媒体Scibids 费用必需 (True)
集成代码字符串用于跟踪的可选代码。
详细信息字符串字符串格式的条目详细信息。
出价策略类型当“Type”为“Display”“Video”或“Audio”时,此列为必需列字符串 选择一种适用的出价策略:
  • 最大限度地降低:在用尽预算的同时,最大限度地降低 CPA/CPC
  • 最大限度地提高:在用尽预算的同时,最大限度地提高展示次数值或优质展示次数
  • 超越:达到或超越 X CPA/CPC 目标
  • 优化每千次可见展示费用:针对 X 的每千次可见展示费用出价进行优化
  • 固定:指定固定出价 X
出价策略值必需属性,除非“出价策略类型”为“最大限度地提高”,或者“类型”为“TrueView”float对于“Beat”“Optimize VCPM”“Fixed”策略类型,请为目标出价选择一个值。
请注意,对于“Minimize”或“Maximize”出价策略类型,不需要提供出价策略值
出价策略单元当“出价策略类型”为“超越”“最大限度地降低”或“最大限度地提高”时,必须提供此属性字符串对于“超越”“最小化”或“最大化”策略类型,请选择相应的单位:
  • 每次转化费用
  • 每次点击费用
  • 单位费用带来的自定义展示价值
  • CIVA
  • IVO_TEN
  • AV_VIEWED
出价策略“不超过”当“Type”为“Display”“Video”或“Audio”时,此列为必需列float设置“不得超出”的每千次展示费用值。如果为 0,则表示未启用“不超过”功能。仅当出价策略为“尽可能降低”“尽可能提高”或“力争胜出”时,此属性才可用。
为交易应用底价当“出价策略类型”为“尽可能降低”或“尽可能提高”时,此属性为必需属性字符串是否优先处理交易而非公开竞价广告资源
  • TRUE
  • FALSE
算法 ID当“出价策略单位”为自定义展示价值/费用时,此字段为必需字段。整数

当“出价策略单元”设置为“自定义每次展示价值/费用”时,必须使用此对应的算法 ID。

分配给此列的算法中使用的任何 Floodlight 活动都必须包含在“转化 Floodlight 活动 ID”列中。如果尝试在未正确更新“转化 Floodlight 活动 ID”列的情况下分配算法,则会导致错误。

广告素材分配字符串、列表

要分配给相应条目的广告素材 ID 列表。

此列使用 Display & Video 360 API Creative 资源 ID。

列表格式 = (Creative.creativeId; Creative.creativeId; 等等)。此列表按升序数字顺序生成。

在上传时,用户还可以添加 Campaign Manager 360 展示位置 ID。展示位置 ID 应以字母“CM”开头,例如“CM789”。

示例:(123;CM789;)。

地理位置定位 - 包含字符串、列表

要纳入定位范围的地理位置列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_GEO_REGION)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。


如果“类型”列设置为“需求开发广告系列”,则只有当订单项的地理位置和语言定位级别在界面中设置为订单项时,此列才可用。
地理位置定位 - 排除字符串、列表

定位条件中要排除的地理位置列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_GEO_REGION)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。


如果“类型”列设置为“需求开发广告系列”,则只有当订单项的地理位置和语言定位级别在界面中设置为订单项时,此列才可用。
地理位置区域性地理位置列表定位 - 包含字符串、列表要纳入的地理区域性地理位置列表 ID 的列表。列表格式 = (11; 22; 33;)。
地理位置区域性地理位置列表定位 - 排除字符串、列表要排除的地理区域性地理位置列表 ID 的列表。列表格式 = (11; 22; 33;)。
邻近区域定位字符串,列表的列表邻近定位条件列表,每个定位条件的格式为“(Latitude; Longitude; Radius; Unit; FullAddress;);”。纬度介于 -90 度到 90 度之间(含);经度介于 -180 度到 180 度之间(含);半径是介于 1 到 500 之间的距离(含),以单位表示;单位可以是“mi”或“km”;FullAddress 是可选的。例如:“(38.907192; -77.03687; 1.0; mi; Washington D.C., 美国特区); (40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; mi; ;);"。
如果“类型”列设置为“需求开发”,则只有当订单项在界面中将地理位置和语言定位级别设置为订单项时,此列才可用。
邻近区域位置列表定位字符串,列表的列表广告订单或非 TrueView 订单项的邻近位置列表定位条件,每项的格式为“(ProximityListId; Radius; Unit; )”。ProximityListId 是相应广告客户资源下的位置列表 ID。半径是介于 1 到 500(含)之间的距离,单位可以是“mi”(英里)或“km”(公里);每个实体最多只能定位到两个地理位置列表以及地理区域位置列表。例如:“(10041691678; 20.0; mi;); (10038858567; 20.5; km;);”。
语言定位 - 包含字符串、列表

要纳入定位的语言列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_LANGUAGE)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。


如果“类型”列设置为“需求开发广告系列”,则只有当订单项的地理位置和语言定位级别在界面中设置为订单项时,此列才可用。
语言定位 - 排除字符串、列表

要在定位中排除的语言列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_LANGUAGE)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。


如果“类型”列设置为“需求开发广告系列”,则只有当订单项的地理位置和语言定位级别在界面中设置为订单项时,此列才可用。
设备定位 - 包含字符串、列表

要纳入定位条件的设备列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 来表示以下定位类型:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

设备定位 - 排除字符串、列表

要在定位条件中排除的设备列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID 来表示以下定位类型:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

浏览器定位 - 包含字符串、列表

要纳入定位条件的浏览器列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_BROWSER)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

浏览器定位 - 排除字符串、列表

要在定位中排除的浏览器列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_BROWSER)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

数字内容标签 - 排除字符串、列表要排除的数字内容标签的列表。列表格式 = (G;PG; etc.)。
  • G
  • PG
  • T
  • MA
  • ?
品牌保障敏感度设置字符串选择敏感度设置,根据广告资源周围内容的主题屏蔽广告资源。
  • 不屏蔽
  • 使用 Campaign Manager 360 Verification
  • 使用自定义温度
品牌保障自定义设置当“品牌安全自定义设置”为“使用自定义”时,此字段为必需字段字符串、列表如果“品牌保障敏感度设置”为“使用自定义”,请指定标准内容分类器的列表。例如,(Sexual;Alcohol;Tobacco;etc.)。
  • 色情内容
  • 诋毁内容
  • 下载和分享
  • 武器
  • 赌博
  • 暴力内容
  • 挑逗性内容
  • 脏话
  • 酒精饮料
  • 毒品
  • 烟草
  • 政治
  • 宗教
  • 悲剧
  • 交通事故
  • 敏感的社会问题
  • 骇人听闻
第三方验证服务字符串第三方验证服务提供商。
  • Integral Ad Science
  • DoubleVerify
  • Adloox
第三方验证标签字符串、列表如果“第三方验证服务”不是“无”,请指定所选提供商支持的标签列表。
渠道定位 - 包含字符串、列表

要纳入定位的频道列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; 等)。

频道定位 - 排除字符串、列表

要在定位中排除的渠道列表。

此列使用 Display & Video 360 API Channel 资源 ID。

列表格式 = (Channel.channelId; Channel.channelId; 等)。

网站定位 - 包含字符串、列表

要纳入定位条件的网站列表。该列表是网址字符串。

列表格式 = (someurl.com; someurltwo.com; etc.)。此列表按升序字母顺序生成。

网站定位 - 排除字符串、列表

要在定位中排除的网站列表。该列表是网址字符串。

列表格式 = (someurl.com; someurltwo.com; etc.)。此列表按升序字母顺序生成。

应用定位 - 包含字符串、列表

要纳入定位范围的应用列表。该列表是应用平台和应用平台 ID 的串联字符串。

以下值用于定义应用平台:

  • APP(包括 Android Play 商店和 Apple App Store 平台)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
该 ID 由相关平台提供,例如 Android Play 商店中的软件包 ID(示例:com.google.android.gm)或 Apple App Store 中的应用 ID(示例:422689480)。

应用平台和 ID 的串联字符串以英文冒号分隔,例如:APP:com.google.android.gm

列表格式 = (APP:com.google.android.gm; APP:422689480; 等)。此列表按升序字母顺序生成。

应用定位 - 排除字符串、列表

要在定位条件中排除的应用的列表。该列表是应用平台和应用平台 ID 的串联字符串。

以下值用于定义应用平台:

  • APP(包括 Android Play 商店和 Apple App Store 平台)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
该 ID 由相关平台提供,例如 Android Play 商店中的软件包 ID(示例:com.google.android.gm)或 Apple App Store 中的应用 ID(示例:422689480)。

应用平台和 ID 的串联字符串以英文冒号分隔,例如:APP:com.google.android.gm

列表格式 = (APP:com.google.android.gm; APP:422689480; 等)。此列表按升序字母顺序生成。

应用集合定位 - 包含字符串、列表

要纳入定位范围的应用集合的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_APP_CATEGORY)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。

应用合集定位 - 排除字符串、列表

要在定位中排除的应用集合的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_APP_CATEGORY)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。

类别定位 - 包含字符串、列表

要纳入定位条件的类别列表。此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CATEGORY)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

类别定位 - 排除字符串、列表定位条件中要排除的类别列表。此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CATEGORY)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

内容类型定位 - 包含字符串、列表

要纳入定位范围的内容类型列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CONTENT_GENRE

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

内容类型定位 - 排除字符串、列表

要在定位中排除的内容类型列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CONTENT_GENRE

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

关键字定位 - 包含字符串、列表

要纳入定位范围的关键字字符串列表。

此列表按升序字母顺序生成。

关键字定位 - 排除字符串、列表

要在定位中排除的关键字字符串列表。

此列表按升序字母顺序生成。

关键字列表定位 - 排除字符串、列表

要在定位中排除的否定关键字列表的列表。

此列使用 Display & Video 360 API NegativeKeywordList 资源 ID。

列表格式 = (NegativeKeywordList.negativeKeywordListId; NegativeKeywordList.negativeKeywordListId; etc.)。此列表按升序数字顺序生成。

优化型定位字符串启用优化型定位。
  • TRUE
  • FALSE

优化型定位与部分出价策略不兼容。如果出现以下情况,此列必须为“FALSE”:
  • “出价策略类型”为“固定”
  • “出价策略类型”为“优化后的目标 CPM”
  • “出价策略类型”为“最高”,“出价策略单位”为“CIVA”“IVO_TEN”或“AV_VIEWED”
受众群体定位 - 纳入字符串,配对列表的列表

要纳入定位范围的受众群体名单的列表。

此列使用 Display & Video 360 API FirstPartyAndPartnerAudience 资源 ID。

对于第一方受众群体名单,每个受众群体都以 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和新近度设置的形式列出。一个对是 (1;1d;),其中 1d 是表示 1 天近期的样本近期度。新近度不适用于第三方受众群体,因此名单格式为 (3;);(4;);。如需对受众群体组使用“AND”和“OR”运算符,请参考以下示例:如需组合包含和不包含新近度的配对,请使用以下语法:'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着(具有 1 天近期度的名单 1 或具有 365 天近期度的名单 2)AND(未指定近期度的名单 3 或具有 5 分钟近期度的名单 4 或包含所有用户的名单 5)。

有效近因值包括:

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15 分钟
  • 30 分钟
  • 1 小时
  • 2 小时
  • 3h
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
受众群体定位 - 排除字符串,配对列表的列表

要在定位中排除的受众群体名单列表。

此列使用 Display & Video 360 API FirstPartyAndPartnerAudience 资源 ID。

每个受众群体都列为 FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 和新近度设置(如果受众群体名单是第一方受众群体名单)。一个对是 (1;1d;),其中 1d 是表示 1 天近期的样本近期度。不过,对于第三方受众群体,系统不会提供近况,因此名单格式为 (3;);(4;);。

列表格式 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)
示例:"(1;1d;);(2;);"。

有效近因值包括:

  • 全部
  • 1 分钟
  • 5 分钟
  • 10 分钟
  • 15 分钟
  • 30 分钟
  • 1 小时
  • 2 小时
  • 3h
  • 6 小时
  • 12 小时
  • 1 天
  • 2 天
  • 3 天
  • 5 天
  • 7 天
  • 10 天
  • 14 天
  • 15 天
  • 21 天
  • 28天
  • 30 天
  • 45 天
  • 60 天
  • 90 天
  • 120 天
  • 180 天
  • 270 天
  • 365 天
兴趣相似的受众群体和有购买意向的受众群体定位 - 包含字符串、列表

要纳入的兴趣相似和/或有购买意向的受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =(受众群体 ID;受众群体 ID;等等)。此列表按升序数字顺序生成。

兴趣相似的受众群体和有购买意向的受众群体定位 - 排除字符串、列表

要排除的兴趣相似和/或有购买意向的受众群体名单的列表。

受众群体名单 ID 可从 Display & Video 360 界面中检索。

列表格式 =(受众群体 ID;受众群体 ID;等等)。此列表按升序数字顺序生成。

组合受众群体定位字符串、列表

要定位的组合受众群体名单的列表。

此列使用 Display & Video 360 API CombinedAudience 资源 ID。

列表格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; 等等)。此列表按升序数字顺序生成。

自定义列表定位字符串、列表

要定位的自定义名单的列表。

此列使用 Display & Video 360 API CustomList 资源 ID。

列表格式 = (CustomList.customListId; CustomList.customListId; etc.)。此列表按升序数字顺序生成。

广告资源来源定位 - 授权卖方选项当“Type”为“Display”“Video”或“Audio”时,此列为必需列字符串设置定位到授权直销商、授权直销商和转销商,或授权卖方 + 未知。“授权直销”表示仅定位授权卖方。“授权直销商和转销商”是指定位到授权卖方和转销商。“授权的发布商和未参与此计划的发布商”表示将定位到授权的卖方、转销商和未知卖方。
  • 授权直销商
  • 授权直销商和转销商
  • 授权发布商及未参与此计划的发布商
广告资源来源定位 - 包含当“Type”为“Display”“Video”或“Audio”时,此列为必需列字符串、列表

要纳入定位范围的广告资源来源、广告交易平台和子广告交易平台的列表。

此列使用 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 和定位类型为 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

广告资源来源定位 - 排除字符串、列表

要在定位中排除的广告资源来源、广告交易平台和子广告交易平台的列表。

此列使用 Display & Video 360 API InventorySource 资源 ID、已发布的广告交易平台 ID 和定位类型为 TARGETING_TYPE_SUB_EXCHANGE 的 Display & Video 360 API TargetingOption 资源 ID。

列表格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

广告资源来源定位 - 定位新的广告交易平台字符串设置以定位新的广告交易平台。
  • 正确
  • 错误
私下交易组定位包含字符串、列表

要纳入定位条件的已分组交易 ID 的列表。您可以在“我的广告资源”的“分组交易”部分以及订单项、广告订单和广告系列中“广告资源来源”设置的“组”部分找到分组交易 ID。

列表格式 = (DealGroupId; DealGroupId; etc.)。此列表按升序数字顺序生成。

时段定位字符串、列表

ID 列表,其中每个时段 ID 的构造格式如下:
daypart_id = base_dayparting_id
+ days_since_monday * 10000
+ start * 100
+ end

base_dayparting_id = 300000
days_since_monday:0=周一,1=周二,...,6=周日
start:0..95 (00:00--23:45),一个介于 0 到 95 之间的整数,表示 15 分钟的时间段
end:1..96 (00:15--24:00),一个介于 0 到 95 之间的整数,表示 15 分钟的时间段
start < end
对于新实体,时间将以用户的时区设置(即,“本地”)。对于现有实体,时区不会发生变化。

此列表按升序数字顺序生成。

时段定位时区如果包含“时段定位”,则此字段为必填字段。字符串用于时段定位的时区。

选择以下值之一:
  • 局部
  • 广告客户
TrueView 订单项和需求开发广告订单项只能是“广告客户”。
环境定位字符串、列表要定位到的环境列表。选择一个或多个可接受的值。请注意,如果不选择“网站”,则无法选择“未进行优化的网站”。
  • Web
  • 网站未优化
  • 应用
已启用可见度 OMID 定位字符串启用后,系统只会定位到可通过 Open Measurement 标准衡量的展示次数。
  • TRUE
  • FALSE
可见度定位条件 - Active View字符串指定预计的可见度百分比作为目标。百分比以浮点数表示。{0.1、0.2、0.3、0.4、0.5、0.6、0.7、0.8、0.9} 之一
位置定位 - 屏幕上的位置字符串、列表屏幕上的广告位置定位。选择一个或多个可接受的值:
  • 首屏
  • 非首屏
  • 未知
位置定位 - 展示广告在内容中的位置字符串、列表要定位的展示广告内容位置。选择一个或多个可接受的值:
  • 文章内嵌广告
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知
位置定位 - 视频在内容中的位置字符串、列表要定位的视频广告内容位置。选择一个或多个可接受的值:
  • 文章内嵌广告
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知外播广告
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知插播广告
位置定位 - 音频广告在内容中的位置字符串、列表要定位的音频广告内容位置。选择一个或多个可接受的值:
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知
视频播放器尺寸定位字符串、列表要定位的视频广告播放器尺寸列表。选择一个或多个可接受的值:
  • 未知
  • large
  • 高清
内容时长定位字符串、列表要定位的内容时长的列表。单位值为分钟。选择一个或多个可接受的值:
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 未知
内容流类型定位字符串、列表要定位的内容流类型列表。选择一个或多个可接受的值:
  • 直播
  • 按需
音频内容类型定位字符串、列表要定位的音频内容类型列表。选择一个或多个可接受的值:
  • 未知
  • 在线电台
  • 在线播放音乐
  • 播客
受众特征定位:性别字符串、列表要定位到的性别列表。选择一个或多个可接受的值:
  • 男性
  • 未知
受众特征定位 - 年龄字符串、列表定位到某个年龄段的用户。通过选择单个“起始”年龄和单个“结束”年龄,并指定是否纳入“未知”年龄(true/false),来指定“起始”/“结束”范围。请参阅可接受的“起始年龄”/“结束年龄”列表。
示例 1:如需定位 18-55 岁的用户并包含未知年龄的用户,请指定格式 {From; To ; Include unknown True/False} = 18;55;true;
示例 2:如需仅定位 35 岁以上的用户并排除未知年龄的用户,请指定以下格式 = 35;+;false;。
“起始年龄”的可接受值:
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

“收件人”的可接受值:
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
受众特征定位:家庭收入字符串、列表定位到某个家庭收入范围。通过选择单个 Top_of_Range 收入范围和单个 Bottom_of_Range 收入范围,并指定是否包含收入未知的家庭(true/false),来指定起始/结束范围。请参阅可接受的 Top_of_Range/Bottom_of_Range 范围列表。
示例 1:若要定位家庭收入排在前 10% 到 50% 的家庭,并包含收入未知的家庭,请指定以下格式:{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;
示例 2:若要仅定位家庭收入排在后 50% 的家庭,并排除收入未知的家庭,请指定以下格式:{Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;
Top_of_Range/Bottom_of_Range 的可接受值:
  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%

受众特征定位 - 育儿状况字符串、列表要定位的育儿状况列表。选择一个或多个可接受的值。
  • 有子女
  • 无子女
  • 未知
连接速度定位字符串定位到特定连接速度。选择一个可接受的值:
  • 全部
  • 2G
  • 3G
  • DSL
  • 4G
运营商定位 - 包含字符串、列表

要定位的 ISP 或运营商的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CARRIER_AND_ISP)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

运营商定位 - 排除字符串、列表

要排除的 ISP 或运营商的列表。

此列使用 Display & Video 360 API TargetingOption 资源 ID(适用于定位类型 TARGETING_TYPE_CARRIER_AND_ISP)。

列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.)。此列表按升序数字顺序生成。

出价调节系数字符串,列表的列表

出价调节系数不再受新订单项支持。此列不再可写。

相应条目的所有出价倍数。列表格式 = (行类型;条件 ID;出价调节系数值); (行类型;条件 ID;出价调节系数值);。出价倍增系数的值介于 0.1 到 10.0 之间。下表列出了可接受的行类型及其对应的条件 ID:
行类型维度条件 ID
应用应用应用平台和应用平台 ID 的串联字符串。应用平台和 ID 的串联字符串以英文冒号分隔,例如:APP:com.google.android.gm。以下值用于定义应用平台:
  • APP(包括 Android Play 商店和 Apple App Store 平台)
  • ROKU_APP
  • AMAZON_FIRETV_APP
  • XBOX_APP
  • PLAYSTATION_APP
  • APPLE_TV_APP
  • SAMSUNG_TV_APP
  • ANDROID_TV_APP
  • GENERIC_CTV_APP
  • LG_TV_APP
  • VIZIO_TV_APP
应用平台和 ID 的串联字符串以英文冒号分隔。例如:(app;APP:com.google.android.gm;1.0);(app;APP:422689480;2.5);
网站网址网站网址的字符串。例如:(site;'someurl.com';1.0);(site;'someurltwo.com';2.5);
user_list受众群体名单用户名单 ID。例如:(user_list;UserList.id;1.0);(user_list;UserList.id;2.5);
user_interest受众群体名单用户兴趣 ID。例如:(user_interest;UserList.id;1.0);(user_interest;UserList.id;2.5);
custom_affinity受众群体名单自定义的兴趣相似受众群体 ID。例如:(custom_affinity;CustomAffinity.id;1.0);(custom_affinity;CustomAffinity.id;2.5);
day_part广告时段时段 ID 在“时段定位”列中定义。例如,314159 表示“周二,上午 10:15 - 下午 2:45”。(day_part;314159;1.0);(day_part;302312;2.5);
age_range受众特征年龄段,以“起始年龄-结束年龄”的形式分隔。可接受的值包括:
  • 18-24
  • 25-34
  • 35-44岁
  • 45-54岁
  • 55-64
  • 65+
  • 未知
例如,(age_range;55-64;1.0);(age_range;65+;2.5);
gender受众特征性别。可接受的值包括:
  • 男性
  • 未知
例如,(gender;Male;1.0);(gender;Female;2.5);
parental_status受众特征育儿状况。可接受的值包括:
  • 有子女
  • 无子女
  • 未知
例如,(parental_status;无子女;1.0);
household_income受众特征家庭收入百分位数范围。可接受的值包括:
  • 收入最高的前 10%
  • 11-20%
  • 21-30%
  • 31-40%
  • 41-50%
  • 收入较低的后 50%
  • 未知
例如,(household_income;Top 10%;1.0);(household_income;Unknown;2.5);
device_type设备类型设备类型。可接受的值包括:
  • 计算机
  • 智能手机
  • 平板电脑
  • 联网电视
  • 已连接的设备
例如,(device_type;Computer;1.0);(device_type;Tablet;2.5);
geo地理位置地理位置 ID。例如:(geo;2840;1.0);
private_deal私下交易私下交易定位 ID。例如:(private_deal;1016301;1.0);
private_deal私下交易私下交易定位 ID。例如:(private_deal;1016301;1.0);
public_exchange公开广告交易平台公开广告交易平台 ID。例如:(public_exchange;17;1.0);
unclassified_exchange未分类的交易所未分类的广告交易平台定位条件 ID(= 5000 + exchange_id)。例如,(unclassified_exchange;5017;1.0);
sub_exchange子广告交易平台格式为 [exchange_id]-[sub_exchange_targeting_id]。例如,(sub_exchange;38-4515403;1.0);
TrueView 视频广告格式对于 TrueView 订单项,请选择“是”字符串相应订单项的视频广告格式。

插播广告 / 信息流视频广告是按每次观看费用 (CPV) 出售的 TrueView 视频广告类型。插播广告 / 导视广告是按每千次展示费用 (CPM) 出售的 TrueView 视频广告类型。导视广告的时长不超过 6 秒,按每千次展示费用 (CPM) 出售。不可跳过的视频广告是时长介于 6-15 秒之间的插播广告,按每千次展示费用 (CPM) 出售。插播广告 / 导视广告 / 不可跳过式视频广告是可接受的 TrueView 视频广告类型,适用于按 CPM 出售的目标频次订单项。自适应视频广告是一种可采用多种格式投放的广告类型。
  • 插播广告
  • 插播视频广告 / 信息流视频广告
  • 插播广告 / 导视广告
  • 导视广告
  • 不可跳过
  • 插播广告 / 导视广告 / 不可跳过的广告
  • 自适应

新的“覆盖面”订单项必须使用“自适应”广告。
TrueView 出价策略类型对于 TrueView 订单项和需求开发订单项,这是必需内容字符串TrueView 或需求开发广告系列订单项使用的出价策略。

请选择以下值之一:
  • 人工 CPV:一种基于观看次数的人工出价策略,按每次观看付费。
  • 人工每千次展示费用:一种基于展示次数的人工出价策略,您需要按每千次展示付费。新 TrueView 订单项或需求开发广告订单项不支持此值。
  • 目标 CPM:一种自动出价策略,可优化出价,以帮助您利用目标金额(您愿意为广告获得的每千次展示支付的金额)获得尽可能多的展示次数。
  • “尽可能提高转化次数”:一种自动出价策略,可优化出价,帮助您争取尽可能多的转化。
  • “目标每次转化费用”:一种自动出价策略,可优化出价,在不超出您为每次转化愿意支付的目标金额的前提下,帮您获得尽可能多的转化。
  • 尽可能提高转化价值:一种基于价值的自动出价策略,可针对更高价值的转化进行优化。
  • “目标广告支出回报率”:一种基于价值的出价策略,可优化出价以争取更高的转化价值。
  • 尽可能争取更多点击次数:一种自动出价策略,可根据预算优化出价,以尽可能争取更多点击次数
TrueView 出价策略价值对于 TrueView 订单项和需求开发订单项,这是必需内容float对于“目标每次转化费用”或“目标广告支出回报率”出价策略类型,请选择目标出价的值。对于其他“TrueView 出价策略类型”值或其他订单项类型,此列在上传时应为 0。对于“目标广告支出回报率”,此列应为百分比(以小数形式表示),例如,如果您希望目标广告支出回报率为 150%,请在此列中输入 1.5。
TrueView 移动设备出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 移动设备出价调整百分比当“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”时,此列为必需列整数出价调整,用于提高在移动设备上展示广告的机会。对于出价调整选项“提高”,可接受的调整范围为 [0;900%];对于“降低”,可接受的调整范围为 [0;90%] 或 100%。
如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,或者对于需求开发广告组,可接受的调整范围为:对于出价调整选项“提高”,可接受的调整范围为 0;对于“降低”,可接受的调整范围为 100%。
TrueView 桌面设备出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 桌面设备出价调整百分比当“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”时,此列为必需列整数出价调整,用于提高在移动设备上展示广告的机会。可接受的调整范围为:对于出价调整选项“提高”,[0;900%];对于“降低”,[0;90%] 或 100%。
“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”;对于需求开发广告组,可接受的调整范围为:对于出价调整选项“提高”,0;对于“降低”,100%。
TrueView 平板电脑出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 平板电脑出价调整百分比当“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”时,此列为必需列整数出价调整,用于提高在移动设备上展示广告的机会。对于出价调整选项“提高”,可接受的调整范围为 [0;900%];对于“降低”,可接受的调整范围为 [0;90%] 或 100%。
如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,或者对于需求开发广告组,可接受的调整范围为:对于出价调整选项“提高”,可接受的调整范围为 0;对于“降低”,可接受的调整范围为 100%。
TrueView 联网电视出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 联网电视出价调整百分比当“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”时,此列为必需列整数出价调整,用于提高在移动设备上展示广告的机会。对于出价调整选项“提高”,可接受的调整范围为 [0;900%];对于“降低”,可接受的调整范围为 [0;90%] 或 100%。
如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,或者对于需求开发广告组,可接受的调整范围为:对于出价调整选项“提高”,可接受的调整范围为 0;对于“降低”,可接受的调整范围为 100%。
TrueView 类别排除对象定位字符串、列表要排除的类别列表。列表格式 = 嵌入式视频;家庭;等等。
  • 嵌入式视频
  • 直播
  • 游戏
  • 家庭
TrueView 内容过滤器字符串TrueView 或需求开发广告内容过滤条件。

选择以下值之一:
  • 受限
  • 标准
  • 已展开
TrueView 广告资源来源定位字符串、列表要纳入的 TrueView 广告资源来源的列表
  • YouTube
  • Google TV
  • 视频合作伙伴


需求开发订单项必须包含“视频广告合作伙伴”。
TrueView 第三方可见度验证服务供应商仅在更新现有“TrueView”或“需求开发广告”订单项时需要提供字符串,列表的列表衡量 TrueView 和需求开发广告订单项的可见度的第三方供应商。如果在创建 TrueView 订单项或需求开发广告系列订单项时将此字段留空,并且广告客户级启用了默认可见率衡量服务提供商,则系统会创建相应订单项并启用广告客户级默认服务提供商。

请选择以下值之一:
  • Moat
  • DoubleVerify
  • Integral Ad Science
TrueView 第三方可见度报告 ID当第三方可见度衡量服务提供商不是“无”时,为“是”。字符串第三方可视性供应商用于标识特定报告的事件的 ID。此列可以为空字符串,这样会将报告 ID 设置为空。
TrueView 第三方品牌保障服务供应商仅在更新现有 TrueView 或需求开发广告订单项时需要提供字符串,列表的列表衡量 TrueView 和需求开发广告系列订单项的品牌保障情况的第三方供应商。如果在创建 TrueView 订单项或需求开发广告系列订单项时将此字段留空,并且广告客户级启用了默认品牌保障供应商,则系统会创建相应订单项并启用广告客户级默认供应商。

请选择以下值之一:
  • DoubleVerify
  • Integral Ad Science
  • Zefr
TrueView 第三方品牌保障报告 ID如果第三方品牌保障服务供应商不是“无”,则为“是”。字符串第三方品牌保障供应商用于识别特定报告的事件的 ID。此列可以为空字符串,这样会将报告 ID 设置为空。
TrueView 第三方覆盖面衡量服务供应商仅在更新现有 TrueView 或需求开发广告订单项时需要提供字符串,列表的列表衡量 TrueView 广告系列和需求开发广告系列订单项覆盖面的第三方供应商。如果在创建 TrueView 订单项或需求开发广告系列订单项时将此字段留空,并且广告客户级启用了默认覆盖面供应商,则系统会创建该订单项并启用广告客户级默认供应商。

请选择以下值之一:
  • Nielsen
  • Comscore
  • Kantar
  • Gemius
  • Video Research
  • Media Scope
  • AudienceProject
  • iSpot TV
  • VideoAmp
TrueView 第三方覆盖面报告 ID如果第三方覆盖面衡量服务供应商不是“无”,则为“是”。字符串第三方覆盖面供应商用于标识特定报告的事件的 ID。此列可以为空字符串,这样会将报告 ID 设置为空。
TrueView 第三方品牌提升效果衡量服务供应商仅在更新现有“TrueView”或“需求开发广告”订单项时需要提供字符串,列表的列表衡量 TrueView 和需求开发广告系列订单项的品牌提升效果的第三方供应商。如果在创建 TrueView 订单项或需求开发广告系列订单项时将此字段留空,并且在广告客户一级启用了默认品牌提升效果衡量服务提供商,则系统会创建订单项并启用广告客户级默认服务提供商。

请选择以下值之一:
  • Kantar
  • Dynata
  • Intage
  • Nielsen
  • Macromill
TrueView 第三方品牌提升报告 ID如果第三方品牌提升效果衡量服务供应商不是“无”,则为“是”。字符串第三方品牌提升服务供应商用于识别特定报告的事件的 ID。此列可以为空字符串,这样会将报告 ID 设置为空。
TrueView 目标频次计数如果订单项子类型为“目标频次”,则为“是”整数为“目标频次”类型的 YouTube 订单项设置的目标频次。此字段只能根据时间窗口设置为不同的值集。对于非“目标频次”类型的 YouTube 订单项,此字段应为空。
TrueView 广告:目标频次时间窗口如果订单项子类型为“目标频次”,则为“是”字符串设有“目标频次”的 YouTube 订单项的目标频次时间窗口。目前,此字段可设置为“每周”或“每月”。对于非“目标频次”类型的 YouTube 订单项,此字段应为空。
  • 每周、每月
TrueView 视频广告资源控制系统如果订单项子类型为“覆盖面”,则为“是”字符串、列表覆盖面或观看订单项的视频广告资源控制设置。

选择一个或多个可接受的广告格式值:
  • 插播广告
  • 信息流广告
  • Shorts 广告