如需了解格式说明,请参阅概览。
字段 | 必填 | 类型 | 可写入 | 说明 |
---|---|---|---|---|
广告 ID | 仅当修改现有广告时才必须指定此字段 | integer | 否 | 广告组广告的数字 ID 值。如果留空,系统会创建一个新广告并为其分配唯一 ID。 |
广告组 ID | 是 | integer | 否 | 父级广告组的数字 ID 值。您可为要与此广告同时创建的广告组指定自定义标识符(例如“ext[custom ad group ID]”)。 |
广告组名称 | 否 | 字符串 | 否 | 广告组名称 |
名称 | 是 | 字符串 | 是 | 条目的名称。 |
状态 | 是 | 字符串 | 是 | 条目的状态设置。
|
广告类型 | 对于 YouTube 广告和需求开发广告,此属性为必填 | 字符串 | 是 | 广告的广告格式。 插播广告和信息流视频广告是按每次观看费用 (CPV) 出售的 YouTube 视频广告类型。导视广告是指时长不超过 6 秒的 YouTube 视频广告,按每千次展示费用 (CPM) 出售。不可跳过式视频广告是指时长介于 6 到 15 秒之间的 YouTube 插播广告,按每千次展示费用 (CPM) 出售。YouTube 音频广告是指 YouTube 音频广告。自适应视频广告是一种可采用多种格式投放的 YouTube 广告类型。如果视频足够短,经济实惠地扩大覆盖面广告将作为 YouTube 导视广告投放;否则,将作为 YouTube 插播广告投放。需求开发视频广告可采用多种格式投放,包括但不限于 YouTube。需求开发图片广告会展示图片。轮播式需求开发广告会显示卡片。产品需求开发广告用于展示商品。 请选择以下值之一:
|
视频 ID | 对于 YouTube 广告和需求开发视频广告,此字段为必填 | 字符串 | 是 | YouTube 视频 ID |
显示网址 | 插播广告和导视广告支持 | 字符串 | 是 | 广告显示网址 |
着陆页网址 | 插播广告、导视广告和需求开发广告必须提供 | 字符串 | 是 | 广告着陆页网址 |
DCM 跟踪 - 展示位置 ID | 仅在更新 DCM 跟踪广告时才需要 | integer | 是 | 相应跟踪广告的 DCM 展示位置的数字 ID 值。 如需移除 DCM 跟踪广告,请将“DCM 跟踪 - 展示位置 ID”“DCM 跟踪 - 广告 ID”和“DCM 跟踪 - 广告素材 ID”这三个列留空。 |
DCM 跟踪 - 广告 ID | 仅在更新 DCM 跟踪广告时才需要 | integer | 是 | 相应跟踪广告的 DCM 广告的数字 ID 值。如需移除 DCM 跟踪广告,请将“DCM 跟踪 - 展示位置 ID”“DCM 跟踪 - 广告 ID”和“DCM 跟踪 - 广告素材 ID”这三个列留空。 |
DCM 跟踪 - 广告素材 ID | 仅在更新 DCM 跟踪广告时才需要 | integer | 是 | 相应跟踪广告的广告素材的数字 ID 值。如需移除 DCM 跟踪广告,请将“DCM 跟踪 - 展示位置 ID”“DCM 跟踪 - 广告 ID”和“DCM 跟踪 - 广告素材 ID”这三个列留空。 |
点击跟踪广告代码网址 | 否 | 字符串 | 是 | 广告点击跟踪广告代码网址 |
点击跟踪广告代码网址参数 | 否 | 字符串、列表的列表 | 是 | 点击跟踪广告代码网址自定义参数。格式 = (name1; value1;); (name2; value2;); 等 |
号召性用语 | 如果父级订单项是 YouTube 行动号召视频订单项、“标题”不为空,或“广告类型”为“需求开发视频广告”“需求开发图片广告”“需求开发轮播广告”,则必填 | 字符串 | 是 | 号召性用语按钮的标签(1 行,最多 10 个字符)。 |
标题 | 需求开发广告必须提供 | 字符串 | 是 | 号召性用语重叠式广告的标题(1 行,最多可包含 15 个字符)。 |
显示网址路径 1 | 否 | 字符串 | 是 | 显示网址路径 1 |
显示网址路径 2 | 否 | 字符串 | 是 | 显示网址路径 2 |
信息流视频缩略图 | 信息流视频广告:是 | 字符串 | 是 | 要用于视频发现广告的视频缩略图
|
信息流视频广告标题 | 信息流视频广告和需求开发广告必须提供 | 字符串 | 是 | 发现广告或自适应广告的标题文字,或需求开发广告的长标题。 |
广告内容描述第 1 行 | 信息流视频广告和需求开发广告必须提供 | 字符串 | 是 | 发现广告的广告内容描述 1 文字或自适应广告的广告内容描述 |
广告内容描述 2 | 信息流视频广告必须提供 | 字符串 | 是 | 发现广告的广告内容描述 2 文字 |
信息流视频广告着陆页 | 信息流视频广告:是 | 字符串 | 是 | 发现广告的着陆页 |
移动版着陆页网址 | 否 | 字符串 | 是 | 适用于移动设备的广告着陆页网址 |
商家名称 | 需求开发广告必须提供 | 字符串 | 是 | 所宣传商家的名称 |
着陆页网址后缀 | 否 | 字符串 | 是 | 着陆页网址的后缀 |
徽标素材资源 ID | 需求开发广告必须提供 | 字符串、列表 | 是 | 徽标的素材资源 ID 列表。此列表会按数字升序生成。 |
营销图片素材资源 ID | 如果“广告类型”为“需求开发图片”,则为必填项 | 字符串、列表 | 是 | 营销图片的素材资源 ID 列表。此列表会按升序生成。 |
需求开发广告系列卡片 | 如果“广告类型”为“轮播式需求开发广告”,则为必填项 | 字符串、列表的列表 | 是 | 这会定义一个卡片列表,格式如下: (最终到达网址;最终到达移动网址;网址;标题;号召性用语文字;营销图片素材资源 ID;其他营销素材资源 ID...)。 例如:(google.com; mobile.google.com; 标题; 点击此处; 10020; 20020; 30020)。每个营销资源都必须具有独特的宽高比。如果某个广告下的某张卡片使用方形营销图片,那么该广告下的所有卡片都必须使用方形营销图片(这也适用于其他宽高比)。 |
随播横幅广告素材资源 ID | 否 | 字符串、列表 | 是 | 随播横幅广告的素材资源 ID 列表。此列表会按数字升序生成。效果导向型视频广告系列、需求开发型视频广告系列、插播广告、导视广告和不可跳过的广告均支持此功能。列表格式 = 100; 200; |