数据传输 v2.0:匹配表
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
所有匹配表文件都会以逗号分隔的文本文件形式存储在 Google Cloud Storage 上,并使用 gzip 进行压缩。
- 此类文件的第一行始终是包含列名称的标题行。
- 对于包含特殊字符的字段,该字段的内容会用引号括起来。
- 行未排序。
- 文件采用 CSV 格式,支持 UTF-8 字符编码
- 除非另有说明,否则不带值的字段将为空
activity_cats
字段 |
类型 |
说明 |
匹配结果 |
---|
Floodlight 配置 |
长 |
Floodlight 配置的唯一 ID |
广告客户匹配表中的 Floodlight 配置 |
活动组 ID |
长 |
与活动组关联的 ID,包含在 Floodlight 代码的 type= 参数中 |
|
活动类型 |
字符串 |
用户定义的字符串,与 Floodlight 代码中的 type= value 相对应
|
|
活动 ID |
长 |
活动的唯一 ID |
数据传输活动文件中的活动 ID |
活动子类型 |
字符串 |
与 Floodlight 代码中的 cat= 值对应的用户定义的字符串 |
|
活动 |
字符串 |
用户定义的 Floodlight 代码的类别报告界面名称 |
|
代码统计方法 ID |
长 |
用户定义的类型 - 描述 Floodlight 代码类型。键:1 - 标准;2 - 唯一;3 - 自定义;4 - 交易整数 - 仅适用于销售代码;5 - 售出商品数量 - 仅限销售代码 |
|
activity_types
字段 |
类型 |
说明 |
匹配结果 |
---|
Floodlight 配置 |
长 |
Floodlight 配置的唯一 ID |
广告客户匹配表中的 Floodlight 配置 |
活动组 ID |
长 |
此活动组的 ID |
|
活动类型 |
字符串 |
用户定义的字符串,与 Floodlight 代码中的 type= value 相对应 |
|
活动组 |
字符串 |
此活动组的名称 |
|
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 |
advertisers
字段 |
类型 |
说明 |
匹配结果 |
---|
Floodlight 配置 |
长 |
Floodlight 配置的唯一 ID |
activity_cats、activity_types 匹配表 |
广告客户 ID |
长 |
广告客户的唯一 ID |
数据传输文件 / 匹配表中的广告客户 ID |
广告客户 |
字符串 |
用户输入了广告客户名称 |
|
广告客户组 ID |
长 |
此广告客户所属的群组 ID。广告主可能只属于一个群组 |
|
广告客户组 |
字符串 |
此广告客户所属的用户指定的群组。广告主可能只属于一个群组 |
|
资产
字段 |
类型 |
说明 |
匹配结果 |
---|
资产 |
字符串 |
资产的名称。 |
|
资产 ID |
长 |
资产的唯一 ID。 |
数据传输文件中的素材资源 ID。 |
资源类别 |
字符串 |
资产的类别。1 = 闪光灯, 2 = 视频, 3 = 静态图片, 4 = HTML5, 5 = 其他, 6 = 音频 |
|
资源取向 |
字符串 |
素材资源的屏幕方向:纵向、横向或方形。 |
|
浏览器
字段 |
类型 |
说明 |
匹配结果 |
---|
浏览器/平台 ID |
长 |
浏览器/平台的唯一 ID |
数据传输文件中的浏览器/平台 ID |
浏览器/平台 |
字符串 |
浏览器名称 |
|
广告系列
字段 |
类型 |
说明 |
匹配结果 |
---|
广告客户 ID |
长 |
广告客户的唯一 ID |
数据传输文件 / 匹配表中的广告客户 ID |
广告系列 ID |
长 |
广告系列的唯一 ID |
数据传输文件 / 匹配表中的广告系列 ID |
广告系列 |
字符串 |
用户输入的广告系列名称 |
|
广告系列开始日期 |
date |
广告系列开始日期,格式为 YYYYMMDD。 |
|
广告系列结束日期 |
date |
广告系列结束日期,格式为 YYYYMMDD。 |
|
结算帐单代码 |
字符串 |
用户输入的字符串。 |
|
cities
字段 |
类型 |
说明 |
匹配结果 |
---|
城市 ID |
长 |
城市的唯一 ID。 |
数据传输展示中的城市 ID,点击文件 |
城市 |
字符串 |
城市名称,采用英语。 |
|
creatives
字段 |
类型 |
说明 |
匹配结果 |
---|
广告客户 ID |
长 |
广告客户的唯一 ID |
数据传输文件 / 匹配表中的广告客户 ID |
广告素材 ID |
长 |
与 DCM 界面中的广告素材 ID 匹配
|
|
呈现 ID |
长 |
用于数据传输的广告素材的唯一 ID。 |
数据传输文件中的呈现 ID |
种广告素材 |
字符串 |
在 DCM 界面中输入的广告素材名称。 |
|
广告素材上次修改日期 |
长 |
最后修改日期和时间(自世界协调时间 (UTC) 1970-01-01 00:00:00 开始)。 |
|
广告类型 |
字符串 |
图片、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)。 |
|
广告素材自定义字段名称 |
string |
与特定自定义广告素材字段关联的用户定义的名称。 |
|
广告素材自定义字段值 |
string |
用户定义的值,作为命名字段的可用选项。 |
|
paid_search
字段 |
类型 |
说明 |
匹配结果 |
---|
广告 ID |
长 |
DCM 中的唯一 ID。 |
|
广告客户 ID |
长 |
DCM 中的唯一 ID。 |
|
广告系列 ID |
长 |
|
|
付费搜索广告 ID |
长 |
与 Search Ads 360 广告相关联的唯一 ID。 |
|
付费搜索关键字 ID |
长 |
Search Ads 360 中的唯一 ID。使用“长”格式,一个 17 位数字,以 43 开头* |
|
付费搜索原有关键字 ID |
长 |
Search Ads 360 中的唯一 ID。使用“43 位*”之前的“短”格式。
|
点击或活动文件中的细分值 1。 |
付费搜索广告系列 |
字符串 |
用户在 Search Ads 360 中输入的用户定义的广告系列名称。 |
|
付费搜索广告组 |
字符串 |
用户定义的关键字组。 |
|
付费搜索出价策略 |
字符串 |
用户定义的关键字出价策略。如果为空,则返回“(not set)”值。 |
|
付费搜索着陆页网址 |
字符串 |
用户在 Search Ads 360 中输入的着陆页网址。 |
|
付费搜索关键字 |
字符串 |
用户在 Search Ads 360 中输入的关键字定义。 |
|
付费搜索匹配类型 |
字符串 |
用户选择、引擎定义、关键字选择匹配类型。 |
|
designated_market_areas
字段 |
类型 |
说明 |
匹配结果 |
---|
特定媒体市场区域 (DMA) ID |
长 |
特定媒体市场区域的唯一 ID。 |
数据传输文件中的特定媒体市场区域 (DMA) ID |
特定媒体市场区域 |
字符串 |
特定媒体市场区域的文本名称(英语)。 |
|
keyword_value
字段 |
类型 |
说明 |
匹配结果 |
---|
广告 ID |
长 |
广告的唯一 ID。 |
数据传输文件 / 匹配表中的广告 ID |
Keyword |
字符串 |
目标键值对。 |
|
用户 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 |
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 |
音频取消静音次数 |
字段 |
类型 |
说明 |
---|
广告客户 ID |
长 |
|
富媒体事件 ID |
长 |
|
富媒体事件 |
string |
|
富媒体事件类型 ID |
长 |
|
富媒体事件类型 |
string |
描述富媒体事件的类型。可能的值包括:“计时器、退出、计数器” |
operating_systems
字段 |
类型 |
说明 |
匹配结果 |
---|
操作系统 ID |
长 |
用于数据传输的操作系统的唯一 ID。 |
DT 文件中大于 22 的操作系统 ID 在此表中具有直接匹配。
对于小于 23 的 DT 文件操作系统 ID,您必须将数据传输文件中操作系统 ID 的 2 加上 2,才能在此表中找到对应的匹配项。匹配表操作系统 ID = 2 ^ DT 文件操作系统 ID。
例如,2 ^ 12 = 8192 (Linux)。 |
操作系统 |
string |
操作系统名称。 |
|
展示位置
字段 |
类型 |
说明 |
---|
广告系列 ID |
长 |
DCM 中的唯一 ID。 |
网站 ID |
长 |
DCM 中的唯一 ID。 |
展示位置 ID |
长 |
DCM 中的唯一 ID。 |
网站键名 |
字符串 |
用户定义的网站键,如 DCM 广告代码中所示。 |
放置 |
字符串 |
用户定义的展示位置名称。 |
内容分类 |
字符串 |
用户定义的内容类别。 |
展示位置策略 |
字符串 |
用户定义的策略。 |
展示位置开始日期 |
日期 |
展示位置开始日期(采用 YYYYMMDD 格式)。 |
展示位置结束日期 |
日期 |
展示位置结束日期,格式为 YYYYMMDD。 |
展示位置组类型 |
字符串 |
用户定义的展示位置组类型。例如,包版。 |
打包/包版ID |
长 |
此父级展示位置的网页 ID(如果此展示位置是子级展示位置类型)。 |
展示位置费用结构 |
字符串 |
可能的值包括:“展示次数”、“点击次数”、“每千次展示费用”、“每次点击费用”、“每次转化费用”、“固定费率 - 展示次数”、“固定费率 - 点击次数” |
展示位置费用上限选项 |
字符串 |
用户输入了费用上限金额。 |
已激活排期 |
布尔值 |
TRUE 或 FALSE,表示这是排期(结算)展示位置。 |
活动 ID |
长 |
如果是每次转化费用购买,则表示相应 Floodlight 代码的 Activity-ID。 |
placement_cost
字段 |
类型 |
说明 |
---|
展示位置 ID |
长 |
DCM 中的唯一 ID。表示展示位置。 |
展示位置开始日期 |
日期 |
排期的开始日期,格式为“YYYYMMDD”。 |
展示位置结束日期 |
日期 |
排期的结束日期,格式为“YYYYMMDD”。 |
打包/包版总预订单位数 |
长 |
购买的单位,例如 1, 000(次展示)或 1, 000(次点击)。 |
展示位置费率 |
浮点值 |
购买率(以广告资源网的币种表示)。1 纳米 = 10 亿。1 纳米 = $0.000000001 |
展示位置备注 |
字符串 |
用户输入的展示位置定价注释。 |
sites
字段 |
类型 |
说明 |
---|
网站 ID (CM360) |
长 |
CM360 的唯一 ID。指 DT 中的网站 ID。 |
网站 (CM360) |
字符串 |
|
网站ID (Site Directory) |
长 |
CM360 的唯一 ID。此网站的全局唯一 ID。 |
网站(Site Directory) |
字符串 |
此网站的全局唯一名称。 |
states
字段 |
类型 |
说明 |
---|
州/省/自治区/直辖市 |
字符串 |
州/省/自治区/直辖市的简称。 |
州/省/区域全称 |
字符串 |
州/省级行政区名称(英文)。 |
|
|
|
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):2023-05-25。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{
"last_modified": "最后更新时间 (UTC):2023-05-25。",
"state": ""
}