结构化数据 - v8 - 订单项

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

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

仅在创建时可写入,在修改时不可写入。

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

请选择以下值之一:
  • 简单
  • 不可跳过
  • 操作
  • 覆盖面
  • 查看
  • 音频
  • OTT 服务
  • 移动应用安装
  • 移动应用购买
  • 简单的 OTT
  • 不可跳过的 OTT 广告
  • 覆盖 OTT 用户
  • 目标频次
  • 需求开发
名称字符串条目的名称。
时间戳修改现有条目时必须填写integer条目的时间戳。
  • 对于非需求开发订单项,此字段是“上次修改时间”时间戳,系统会使用此时间戳来验证相应条目在下载和上传期间是否未发生更改。
  • 对于需求开发订单项,此字段是文件生成的时间戳,用于验证订单项是否最近下载的,但不能保证订单项自首次下载以来未更新。
状态字符串条目的状态设置。
  • 有效
  • 已暂停
  • 草稿
  • 已归档
开始日期字符串条目的投放开始日期的时间戳,格式为 MM/DD/YYYY,或“与广告订单相同”,以使用与父级广告订单相同的开始日期。
结束日期字符串条目的投放结束日期的时间戳,格式为 MM/DD/YYYY,或“与广告订单相同”,以使用与父级广告订单相同的结束日期。
预算类型字符串指定预算是基于金额还是基于展示次数。如果此条目的 IO 启用了自动分配预算功能,您可以将此值设为“自动”,以允许 DBM 为此条目自动分配预算。
  • 金额
  • 展示次数
  • 无限制
  • 自动
  • TrueView 预算
预算金额如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填float预算类型对应的正预算金额。这可以是简单的整数展示次数值,也可以是货币金额的浮点值。货币将以广告客户的币种以标准单位(而非货币单位的 1/1,000,000)显示。如果为条目设置了“自动”预算分配方式,您可以指定最低支出金额(例如,“至少支出”此金额)。
节奏字符串用于按节奏投放金额的时间段。TrueView 订单项和需求开发广告订单项只能设为“每日”或“投放系列”
节奏速率字符串此条目的节奏速率。

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

请选择以下值之一:
  • TRUE
  • FALSE
频次曝光如果“频次启用”为“TRUE”,则为必填项integer指定频次金额中的展示次数对应的正整数金额,即“在 y 时间段内展示 x 次”中的 x。
频次时段如果“频次启用”为“TRUE”,则为必填项字符串指定频次上限的时间段单位。

请选择以下值之一:
  • 分钟
  • 小时
  • 数天
  • 数周
  • 月份
  • 生命周期
对于 TrueView 广告订单项和需求开发广告订单项,支持的周期为“天”“周”“月”。
频次金额如果“频次启用”为“TRUE”,则为必填项integer频次周期类型的时长,即“在 y 时间段内展示 x 次”中的 y。TrueView 订单项或需求开发订单项不支持此值。
启用了 TrueView 观看频次如果“类型”为“TrueView”,则必填字符串为 TrueView 订单项启用/停用基于观看的频次上限
  • TRUE
  • FALSE
TrueView 观看频次曝光次数当“TrueView 观看频次启用”为“TRUE”时,此参数为必需参数integerTrueView 观看次数的正整数金额,即“在相应时间段内显示 x 次观看”中的 x
TrueView 观看频次周期当“TrueView 观看频次启用”为“TRUE”时,此参数为必需参数字符串指定 TrueView 基于观看的频次上限的时间段单位
  • 数周
  • 月份
合作伙伴收入模式字符串合作伙伴收入模式是yon控制 Bid Manager 中收入计算方式的机制。使用合作伙伴收入模式可跟踪服务费的加价。添加“合作伙伴收入模式”列时,应指定“合作伙伴收入金额”列。
  • TMCM - 总媒体费用加价
  • MCM - 媒体费用加价
  • CPM - 每千次展示费用
合作伙伴收入金额仅当指定“合作伙伴收入模型”列时才必需。float与合作伙伴收入模式对应的正浮点值。仅在指定“合作伙伴收入模式”列时适用。
转化统计类型如果“类型”为“展示广告”“视频广告”“音频广告”或“TrueView”,则此属性为必填字符串选择要统计的转化类型。
  • 全部统计
  • 统计点击后转化次数
  • 计数百分比
转化统计百分比如果“类型”为“展示广告”“视频广告”“音频广告”或“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;);)。

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

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

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

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

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

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

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

例如,(123;CM789;)。

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

要纳入定位条件的地理位置列表。

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

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

地理位置定位 - 排除字符串、列表

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

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

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

