数据传输 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 匹配
注意:这与 DT v1 不同,在 DT v1 中,广告素材 ID 与界面中的广告素材 ID 不一致,而是与数据传输的 ID 一致。在 DT v2 中,Rendering ID 与数据传输的 ID 匹配,而广告素材 ID 与界面中的 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)。
广告素材自定义字段名称
字符串
与特定自定义广告素材字段关联的用户定义名称。
广告素材自定义字段值
字符串
将用户定义的值作为可用选项添加到命名字段。
paid_search_ad_group
字段
类型
说明
匹配到
广告客户 ID
长
DCM 中的唯一 ID。
Floodlight 配置
长
Floodlight 配置的唯一 ID
付费搜索广告组
字符串
用户定义的关键字组。
付费搜索广告组 ID
长
关键字组的唯一 ID。
点击或活动文件中的 Sa360 广告组 ID。
paid_search_campaign
字段
类型
说明
匹配到
广告客户 ID
长
DCM 中的唯一 ID。
Floodlight 配置
长
Floodlight 配置的唯一 ID
付费搜索广告系列
字符串
用户在 Search Ads 360 中输入的广告系列名称。
付费搜索广告系列 ID
长
Search Ads 360 广告系列的 ID。
点击或活动文件中的 Sa360 广告系列 ID。
付费搜索出价策略
字符串
用户指定的关键字出价策略。如果为空,则返回值“(not set)”。
付费搜索出价策略 ID
长
关键字出价策略的 ID。
点击或活动文件中的细分值 1。
paid_search_keyword
字段
类型
说明
匹配到
广告客户 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 原因类别 由于 null 用户 ID 原因类别的匹配项不会发生变化,因此不会包含在匹配表文件中。您可以使用下面的匹配项来创建自己的匹配项。多个原因是“或”(不太具体),用“|”表示
ID
原因类别
0
无原因
1
Google
2
合作伙伴政策
3
Google | 合作伙伴政策
4
隐私权
5
Google | 隐私权
6
合作伙伴政策 | 隐私权
7
Google | 合作伙伴政策 | 隐私权
由于 RM 标准事件和事件类型的 ID 不会更改,因此不会包含在匹配表文件中。您可以使用以下 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
音频取消静音次数
字段
类型
说明
广告客户 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。
着陆页网址
字符串
用户点击广告后转到的网址。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eData Transfer Match Tables provide mappings between IDs and human-readable values for advertising elements like ads, campaigns, creatives, and placements.\u003c/p\u003e\n"],["\u003cp\u003eMatch tables include details on activities, advertisers, assets, browsers, cities, and designated market areas, among others.\u003c/p\u003e\n"],["\u003cp\u003eThese tables aid in understanding the data present in Data Transfer files, facilitating reporting and analysis.\u003c/p\u003e\n"],["\u003cp\u003eSpecific tables exist for rich media events, paid search data, and custom Floodlight variables, providing deeper insights.\u003c/p\u003e\n"],["\u003cp\u003eTables also include details for operating systems, placements, and sites, allowing for comprehensive campaign tracking.\u003c/p\u003e\n"]]],[],null,[]]