数据传输 v2.0:匹配表

所有匹配表文件在 Google 上都存储为逗号分隔的文本文件 Cloud Storage 并使用 gzip 进行压缩。

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

activity_cats

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

activity_types

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

ads

字段 类型 说明 匹配到
广告客户 ID 广告客户的唯一 ID 数据传输文件 / 匹配表中的广告客户 ID
广告系列 ID 广告系列的唯一 ID 数据传输文件 / 匹配表中的广告系列 ID
广告 ID 广告的唯一 ID 数据传输文件 / 匹配表中的广告 ID
广告 字符串 用户定义的广告名称
广告点击跟踪网址 字符串 仅限点击广告类型(也称为点击)的广告点击网址 命令)
广告类型 字符串 广告类型。可能的值包括:“Standard”、“插页式广告”、“静态点击”、“动态点击” 跟踪, In-Steam Video, DART Search Ads 360, 联属营销, 付费收录, 产品 Feed, Search Ads 360 Natural Search, 默认、非页内默认广告、插播默认广告、品牌中性
广告素材像素尺寸 字符串 广告素材的尺寸(以像素为单位)
广告评论 字符串 用户定义的广告级评论

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
广告系列 字符串 用户输入的广告系列名称
广告系列开始日期 date 广告系列的开始日期,格式为 YYYYMMDD。
广告系列结束日期 date 广告系列结束日期,格式为 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-01-01 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 DCM 中的唯一 ID。
广告客户 ID DCM 中的唯一 ID。
广告系列 ID
付费搜索广告 ID 与 Search Ads 360 广告关联的唯一 ID。
付费搜索关键字 ID Search Ads 360 中的唯一 ID。使用“长”格式,即以 43* 开头的 17 位数字
付费搜索原有关键字 ID Search Ads 360 中的唯一 ID。使用“简短”开头。 点击文件或活动文件中的细分值 1。
付费搜索广告系列 字符串 用户定义的广告系列名称,与在 Search Ads 360 中输入的一样。
付费搜索广告组 字符串 用户定义的关键字组。
付费搜索广告出价策略 字符串 用户定义的关键字出价策略。返回值“(not set)”(如果为空)。
付费搜索着陆页网址 字符串 用户定义的着陆页网址,与在 Search Ads 360 中输入的一样。
付费搜索关键字 字符串 用户定义的关键字值,与在 Search Ads 360 中输入的一样。
付费搜索匹配类型 字符串 用户选择、引擎定义、关键字选择的匹配类型。

designated_market_areas

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

keyword_value

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

空 User-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 Motif 展开
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,数据传输中操作系统 ID 的幂次值必须为 2。 文件在此表中查找其对应的匹配项。匹配表操作系统 ID = 2 ^ DT 文件系统 ID。 例如,2 ^ 12 = 8192 (Linux)。
操作系统 字符串 操作系统名称。

展示位置

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

placement_cost

字段 类型 说明
展示位置 ID DCM 中的唯一 ID。指展示位置。
展示位置开始日期 日期 排期的开始日期,格式为“YYYYMMDD”格式。
展示位置结束日期 日期 排期的结束日期,以“YYYYMMDD”表示格式。
打包/包版总预订单位数 已购买的广告单元数,例如 1000(展示次数)或 1000(点击次数)。
展示位置费率 浮点数 购买时的价格,以网络货币的十亿分之一为单位。1 nano = 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 字符串 变量键“u1”通过“u20”在 Floodlight 中找到 转化跟踪代码
Floodlight 变量 字符串 用户输入的与变量键对应的名称。

landing_page_url

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