地理位置 - 区域性地理位置列表定位 - 包含字符串、列表要包含的地理区域性地理位置列表 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., DC, USA;); (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(包括这两个数值)之间的距离;单位可以是“英里”或“公里”;每个实体最多只能定位到两个地理位置列表,以及地理区域地理位置列表。例如:“(10041691678; 20.0; mi;); (10038858567; 20.5; km;);”。
语言定位 - 包含字符串、列表

要包含在定位条件中的语言列表。

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

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

语言定位 - 排除字符串、列表

要从定位条件中排除的语言列表。

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

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

设备定位 - 包含字符串、列表

要包含在定位条件中的设备的列表。

对于以下定位类型,此列会使用 Display & Video 360 API TargetingOption 资源 ID:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

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

对于以下定位类型,此列会使用 Display & Video 360 API TargetingOption 资源 ID:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

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

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

要包含在定位条件中的浏览器列表。

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

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

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

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

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

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

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

要纳入定位条件的渠道列表。

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

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

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

要从定位条件中排除的渠道列表。

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

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

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

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

列表格式 = (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; 等)。此列表会按字母顺序升序生成。

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

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

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

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

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

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

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

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

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

要包含在定位条件中的类别列表。对于定位类型 TARGETING_TYPE_CATEGORY,此列使用 Display & Video 360 API TargetingOption 资源 ID。

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

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

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

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

要包含在定位条件中的内容类型列表。

此列针对定位类型 TARGETING_TYPE_CONTENT_GENRE 使用 Display & Video 360 API TargetingOption 资源 ID

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

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

要从定位条件中排除的内容类型列表。

此列针对定位类型 TARGETING_TYPE_CONTENT_GENRE 使用 Display & Video 360 API TargetingOption 资源 ID

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

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

要包含在定位条件中的关键字字符串列表。

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

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

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

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

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

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

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

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

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

优化型定位与部分出价策略不兼容。如果满足以下条件,此列必须为“FALSE”:
  • “出价策略类型”为“优化后的每次观看费用”
  • “出价策略类型”为“最高”,且“出价策略单位”为“CIVA”“IVO_TEN”或“AV_VIEWED”
受众群体定位 - 包含字符串、对列表的列表

要包含在定位条件中的受众群体名单列表。

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

对于第一方受众群体名单,每个受众群体都列为一对 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置。一个对为 (1;1d;),其中 1d 是表示 1 天内的示例新近度。新近度不适用于第三方受众群体,因此列表格式为 (3;);(4;);。如需对受众群体组进行“AND”和“OR”运算,请按以下示例操作:如需组合包含和不包含新近度信息的对:'((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'。这意味着“(最近 1 天的名单 1 OR 最近 365 天的名单 2)AND(未指定最近互动时间的名单 3 OR 最近互动时间为 5 分钟的名单 4 OR 包含所有用户的名单 5)”。

有效的近用度值包括:

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

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

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

如果受众群体名单是第一方受众群体名单,则每个受众群体都列为一对 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置。一个对为 (1;1d;),其中 1d 是表示 1 天内的示例新近度。不过,对于第三方受众群体,系统不支持“回访频率”,因此列表格式为 (3;);(4;);。

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

有效的近用度值包括:

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

要包含的兴趣相似受众群体名单和/或有购买意向的受众群体名单。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

广告资源来源定位 - 授权卖方选项如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填字符串设置为定位到授权直销商、授权直销商和转销商,或授权卖方 + 未知来源。“授权直销商”表示仅定位到授权卖方。“授权直销商和转销商”是指定位到授权直销商和转销商。“已获授权的发布商和未参与此计划的发布商”表示将定位到已获授权的卖方、转销商和未知卖方。
  • 授权直销商
  • 授权直销商和转销商
  • 授权发布商及未参与此计划的发布商
广告资源来源定位 - 包含如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填字符串、列表

要包含在定位条件中的广告资源来源、广告交易平台和子广告交易平台的列表。

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

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

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

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

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

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

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

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

列表格式 = (DealGroupId; DealGroupId; 等)。此列表会按数字升序生成。

时段定位字符串、列表

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
对于新实体,时间将设置为用户的时区(即“Local”)。对于现有实体,时区不会更改。

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

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

请选择以下值之一:
  • 局部
  • 广告客户
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} 中的任一值
位置定位 - 屏幕上字符串、列表屏幕上广告位置定位。选择一个或多个可接受的值:
  • 首屏
  • 非首屏
  • 未知
位置定位 - 展示位置(内容中)字符串、列表要定位到的展示广告内容位置。选择一个或多个可接受的值:
  • 文章内
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知
位置定位 - 视频在内容中的位置字符串、列表要定位到的视频广告内容位置。选择一个或多个可接受的值:
  • 文章内
  • 信息流广告
  • 横幅内嵌广告
  • 插页式广告
  • 未知外播广告
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知的插播广告
位置定位 - 音频内容中的位置字符串、列表要定位到的音频广告内容位置。选择一个或多个可接受的值:
  • 前贴片广告
  • 中贴片广告
  • 后贴片广告
  • 未知
视频播放器尺寸定位字符串、列表要定位到的视频广告播放器尺寸列表。选择一个或多个可接受的值:
  • 未知
  • 高清
内容时长定位字符串、列表要定位的内容时长列表。单位值为分钟。选择一个或多个可接受的值:
  • 0-1
  • 1-5
  • 5-15
  • 15-30
  • 30-60
  • 60+
  • 未知
内容流类型定位字符串、列表要定位的内容流类型列表。选择一个或多个可接受的值:
  • 直播
  • 按需
