数据传输 v2.0:匹配表

所有匹配表文件都以英文逗号分隔的文本文件形式存储在 Google Cloud Storage 中,并使用 gzip 进行压缩。

  • 此类文件的第一行始终是包含列名称的标题行。
  • 对于包含特殊字符的字段,该字段的内容会用英文引号括起来。
  • 行未排序。
  • 文件采用 CSV 格式,并支持 UTF-8 字符编码
  • 除非另有说明,否则没有值的字段会显示为空

activity_cats

字段 类型 说明 匹配到
Floodlight 配置 Floodlight 配置的唯一 ID 广告客户匹配表中的 Floodlight 配置
活动组 ID 与活动组相关联且包含在 Floodlight 代码的 type= 参数中的 ID
活动类型 字符串 与 Floodlight 代码中的 type= 值对应的用户定义字符串
活动 ID 活动的唯一 ID “数据传输”活动文件中的活动 ID
活动子类型 字符串 与 Floodlight 代码中的 cat= 值对应的用户定义字符串
活动 字符串 为 Floodlight 代码指定的用户定义类别报告界面名称
代码统计方法 ID 用户定义的类型 - 用于描述 Floodlight 代码类型。键:1 - 标准,2 - 唯一,3 - 自定义,4 - 交易次数(仅适用于销售代码),5 - 售出商品数(仅适用于销售代码)

activity_types

字段 类型 说明 匹配到
Floodlight 配置 Floodlight 配置的唯一 ID “广告客户匹配表”中的 Floodlight 配置
活动组 ID 此活动组的 ID
活动类型 字符串 与 Floodlight 代码中的 type= 值对应的用户定义字符串
活动组 字符串 此活动组的名称

ads

字段 类型 说明 匹配到
广告客户 ID 广告客户的唯一 ID 数据传输文件 / 匹配表中的广告客户 ID
广告系列 ID 广告系列的唯一 ID 数据传输文件 / 匹配表中的广告系列 ID
广告 ID 广告的唯一 ID 数据传输文件 / 匹配表中的广告 ID
广告 字符串 用户定义的广告名称
广告点击跟踪网址 字符串 仅限点击广告类型广告素材的广告点击网址(也称为点击命令)
广告类型 字符串 广告类型。可能的值包括:“标准、插页式广告、静态点击、动态点击、跟踪、插播视频广告、DART Search Ads 360、联属营销、付费包含、产品 Feed、Search Ads 360 自然搜索、默认、默认插页式广告、默认插播广告、不含品牌信息”
广告素材像素尺寸 字符串 广告素材的尺寸(以像素为单位)
广告评论 字符串 用户定义的广告级评论

ad_placement_assignments

字段 类型 说明 匹配到
广告 ID 广告的唯一 ID 数据传输文件/ 匹配表中的广告 ID
展示位置 ID 展示位置的唯一 ID 数据传输文件 / 匹配表中的展示位置 ID

广告客户

字段 类型 说明 匹配到
Floodlight 配置 Floodlight 配置的唯一 ID activity_cats、activity_types 匹配表
广告客户 ID 广告客户的唯一 ID 数据传输文件 / 匹配表中的广告客户 ID
广告客户 字符串 用户输入的广告客户名称
广告客户组 ID 此广告客户所属的组 ID。广告客户只能是其中一个群组的成员
广告客户组 字符串 用户指定的此广告客户所属的群组。广告客户只能是其中一个群组的成员

素材资源

字段 类型 说明 匹配到
素材资源 字符串 资源的名称。
资产 ID 资产的唯一 ID。 数据传输文件中的资产 ID。
资源类别 字符串 资源的类别。1 = Flash、2 = 视频、3 = 静态图片、4 = HTML5、5 = 其他、6 = 音频
资源取向 字符串 素材资源的屏幕方向:纵向、横向或方形。

浏览器

字段 类型 说明 匹配到
浏览器/平台 ID 浏览器/平台的唯一 ID 数据传输文件中的浏览器/平台 ID
浏览器/平台 字符串 浏览器名称

广告系列

字段 类型 说明 匹配到
广告客户 ID 广告客户的唯一 ID 数据传输文件 / 匹配表中的广告客户 ID
广告系列 ID 广告系列的唯一 ID 数据传输文件 / 匹配表中的广告系列 ID
广告系列 字符串 用户输入的广告系列名称
广告系列开始日期 日期 广告系列开始日期,格式为 YYYYMMDD。
广告系列结束日期 日期 广告系列结束日期,格式为 YYYYMMDD。
结算账单代码 字符串 用户输入的字符串。

cities

字段 类型 说明 匹配到
城市 ID 城市的唯一 ID。 数据传输展示次数和点击次数文件中的城市 ID
城市 字符串 城市名称(英文)。

广告素材

