如需了解格式说明,请参阅概览。
字段 | 必填 | 类型 | 可写入 | 说明 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
订单项 ID | 仅当修改现有订单项时才必须指定此字段 | integer | 否 | 订单项的数字 ID 值。如果留空,系统会创建一个新订单项并为其分配唯一 ID。(可选)创建新订单项时,您可以使用自定义标识符为新订单项分配 TrueView 广告组。自定义标识符的格式为“ext[自定义标识符]”,例如 ext123。待文件被上传并处理后,系统会将所有自定义标识符替换为由 DBM 分配的 ID,并会根据自定义标识符将相关对象(例如广告组与订单项)关联起来。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io ID | 是 | integer | 否 | 广告订单的数字 ID 值。您可为要与此订单项同时创建的广告订单指定自定义标识符(例如“ext[custom IO identifier]”)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io 名称 | 否 | 字符串 | 否 | 广告订单名称 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
类型 | 是 | 字符串 | 是 | 条目的类型。 仅在创建时可写入,在修改时不可写入。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
子类型 | 是 | 字符串 | 是 | 订单项区分不同格式的必需字段。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
名称 | 是 | 字符串 | 是 | 条目的名称。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
时间戳 | 修改现有条目时必须填写 | integer | 否 | 条目的时间戳。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
状态 | 是 | 字符串 | 是 | 条目的状态设置。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
开始日期 | 是 | 字符串 | 是 | 条目的投放开始日期的时间戳,格式为 MM/DD/YYYY,或“与广告订单相同”,以使用与父级广告订单相同的开始日期。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
结束日期 | 是 | 字符串 | 是 | 条目的投放结束日期的时间戳,格式为 MM/DD/YYYY,或“与广告订单相同”,以使用与父级广告订单相同的结束日期。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
预算类型 | 是 | 字符串 | 是 | 指定预算是基于金额还是基于展示次数。如果此条目的 IO 启用了自动分配预算功能,您可以将此值设为“自动”,以允许 DBM 为此条目自动分配预算。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
预算金额 | 如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填 | float | 是 | 预算类型对应的正预算金额。这可以是简单的整数展示次数值,也可以是货币金额的浮点值。货币将以广告客户的币种以标准单位(而非货币单位的 1/1,000,000)显示。如果为条目设置了“自动”预算分配方式,您可以指定最低支出金额(例如,“至少支出”此金额)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
节奏 | 是 | 字符串 | 是 | 用于按节奏投放金额的时间段。TrueView 订单项和需求开发广告订单项只能设为“每日”或“投放系列” | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
节奏速率 | 是 | 字符串 | 是 | 此条目的节奏速率。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
投放量 | 如果“类型”为“展示广告”“视频广告”或“音频广告”,则此字段为必填项。如果“类型”为“TrueView”或“需求开发”,且“节奏”为“每日”,则为必填项。 | float | 是 | 按节奏类型设置的时间段内要支出的金额。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次已启用 | 如果“子类型”不是“需求开发”,则为必填项 | 字符串 | 是 | 为订单项启用/停用基于展示次数的频次上限。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次曝光 | 如果“频次启用”为“TRUE”,则为必填项 | integer | 是 | 指定频次金额中的展示次数对应的正整数金额,即“在 y 时间段内展示 x 次”中的 x。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次时段 | 如果“频次启用”为“TRUE”,则为必填项 | 字符串 | 是 | 指定频次上限的时间段单位。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
频次金额 | 如果“频次启用”为“TRUE”,则为必填项 | integer | 是 | 频次周期类型的时长,即“在 y 时间段内展示 x 次”中的 y。TrueView 订单项或需求开发订单项不支持此值。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
启用了 TrueView 观看频次 | 如果“类型”为“TrueView”,则必填 | 字符串 | 是 | 为 TrueView 订单项启用/停用基于观看的频次上限
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 观看频次曝光次数 | 当“TrueView 观看频次启用”为“TRUE”时,此参数为必需参数 | integer | 是 | TrueView 观看次数的正整数金额,即“在相应时间段内显示 x 次观看”中的 x | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 观看频次周期 | 当“TrueView 观看频次启用”为“TRUE”时,此参数为必需参数 | 字符串 | 是 | 指定 TrueView 基于观看的频次上限的时间段单位
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
合作伙伴收入模式 | 否 | 字符串 | 是 | 合作伙伴收入模式是yon控制 Bid Manager 中收入计算方式的机制。使用合作伙伴收入模式可跟踪服务费的加价。添加“合作伙伴收入模式”列时,应指定“合作伙伴收入金额”列。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
合作伙伴收入金额 | 仅当指定“合作伙伴收入模型”列时才必需。 | float | 是 | 与合作伙伴收入模式对应的正浮点值。仅在指定“合作伙伴收入模式”列时适用。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
转化统计类型 | 如果“类型”为“展示广告”“视频广告”“音频广告”或“TrueView”,则此属性为必填 | 字符串 | 是 | 选择要统计的转化类型。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
转化统计百分比 | 如果“类型”为“展示广告”“视频广告”“音频广告”或“TrueView”,则此属性为必填项 | float | 是 | 为“按百分比统计转化次数”转化统计类型指定百分比。将百分比格式化为浮点数(3.123% = 3.123),精度限制为千位数(小数点后 3 位)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
转化 Floodlight 活动 ID | 否 | 字符串、列表的列表 | 是 | 用于转化和相关设置的 Floodlight 活动。 此列使用 Display & Video 360 API 列表的列表格式 = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
主要归因模型 ID | 否 | integer | 是 | 用于关联订单项的归因模型 ID。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
费用 | 否 | 字符串、列表的列表 | 是 | 此条目的所有费用。列表格式 =(费用类别;费用金额;费用类型;已开具账单;)。
示例:“(CPM; 2; Display & Video 360 Fee; False) ; (Media; 13; Default; True)”
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
集成代码 | 否 | 字符串 | 是 | 一个可选代码,用于跟踪目的。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
详细信息 | 否 | 字符串 | 是 | 条目详情(字符串格式)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略类型 | 如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填 | 字符串 | 是 | 选择以下任一适用的出价策略:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略值 | 除非“出价策略类型”为“最大限度地降低”“最大限度地提高”或“类型”为“TrueView”,否则必须填写 | float | 是 | 对于“超出目标值”“优化每千次展示费用”和“固定”出价策略类型,请为目标出价选择一个值。 请注意,对于出价策略类型“最小化”或“最大化”,无需设置出价策略值 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略单位 | 如果“出价策略类型”为“超越”“最大限度地降低”或“最大限度地提高”,则必须提供 | 字符串 | 是 | 对于“胜出竞争”“最小化”或“最大化”策略类型,请选择相应的单位:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价策略 - 不超出 | 如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填 | float | 是 | 设置“请勿超出”每千次展示定价值。如果为 0,则表示未启用“不超过”。只有当出价策略为“最小化”“最大化”或“优胜”时,此功能才可用。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
为交易应用底价 | 如果“出价策略类型”为“最小化”或“最大化”,则必填 | 字符串 | 是 | 是否优先处理交易而非公开竞价广告资源
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
算法 ID | 使用“出价策略单位”自定义展示次数价值/费用时,此字段为必填。 | integer | 是 | 将出价策略单位设置为自定义展示次数价值/费用时,必须使用此对应的算法 ID。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告素材分配 | 否 | 字符串、列表 | 是 | 要分配给条目的广告素材 ID 的列表。 此列使用 Display & Video 360 API 列表格式 = (Creative.creativeId; Creative.creativeId; 等)。此列表会按数字升序生成。 在上传时,用户还可以添加 Campaign Manager 360 展示位置 ID。展示位置 ID 应带有字母“CM”,例如“CM789”。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
地理位置定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的地理位置列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
地理位置定位 - 排除 | 否 | 字符串、列表 | 是 | 定位中要排除的地理位置列表。 对于定位类型 列表格式 = (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;);”。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
语言定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的语言列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
语言定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位条件中排除的语言列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
设备定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的设备的列表。 对于以下定位类型,此列会使用 Display & Video 360 API
列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
设备定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位条件中排除的设备的列表。 对于以下定位类型,此列会使用 Display & Video 360 API
列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
浏览器定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的浏览器列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
浏览器定位 - 排除 | 否 | 字符串、列表 | 是 | 定位中要排除的浏览器列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
数字内容标签 - 排除 | 否 | 字符串、列表 | 是 | 要排除的数字内容标签的列表。列表格式 = (G;PG; etc.)。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌保障敏感度设置 | 否 | 字符串 | 是 | 选择敏感度设置,以根据广告资源周围内容的主题来屏蔽某些广告资源。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
品牌保障自定义设置 | 如果“品牌保障自定义设置”为“使用自定义设置”,则必填 | 字符串、列表 | 是 | 如果品牌保障敏感性设置为“使用自定义”,请指定标准内容分类器列表。例如,(性;酒精;烟草;等)。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方验证服务 | 否 | 字符串 | 是 | 第三方验证服务提供商。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
第三方验证标签 | 否 | 字符串、列表 | 是 | 如果“第三方验证服务”不是“无”,请指定所选提供商支持的标签列表。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
渠道定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的渠道列表。 此列使用 Display & Video 360 API 列表格式 = (Channel.channelId; Channel.channelId; etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
渠道定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位条件中排除的渠道列表。 此列使用 Display & Video 360 API 列表格式 = (Channel.channelId; Channel.channelId; etc.)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
网站定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的网站列表。该列表是网址字符串。 列表格式 = (someurl.com; someurltwo.com; etc.)。此列表会按字母顺序升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
网站定位 - 排除 | 否 | 字符串、列表 | 是 | 定位中要排除的网站的列表。该列表是网址字符串。 列表格式 = (someurl.com; someurltwo.com; etc.)。此列表会按字母顺序升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
应用定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位条件的应用的列表。该列表是应用平台和应用平台 ID 的串联字符串。 以下值用于定义应用平台:
应用平台和 ID 的串联字符串以英文冒号分隔,例如: 列表格式 = (APP:com.google.android.gm; APP:422689480; 等)。此列表会按字母顺序升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
应用定位 - 排除 | 否 | 字符串、列表 | 是 | 定位中要排除的应用列表。该列表是应用平台和应用平台 ID 的串联字符串。 以下值用于定义应用平台:
应用平台和 ID 的串联字符串以英文冒号分隔,例如: 列表格式 = (APP:com.google.android.gm; APP:422689480; 等)。此列表会按字母顺序升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
应用合集定位 - 包含 | 否 | 字符串、列表 | 是 | 要纳入定位范围的应用集合列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
应用合集定位 - 排除 | 否 | 字符串、列表 | 是 | 在定位中要排除的应用集合列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
类别定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的类别列表。对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
类别定位 - 排除 | 否 | 字符串、列表 | 是 | 定位条件中要排除的类别列表。此列针对定位类型 TARGETING_TYPE_CATEGORY 使用 Display & Video 360 API TargetingOption 资源 ID。列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
内容类型定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的内容类型列表。 此列针对定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
内容类型定位 - 排除 | 否 | 字符串、列表 | 是 | 要从定位条件中排除的内容类型列表。 此列针对定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
关键字定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的关键字字符串列表。 此列表会按字母顺序升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
关键字定位 - 排除 | 否 | 字符串、列表 | 是 | 定位中要排除的关键字字符串列表。 此列表会按字母顺序升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
关键字列表定位 - 排除 | 否 | 字符串、列表 | 是 | 要在定位中排除的否定关键字列表的列表。 此列使用 Display & Video 360 API 列表格式 = (NegativeKeywordList.negativeKeywordListId; NegativeKeywordList.negativeKeywordListId; etc.)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
优化型定位 | 否 | 字符串 | 是 | 启用优化型定位。
优化型定位与部分出价策略不兼容。如果满足以下条件,此列必须为“FALSE”:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众群体定位 - 包含 | 否 | 字符串、对列表的列表 | 是 | 要包含在定位条件中的受众群体名单列表。 此列使用 Display & Video 360 API 对于第一方受众群体名单,每个受众群体都列为一对 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)”。 有效的近用度值包括:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众群体定位 - 排除 | 否 | 字符串、对列表的列表 | 是 | 定位时要排除的受众群体名单列表。 此列使用 Display & Video 360 API 如果受众群体名单是第一方受众群体名单,则每个受众群体都列为一对 FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 和新近度设置。一个对为 (1;1d;),其中 1d 是表示 1 天内的示例新近度。不过,对于第三方受众群体,系统不支持“回访频率”,因此列表格式为 (3;);(4;);。 列表格式 = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;);) 有效的近用度值包括:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
兴趣相似和有购买意向的受众群体定位 - 包含 | 否 | 字符串、列表 | 是 | 要包含的兴趣相似受众群体名单和/或有购买意向的受众群体名单。 您可以从 Display & Video 360 界面检索受众群体名单 ID。 列表格式 =(受众群体 ID;受众群体 ID;等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
兴趣相似和有购买意向的受众群体定位 - 排除 | 否 | 字符串、列表 | 是 | 要排除的兴趣相似受众群体名单和/或有购买意向的受众群体名单。 您可以从 Display & Video 360 界面检索受众群体名单 ID。 列表格式 =(受众群体 ID;受众群体 ID;等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
组合受众群体定位 | 否 | 字符串、列表 | 是 | 要定位到的组合受众群体名单列表。 此列使用 Display & Video 360 API 列表格式 = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
自定义列表定位 | 否 | 字符串、列表 | 是 | 要定位到的自定义名单列表。 此列使用 Display & Video 360 API 列表格式 = (CustomList.customListId; CustomList.customListId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 授权卖方选项 | 如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填 | 字符串 | 是 | 设置为定位到授权直销商、授权直销商和转销商,或授权卖方 + 未知来源。“授权直销商”表示仅定位到授权卖方。“授权直销商和转销商”是指定位到授权直销商和转销商。“已获授权的发布商和未参与此计划的发布商”表示将定位到已获授权的卖方、转销商和未知卖方。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 包含 | 如果“类型”为“展示广告”“视频广告”或“音频广告”,则必填 | 字符串、列表 | 是 | 要包含在定位条件中的广告资源来源、广告交易平台和子广告交易平台的列表。 此列使用 Display & Video 360 API 列表格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; 等) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 排除 | 否 | 字符串、列表 | 是 | 要排除在定位条件中的广告资源来源、广告交易平台和子广告交易平台的列表。 此列使用 Display & Video 360 API 列表格式 = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; 等) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
广告资源来源定位 - 定位新的广告交易平台 | 否 | 字符串 | 是 | 设置为定位新的广告交易平台。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
私下交易组定位包含条件 | 否 | 字符串、列表 | 是 | 要包含在定位条件中的分组交易 ID 列表。您可以在“我的广告资源”的“分组的交易”部分以及订单项、广告订单和广告系列的“广告资源来源”设置的“组”部分找到分组的交易 ID。 列表格式 = (DealGroupId; DealGroupId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
时段定位 | 否 | 字符串、列表 | 是 | ID 列表,其中每个时段 ID 均采用以下格式构建: 此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
时段定位时区 | 包含“时段定位”时,此字段为必填字段。 | 字符串 | 是 | 用于时段定位的时区。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
环境定位 | 否 | 字符串、列表 | 是 | 要定位到的环境列表。选择一个或多个可接受的值。请注意,如果不选择“网站”,则无法选择“未进行优化的网站”。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
启用了可见度 OMID 定位 | 否 | 字符串 | 是 | 启用此选项后,系统将仅定位到可通过 Open Measurement 标准衡量的展示。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
可见度定位条件 - Active View | 否 | 字符串 | 是 | 指定预测的可见度百分比作为目标。百分比以浮点数表示。{0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} 中的任一值 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 屏幕上 | 否 | 字符串、列表 | 是 | 屏幕上广告位置定位。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 展示位置(内容中) | 否 | 字符串、列表 | 是 | 要定位到的展示广告内容位置。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 视频在内容中的位置 | 否 | 字符串、列表 | 是 | 要定位到的视频广告内容位置。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
位置定位 - 音频内容中的位置 | 否 | 字符串、列表 | 是 | 要定位到的音频广告内容位置。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
视频播放器尺寸定位 | 否 | 字符串、列表 | 是 | 要定位到的视频广告播放器尺寸列表。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
内容时长定位 | 否 | 字符串、列表 | 是 | 要定位的内容时长列表。单位值为分钟。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
内容流类型定位 | 否 | 字符串、列表 | 是 | 要定位的内容流类型列表。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
音频内容类型定位 | 否 | 字符串、列表 | 是 | 要定位到的音频内容类型的列表。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位 - 性别 | 否 | 字符串、列表 | 是 | 要定位到的性别的列表。选择一个或多个可接受的值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位 - 年龄 | 否 | 字符串、列表 | 是 | 定位到特定年龄段的用户。通过选择单个“从”年龄和单个“到”年龄,以及是否要包含“未知”年龄(true/false),指定“从/到”范围。请参阅可接受的年龄范围(从/到)。 示例 1:若要定位到 18-55 周岁的用户并包含未知年龄的用户,请使用以下格式:{从; 到; 包含未知年龄(true/false)} = 18;55;true; 示例 2:若要仅定位到年满 35 周岁的用户并排除未知年龄的用户,请使用以下格式:= 35;+;false;。 “从”的可接受值:
“收件人”的可接受值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位 - 家庭收入 | 否 | 字符串、列表 | 是 | 定位到特定的家庭收入范围。通过选择单个 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 的可接受值:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
受众特征定位 - 育儿状况 | 是 | 字符串、列表 | 是 | 要定位到的育儿状况列表。选择一个或多个可接受的值。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
连接速度定位 | 否 | 字符串 | 是 | 定位到特定的连接速度。选择以下可接受的值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
运营商定位 - 包含 | 否 | 字符串、列表 | 是 | 要定位到的 ISP 或运营商的列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
运营商定位 - 排除 | 否 | 字符串、列表 | 是 | 要排除的 ISP 或运营商的列表。 对于定位类型 列表格式 = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; 等)。此列表会按数字升序生成。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
出价调节系数 | 否 | 字符串、列表的列表 | 是 | 此条目的所有出价调节系数。列表格式 = (row type;criteria ID;bid multiplier value); (row type;criteria ID;bid multiplier value);。出价乘数值的范围介于 0.1 到 10.0 之间。下表列出了可接受的行类型及其对应的标准 ID:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 视频广告格式 | 对于 TrueView 订单项,答案为“是” | 字符串 | 是 | 订单项的视频广告格式。 插播广告 / 信息流视频广告是按每次观看费用 (CPV) 出售的 TrueView 视频广告类型。插播广告 / 导视广告是按每千次展示费用 (CPM) 出售的 TrueView 视频广告类型。导视广告的时长不超过 6 秒,按每千次展示费用 (CPM) 出售。不可跳过的视频广告是指时长介于 6-15 秒且按每千次展示费用 (CPM) 出售的插播广告。插播广告 / 导视广告 / 不可跳过的视频广告是可接受的 TrueView 视频广告类型,适用于按 CPM 出售的目标频次订单项。自适应视频广告是一种可采用多种格式投放的广告类型。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 广告资源来源的列表
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方可见度验证服务供应商 | 仅当更新现有的“TrueView”或“需求开发”订单项时才必需 | 字符串、列表的列表 | 是 | 第三方供应商,用于衡量 TrueView 广告订单项和需求开发广告订单项的可见度。如果在创建 TrueView 或需求开发订单项时将此字段留空,并且在广告客户一级启用了默认的可见度供应商,系统会在创建订单项时启用广告客户级默认供应商。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方可见度报告 ID | 如果第三方可见度衡量服务供应商不是“无”,则为“是”。 | 字符串 | 是 | 第三方可见度供应商用于识别特定报告事件的 ID。此列接受空字符串,这会将报告 ID 设为空。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌保障服务供应商 | 仅在更新现有 TrueView 广告订单项或需求开发广告订单项时才必需 | 字符串、列表的列表 | 是 | 为 TrueView 订单项和需求开发订单项衡量品牌保障的第三方供应商。如果在创建 TrueView 订单项或需求开发订单项时将此字段留空,并且在广告客户一级启用了默认品牌保障供应商,系统会在创建订单项时启用广告客户一级的默认供应商。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌保障报告 ID | 如果第三方品牌保障服务供应商不是“无”,则为“是”。 | 字符串 | 是 | 第三方品牌保障供应商用于识别特定报告事件的 ID。此列接受空字符串,这会将报告 ID 设为空。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方覆盖面衡量服务供应商 | 仅在更新现有 TrueView 广告订单项或需求开发广告订单项时才必需 | 字符串、列表的列表 | 是 | 第三方供应商,用于衡量 TrueView 和需求开发广告订单项的覆盖面。如果在创建 TrueView 订单项或需求开发订单项时将此字段留空,并且在广告客户一级启用了默认覆盖面供应商,系统会在创建订单项时启用广告客户一级的默认供应商。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方覆盖面报告 ID | 如果第三方覆盖面衡量服务供应商不是“无”,则为“是”。 | 字符串 | 是 | 第三方覆盖面供应商用于识别特定报告中的事件的 ID。此列接受空字符串,这会将报告 ID 设为空。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌提升效果衡量服务供应商 | 仅当更新现有的“TrueView”或“需求开发”订单项时才必需 | 字符串、列表的列表 | 是 | 第三方供应商,用于衡量 TrueView 订单项和需求开发广告订单项的品牌提升效果。如果在创建 TrueView 订单项或需求开发订单项时将此字段留空,并且在广告客户一级启用了默认的品牌提升效果衡量供应商,系统会在创建订单项时启用广告客户级默认供应商。 请选择以下值之一:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 第三方品牌提升报告 ID | 如果第三方品牌提升效果衡量服务供应商不是“无”,则为“是”。 | 字符串 | 是 | 第三方品牌提升效果衡量供应商用于识别特定报告事件的 ID。此列接受空字符串,这会将报告 ID 设为空。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 目标频次统计 | 如果订单项子类型为“目标频次”,则为“是” | integer | 是 | 为“目标频次”类型的 YouTube 订单项设置的目标频次计数。此字段只能设置为值 2、3 或 4。对于类型不是“目标频次”的 YouTube 订单项,此字段应为空。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 广告系列目标频次时间范围 | 如果订单项子类型为“目标频次”,则为“是” | 字符串 | 是 | 目标频次类型 YouTube 订单项的目标频次时间范围。目前,此字段只能设置为“每周”。对于类型不是“目标频次”的 YouTube 订单项,此字段应为空。
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView 视频广告资源控制 | 如果 TrueView 订单项子类型为“覆盖面”,且使用信息流广告和 Shorts 广告,则可以 | 字符串、列表 | 是 | 覆盖面或观看次数订单项的视频广告资源控制设置。 选择一个或多个可接受的广告格式值:
|