音频内容类型定位字符串、列表要定位到的音频内容类型的列表。选择一个或多个可接受的值:
  • 未知
  • 在线电台
  • 在线音乐
  • 播客
受众特征定位 - 性别字符串、列表要定位到的性别的列表。选择一个或多个可接受的值:
  • 女性
  • 男性
  • 未知
受众特征定位 - 年龄字符串、列表定位到特定年龄段的用户。通过选择单个“从”年龄和单个“到”年龄,以及是否要包含“未知”年龄(true/false),指定“从/到”范围。请参阅可接受的年龄范围(从/到)。
示例 1:若要定位到 18-55 周岁的用户并包含未知年龄的用户,请使用以下格式:{从; 到; 包含未知年龄(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 或运营商的列表。

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

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

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

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

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

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

出价调节系数字符串、列表的列表此条目的所有出价调节系数。列表格式 = (row type;criteria ID;bid multiplier value); (row type;criteria ID;bid multiplier value);。出价乘数值的范围介于 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 订单项或需求开发订单项使用的出价策略。

请选择以下值之一:
  • 每次观看费用人工出价:按每次观看付费的人工基于观看的出价。
  • 人工每千次展示费用:按展示次数进行人工出价,按每千次展示付费。新的 TrueView 订单项或需求开发广告订单项不支持此值。
  • 目标每千次展示费用:这是一种自动出价策略,可优化出价,以帮助您利用您愿意为广告获得的每千次展示而支付的目标金额,尽可能获得更多展示次数。
  • 尽可能提高转化次数:一种自动出价策略,可优化出价,帮助您尽可能争取更多转化。
  • 目标每次转化费用:一种自动出价策略,可根据您愿意为每次转化支付的目标金额来优化出价,帮助您争取尽可能多的转化。
  • 尽可能提高转化价值:一种基于价值的自动出价策略,以提高转化价值为目标进行优化。
  • 目标广告支出回报率:一种基于价值的出价策略,旨在以提高转化价值为目标进行优化。
  • 尽可能争取更多点击次数:一种自动出价策略,可根据预算优化出价以尽可能争取更多点击次数
TrueView 出价策略价值对于 TrueView 订单项和需求开发订单项,这是必需内容float对于“目标每次转化费用”或“目标广告支出回报率”出价策略类型,请为目标出价选择一个值。对于其他“TrueView 出价策略类型”值或其他订单项类型,上传时此列应为 0。对于目标广告支出回报率,此列应为百分比形式的小数,例如,如果您希望目标广告支出回报率为 150%,请在此列中输入 1.5。
TrueView 移动设备出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 移动设备出价调整百分比如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,则必填integer出价调整,以提高在移动设备上展示广告的几率。接受的出价调整范围如下:出价调整选项“增加”:[0;900%];“减少”:[0;90%] 或 100%。
如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,或者是需求开发广告组,则接受的出价调整范围如下:出价调整选项“增加”:0;“减少”:100%。
TrueView 桌面设备出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 桌面设备出价调整百分比如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,则必填integer出价调整,以提高在移动设备上展示广告的几率。接受的出价调整范围为:出价调整选项“增加”:[0;900%];“减少”:[0;90%] 或 100%。
如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,或者对于需求开发广告组,接受的出价调整范围为:出价调整选项“增加”:0;“减少”:100%。
TrueView 平板电脑出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 平板电脑出价调整百分比如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,则必填integer出价调整,以提高在移动设备上展示广告的几率。接受的出价调整范围为:出价调整选项“增加”:[0;900%];“减少”:[0;90%] 或 100%。
当“TrueView 出价策略类型”为“目标 CPA”或“尽可能提高转化次数”,或者对于需求开发广告组时,接受的出价调整范围为:出价调整选项“增加”:0;“减少”:100%。
TrueView 联网电视出价调整选项字符串“增加”或“减少”
  • 增加
  • 减少
TrueView 联网电视出价调整百分比如果“TrueView 出价策略类型”为“目标每次转化费用”或“尽可能提高转化次数”,则必填integer出价调整,以提高在移动设备上展示广告的几率。接受的出价调整范围为:出价调整选项“增加”:[0;900%];“减少”:[0;90%] 或 100%。
当“TrueView 出价策略类型”为“目标 CPA”或“尽可能提高转化次数”,或者对于需求开发广告组时,接受的出价调整范围为:出价调整选项“增加”: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 目标频次统计如果订单项子类型为“目标频次”,则为“是”integer为“目标频次”类型的 YouTube 订单项设置的目标频次计数。此字段只能设置为值 2、3 或 4。对于类型不是“目标频次”的 YouTube 订单项,此字段应为空。
TrueView 广告系列目标频次时间范围如果订单项子类型为“目标频次”,则为“是”字符串目标频次类型 YouTube 订单项的目标频次时间范围。目前,此字段只能设置为“每周”。对于类型不是“目标频次”的 YouTube 订单项,此字段应为空。
  • 每周
TrueView 视频广告资源控制如果 TrueView 订单项子类型为“覆盖面”,且使用信息流广告和 Shorts 广告,则可以字符串、列表覆盖面或观看次数订单项的视频广告资源控制设置。

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