数据传输 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。
着陆页网址 字符串 用户点击广告后转到的网址。