字段 类型 说明 匹配到
广告客户 ID 广告客户的唯一 ID 数据传输文件 / 匹配表中的广告客户 ID
广告素材 ID 与 DCM 界面中的广告素材 ID 匹配
呈现 ID 要传输的数据中的广告素材的唯一 ID。 数据传输文件中的呈现 ID
广告素材 字符串 输入 DCM 界面的广告素材名称。
广告素材上次修改日期 上次修改日期和时间(以从 1970-01-01 00:00:00 UTC 开始计算的毫秒数表示)。
广告素材类型 字符串 图片、HTML、重定向等
广告素材像素尺寸 字符串 宽 x 高广告素材尺寸字符串。空大小,表示为“0X0”。
广告素材图片网址 字符串 广告素材图片的位置(不适用于富媒体)。
广告素材版本 整数 用于更改管理,以捕获不同的版本,例如广告投放人员交换广告素材时。主键的一部分。

creative_ad_assignments

字段 类型 说明 匹配到
广告 ID DCM 中的唯一 ID。 数据传输文件 / 匹配表中的广告 ID
广告素材 ID 这不是呈现 ID。这是广告素材匹配表中使用的广告素材 ID。 广告素材匹配表中的广告素材 ID
广告素材开始日期 轮播开始日期和时间(以毫秒为单位,自 1970 年 1 月 1 日 00:00:00 UTC 起算)。
广告素材结束日期 轮播结束日期和时间(以毫秒为单位,自 1970-01-01 00:00:00 UTC 开始)。
广告素材轮播类型 字符串 轮播类型。
广告素材组 1 字符串 广告素材组 1 中的用户定义值。
广告素材组 2 字符串 广告素材组 2 中的用户定义值。
广告点击跟踪网址 字符串 广告素材的广告点击跟踪网址。

custom_creative_fields

字段 类型 说明 匹配到
广告客户 ID 广告客户的唯一 ID。 数据传输文件 / 匹配表中的广告客户 ID
广告素材 ID 这不是呈现 ID。这是广告素材匹配表中使用的广告素材 ID。 广告素材匹配表中的广告素材 ID
广告素材自定义字段编号 分配给此自定义广告素材字段的槽位 ID(通常为 1-20 之间的 ID)。
广告素材自定义字段名称 字符串 与特定自定义广告素材字段关联的用户定义名称。
广告素材自定义字段值 字符串 将用户定义的值作为可用选项添加到命名字段。
字段 类型 说明 匹配到
广告客户 ID DCM 中的唯一 ID。
Floodlight 配置 Floodlight 配置的唯一 ID
付费搜索广告组 字符串 用户定义的关键字组。
付费搜索广告组 ID 关键字组的唯一 ID。 点击或活动文件中的 Sa360 广告组 ID。
字段 类型 说明 匹配到
广告客户 ID DCM 中的唯一 ID。
Floodlight 配置 Floodlight 配置的唯一 ID
付费搜索广告系列 字符串 用户在 Search Ads 360 中输入的广告系列名称。
付费搜索广告系列 ID Search Ads 360 广告系列的 ID。 点击或活动文件中的 Sa360 广告系列 ID。
付费搜索出价策略 字符串 用户指定的关键字出价策略。如果为空,则返回值“(not set)”。
付费搜索出价策略 ID 关键字出价策略的 ID。 点击或活动文件中的细分值 1。
字段 类型 说明 匹配到
广告客户 ID DCM 中的唯一 ID。
Floodlight 配置 Floodlight 配置的唯一 ID
付费搜索关键字 字符串 用户在 Search Ads 360 中输入的关键字值。
付费搜索关键字 ID Search Ads 360 的唯一 ID。使用“长”格式。 点击或活动文件中的 SA360 关键字 ID。
付费搜索匹配类型 字符串 由用户选择、由引擎定义的关键字选择匹配类型。
付费搜索广告组 ID 关键字组的唯一 ID。 点击或活动文件中的 Sa360 广告组 ID。

designated_market_areas

字段 类型 说明 匹配到
特定媒体市场区域 (DMA) ID 特定媒体市场区域的唯一 ID。 数据传输文件中的特定媒体市场区域 (DMA) ID
特定媒体市场区域 字符串 DMA 文本名称(英文)。

keyword_value

字段 类型 说明 匹配到
广告 ID 广告的唯一 ID。 数据传输文件 / 匹配表中的广告 ID
Keyword 字符串 目标键值对。

null 用户 ID 原因类别

ID 原因类别
0 无原因
1 Google
2 合作伙伴政策
3 Google | 合作伙伴政策
4 隐私权
5 Google | 隐私权
6 合作伙伴政策 | 隐私权
7 Google | 合作伙伴政策 | 隐私权

富媒体标准事件和事件类型 ID

