数据传输 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 用户定义的值,作为命名字段的可用选项。
字段 类型 说明 匹配结果
广告 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 | 合作伙伴政策 | 隐私权

Rich Media 标准事件和事件类型 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
富媒体事件 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。
着陆页网址 字符串 用户点击广告时转到的网址。