数据传输 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)。 |
|
广告素材自定义字段名称 |
字符串 |
与特定自定义广告素材字段关联的用户定义名称。 |
|
广告素材自定义字段值 |
字符串 |
将用户定义的值作为可用选项添加到命名字段。 |
|
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 原因类别
ID |
原因类别 |
---|
0 |
无原因 |
1 |
Google |
2 |
合作伙伴政策 |
3 |
Google | 合作伙伴政策 |
4 |
隐私权 |
5 |
Google | 隐私权 |
6 |
合作伙伴政策 | 隐私权 |
7 |
Google | 合作伙伴政策 | 隐私权 |
事件 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。
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-07-25。"],[],[],null,[]]