事件 ID 事件类型 ID 名称
1 3 预取
2 1 显示时间
3 1 互动时间
4 3 互动展示次数
5 3 视频全屏播放次数
6 3 全屏看完视频的次数
7 1 全屏模式下的平均观看时间
8 3 Motif 手动关闭次数
9 3 Motif 备用图片
10 1 图案扩展
11 3 视频播放
12 1 视频观看时间
13 3 视频完整播放次数
14 3 视频互动次数
15 3 视频暂停次数
16 3 视频静音次数
17 3 视频重放次数
18 3 看完视频一半的次数
19 3 视频全屏播放次数
20 3 视频停放次数
22 3 放弃视频
149645 3 视频取消静音次数
200034 3 TrueView 观看次数
286263 3 全屏展示次数
536393 3 动态广告展示次数
871060 3 HTML5 展示次数
960584 3 看完视频四分之一的次数
960585 3 看完视频四分之三的次数
1095941 3 插播广告随播广告点击次数
1208655 3 视频跳过次数
1208656 3 视频观看次数
200017 3 音频播放次数
200018 1 音频播放时长
200019 3 音频播放完毕的次数
200020 3 音频互动
200021 3 音频暂停次数
200022 3 音频静音次数
200023 3 音频重放次数
200024 3 音频播放到一半的次数
200025 3 音频停止次数
200026 3 音频放弃
200031 3 音频取消静音次数

custom_rich_media

字段 类型 说明
广告客户 ID
富媒体事件 ID
富媒体事件 字符串
富媒体事件类型 ID
富媒体事件类型 字符串 描述富媒体事件的类型。可能的值为:“计时器、退出、计数器”

operating_systems

字段 类型 说明 匹配到
操作系统 ID 用于数据传输的操作系统的唯一 ID。 DT 文件中大于 22 的操作系统 ID 与此表中存在直接匹配项。 对于小于 23 的 DT 文件操作系统 ID,您必须将 2 的底数乘以数据传输文件中的操作系统 ID,才能在此表中找到相应的匹配项。匹配表操作系统 ID = 2 ^ DT 文件操作系统 ID。 例如,2 ^ 12 = 8192(Linux)。
操作系统 字符串 操作系统名称。

展示位置

字段 类型 说明
广告系列 ID DCM 中的唯一 ID。
网站 ID DCM 中的唯一 ID。
展示位置 ID DCM 中的唯一 ID。
网站键名 字符串 用户在 DCM 广告代码中定义的网站键。
展示位置 字符串 用户定义的展示位置名称。
内容分类 字符串 用户定义的内容类别。
展示位置策略 字符串 用户定义的策略。
展示位置开始日期 日期 展示位置开始日期(格式为 YYYYMMDD)。
展示位置结束日期 日期 展示位置结束日期(格式为 YYYYMMDD)。
展示位置组类型 字符串 展示位置组的用户定义类型。例如,路障。
打包/包版 ID 如果此展示位置是子展示位置类型,则为父级展示位置的网页 ID。
展示位置费用结构 字符串 可能的值包括:“展示次数、点击次数、每千次展示费用、每次点击费用、每次转化费用、固定费率 - 展示次数、固定费率 - 点击次数”
展示位置费用上限选项 字符串 用户输入了费用上限金额。
已激活排期 布尔值 一个布尔值,表示此展示位置是否已投放(结算)。
活动 ID 如果是 CPA 购买交易,则表示相应 Floodlight 代码的 activity-ID。

placement_cost

字段 类型 说明
展示位置 ID DCM 中的唯一 ID。是指展示位置。
展示位置开始日期 日期 航班的开始日期,采用“YYYYMMDD”格式。
展示位置结束日期 日期 广告系列投放周期的结束日期,采用“YYYYMMDD”格式。
打包/包版总预订单位数 购买的单元数,例如 1, 000 次(展示次数)或 1, 000 次(点击次数)。
展示位置费率 浮点数 购买费率,以广告资源网所用币种的纳秒表示。1 纳 = 10 亿分之一。1 纳元 美元 = 0.000000001 美元
展示位置备注 字符串 用户输入了展示位置定价评论。

网站

字段 类型 说明
网站 ID (CM360) CM360 中的唯一 ID。是指 DT 中的网站 ID。
网站 (CM360) 字符串
网站ID (Site Directory) CM360 中的唯一 ID。此网站的全局唯一 ID。
网站(Site Directory) 字符串 此网站的全局唯一名称。

字段 类型 说明
州/省/自治区/直辖市 字符串 州/省/直辖市/自治区的缩写名称。
州/省/区域全称 字符串 州/省/直辖市全称(英语)。

custom_floodlight_variables

字段 类型 说明
Floodlight 配置 Floodlight 配置的唯一 ID
Floodlight 变量 ID 字符串 在 Floodlight 转化代码中找到的变量键“u1”到“u20”。
Floodlight 变量 字符串 与变量键对应的用户输入的名称。

landing_page_url

字段 类型 说明 匹配到
着陆页网址 ID 着陆页网址的唯一 ID。 点击文件中的着陆页网址 ID。
着陆页网址 字符串 用户点击广告后转到的网址。