数据传输 v2.0:文件格式

所有数据传输文件均以逗号分隔值 (CSV) 格式存储。由于数据传输的可自定义性,您的文件可能不包含以下所有字段。

  • 此类文件的第一行始终是包含列名称的标题行。
  • 对于包含特殊字符的字段,该字段的内容会用英文引号括起来。
  • 缺失的值会留空。
  • 行未排序。
  • Display & Video 360 字段的匹配表采用实体读取文件格式。 详细了解 Display & Video 360 匹配表
  • 只有在广告客户在 DCM<>DBM 之间建立关联并获得相应权限的情况下,DBM 字段才会填充。 您必须为每位广告客户授予权限。您还可以授权合作伙伴默认启用每个新广告客户。 在 Display & Video 360 中,依次前往“广告客户(或合作伙伴)”>“基本详情”>“DCM 配置”,然后启用将 Display & Video 360 数据纳入 DCM 数据传输中

价格文件

仅适用于欧洲经济区内的广告客户。如需了解详情,请访问帮助中心: 详细了解价格透明度报告

文件命名惯例

文件名由 dcm ID(例如账号或 Floodlight 广告系列)、数据传输类型(展示、点击、活动或 rich_media)、处理文件的日期和小时 (YYYYMMDDHH)、报告生成的日期 (YYYYMMDD)、报告生成的时间 (HHMMSS) 以及报告的执行 ID 组成,这些内容之间以下划线分隔。

例如,账号展示次数文件可能如下所示:dcm_account_XXXX_impression_2015122400_20151225_123000_2413119.csv.gz,其中 XXXX 代表账号 ID,文件是 2015 年 12 月 24 日的第 0 小时。该报告的生成时间为 12 月 25 日下午 12:30,执行 ID 为 2413119。

字段 类型 展示 点击 活动 富媒体 说明
着陆页网址 ID 字符串 着陆页网址的唯一 ID。与 landing_page_url 匹配表中的着陆页网址 ID 联接。
引荐来源网址 字符串 包含广告展示的网址(如果可能)。也可能为空,或返回广告服务器网址。
展示 ID 字符串 用于联接展示、点击和富媒体数据传输文件数据的唯一 ID
资产 ID 资产的唯一 ID。
Active View:符合条件的展示次数 相应展示是否符合可见度衡量条件。展示必须符合以下条件才能衡量可见度:(a) 广告的广告素材包含 Active View 代码,并且 (b) 在广告展示时,该代码能与 Google Marketing Platform 服务器成功通信。

如需了解详情,请参阅 Active View 帮助
Active View:可衡量展示次数 此展示是否为 Active View 可衡量的展示
Active View:可见展示次数 展示是否可见
活动 ID 与转化事件相关联的 Floodlight 代码的 ID
事件时间 自 1970-01-01 00:00:00 UTC 以来经过的微秒数
事件类型 字符串 包含与事件相关的详细信息 - 对于观看和点击事件,这些详细信息为“观看”和“点击”,但对于转化事件,这些详细信息可能是“转化”或空白
事件子类型 字符串 包含与事件相关的更多详细信息 - 对于观看和点击事件,这些值为“VIEW”和“CLICK”,但对于转化事件,这些值可能是“POSTVIEW”“POSTCLICK”或空白
用户 ID 字符串 跟踪 ID(基于用户的浏览器 Cookie 或移动设备 ID,但不会公开这些信息)。出于隐私保护方面的原因,此字段可能会设为 0。
广告客户 ID 广告客户的唯一 ID
广告系列 ID 广告系列的唯一 ID
Floodlight 配置 Floodlight 配置的唯一 ID
广告 ID 广告展示位置的唯一 ID
呈现 ID 要进行数据传输的广告素材的唯一 ID。与 UI-Creative-ID 不符
广告素材版本 整数 广告素材版本号
网站 ID (DCM) 投放广告的网站的唯一 ID
展示位置 ID 投放广告的网站网页 / 展示位置的唯一 ID
国家/地区代码 字符串 char(2) 由 2 个字母组成的 ISO 3166-1 国家/地区代码
州/省/自治区/直辖市 字符串 用户所在州/省的身份证件(美国/加拿大)
浏览器/平台 ID 浏览器类型的 ID
浏览器/平台版本 字符串 浏览器版本
操作系统 ID 操作系统的 ID
特定媒体市场区域 (DMA) ID 特定媒体市场区域 ID(美国/加拿大)
城市 ID 城市 ID
邮编 字符串 Postal-Code(美国/加拿大)
其他数据 字符串 存储 activity 字符串中未另加标签的键值对数据。(任何键值对,但不包括“src="、"type="、"cat="、"ord="、"u="、"cost="、"qty="、"tran="、"a=" 或 "b=")。(可用于进一步细分产品,也称为“自定义 Floodlight 变量”)
ORD 值 字符串 广告客户的序数 ID(如果与指定的活动类型相关)。 通过“ord=”键值对传递(也用于在销售代码中存储客户的 Order-ID)
互动时间 字符串 活动的关联(也称为“匹配的”)点击或展示时间,以微秒为单位,自 1970-01-01 00:00:00 UTC 开始
转化 ID 整数 表示活动是否已匹配为点击后(值为 1)或展示后(值为 2)转化,或者未匹配(值为 0)
细分值 1 Search Ads 360 关键字 ID
富媒体事件 ID Rich Media 广告的 MET 事件 ID。
富媒体事件类型 ID 富媒体事件类型的 ID。如需查看匹配说明,请参阅“匹配表”部分。您需要创建自己的匹配表。
事件计时器 双精度 MET 计时器值(etm= 值),以秒为单位
事件计数器 MET 计数器值(ecn= 值)
总转化次数 整数 可以包含类型或类别的其他值,例如销售数量。使用“qty=”键值对传递
总收入 双精度 可以包含类型或类别的其他值,例如以百万美元为单位的销售额。 您可以将其乘以 1,000,000,以查看美元金额。
Partner1 ID 字符串 Partner1 加密值
Partner2 ID 字符串 Partner2 加密值
DBM 数据视图状态 字符串 当代码封装容器用于第三方验证或投放时,观看状态会指示 Display & Video 360 是否成功赢得展示、是否向相应广告资源投放了广告,以及 Campaign Manager 是否跟踪了展示。“outer”的值:表示 Display & Video 360 赢得了出价,并返回了要投放在发布商网站上的封装代码。 值为“inner”表示广告因广告资源被视为对品牌形象不会产生不利影响而投放。 当这两种事件都发生时,系统会记录两次展示。如果只有一条展示记录的值为“outer”,并且没有相应的值为“inner”的记录,则表示第三方验证服务在出价后屏蔽了展示。如果值为“3pas_merged”,则表示有一次封装的 Display & Video 360 展示由 Campaign Manager 成功跟踪。 如果值为“3pas_outer”,则表示已向 Campaign Manager 发送跟踪 ping,但未收到响应。 不过,Display & Video 360 仍赢得了出价,并请求从第三方广告服务器发送广告素材。
DBM 竞价 ID 字符串 用于在观看/点击/转化类型之间联接事件的字符串,例如“ABCDEFGH_abcdefgh-0123456789”。请勿假定 auction_id 值的任何排序、结构或含义
DBM 请求时间 我们收到广告请求的时间的 Unix 时间戳(以微秒为单位,1 微秒为 1,000,000 秒的 1/1,000,000),例如 1330403779608570 表示 2012 年 2 月 28 日(星期二)04:36:19.608570。虽然此值在查看、点击和转化事件中保持一致,但不保证是唯一的 - 请使用 auction_id 联接事件
DBM 广告客户 ID 与事件相关的广告客户的 Display & Video 360 数字 ID,例如 164332
DBM 广告订单 ID 与事件相关的 Display & Video 360 广告订单的数字 ID,例如 1079941
DBM 订单项 ID 与事件相关的 Display & Video 360 订单项的数字 ID,例如 1155785
DBM 广告系列 ID Display & Video 360 广告系列的唯一 ID
DBM 广告素材 ID 与事件相关的 Display & Video 360 广告素材的数字 ID,例如 367487
DBM 出价(美元) 出价是指在第一价竞价调整之前,订单项为展示分配的值。对于固定 CPM 订单项,此值为出价时订单项的固定 CPM。虽然出价会以 CPM 值的形式发送到广告交易平台,但出价价格会以每千次展示费用的形式表示,以便与其他指标保持一致。出价以纳米美元为单位。您可以将此值除以 1,000,000,000,以查看出价价格(以美元为单位)。注意:YouTube 订单项不支持出价。
DBM 出价(合作伙伴币种) 出价是指在第一价竞价调整之前,订单项为展示分配的值。对于固定 CPM 订单项,此值为出价时订单项的固定 CPM。虽然出价会以 CPM 值的形式发送到广告交易平台,但出价价格会以每千次展示费用的形式表示,以便与其他指标保持一致。出价以合作伙伴币种纳米为单位。您可以除以 1,000,000,000,以查看实际合作伙伴币种的出价。注意:YouTube 订单项不支持出价。
DBM 出价(广告客户币种) 出价是指在第一价竞价调整之前,订单项为展示分配的值。对于固定 CPM 订单项,此值为出价时订单项的固定 CPM。虽然出价会以 CPM 值的形式发送到广告交易平台,但出价价格会以每千次展示费用的形式表示,以便与其他指标保持一致。出价以广告客户币种纳米为单位。您可以将出价除以 1,000,000,000,以查看实际广告客户币种的出价。注意:YouTube 订单项不支持出价。
DBM 网址 字符串 从广告交易平台收到的出价请求中提取的原始网址,例如“http://www.example.com”。由于某些广告交易平台会在出价请求中遮盖网址,因此此值可能是“source_url_hidden”
DBM 网站 ID 与网址匹配的最具体的通用网站的 Display & Video 360 数字 ID
DBM 语言 字符串 ISO 639-1 代码或“zh_CN”(简体中文)、“zh_TW”(繁体中文)或“other”(其他),表示与观看事件相关的语言
DBM AdX 网页类别 字符串 包含以空格分隔的 Ad Exchange 网页类别 ID,例如“65 189”。类别可能不互斥
DBM 匹配的目标关键字 字符串 一个以英文逗号分隔的字符串,包含与与查看事件相关的网页匹配的定位关键字列表,例如“apple,orange,banana”。虽然与观看事件相关的网页可能与许多关键字匹配,但系统只会纳入定位到的关键字;如果关键字列表较大,我们可能会限制返回的关键字数量
DBM 交易平台 ID 请求广告的广告交易平台的 Display & Video 360 数字 ID
DBM 促成转化的广告资源来源外部 ID 字符串 归因广告资源来源的外部 ID。Display & Video 360 会根据底价和竞价类型,从与观看事件相关的广告客户可访问的广告资源中选择最匹配的广告资源作为归因广告资源来源
DBM 促成转化的广告资源来源是否公开 布尔值 如果广告资源来源面向所有买方开放,则为 true。否则为 false
DBM 广告位置 指定广告在网页上的展示位置(如果已知)。1 表示首屏上方,2 表示首屏下方
DBM 国家/地区代码 字符串 由 2 个字母组成的 ISO 3166-1 国家/地区代码,用于标识展示次数的最佳猜测国家/地区,例如“美国”
DBM 特定媒体市场区域 (DMA) ID 特定媒体市场区域代码(如果已知),例如 807
DBM 邮政编码 字符串 用于标识展示机会的最佳猜测邮政区域的邮政编码(如果已知),例如“98033”。不要假定不同国家/地区的电话号码是唯一的
DBM 州/省/区域 ID 与报告和定位中可用的州/区域整数匹配的整数
DBM 城市 ID Display & Video 360 数字 ID,用于标识展示的最佳猜测城市
DBM 操作系统 ID Display & Video 360 数字 ID,用于标识与此事件相关的操作系统
DBM 浏览器/平台 ID 用于标识与此事件相关的浏览器的 Display & Video 360 数字 ID
DBM 浏览器时区偏差(分钟) 用户浏览器所用的有效时区与 GMT-12 之间的时差(以分钟为单位),例如 1320 表示浏览器时区为 GMT+10
DBM 网络速度 Display & Video 360 数值 ID,表示与观看事件相关的网络速度。
1=拨号
2=EDGE/2G
3=UMTS/3G
4=基本 DSL
5=HSDPA/3.5G
6=宽带/4G
7=未知
DBM 匹配的目标细分 字符串 与访问者匹配的目标用户名单的名称(以空格分隔),例如“-4 456”。如果访问者位于与此事件关联的广告未定位到的用户名单中,则不会包含在此处
DBM ISP ID 展示机会的最佳猜测互联网服务提供商的 Display & Video 360 数字 ID。此值可能缺失
DBM 设备类型 识别出的设备类型的数值。0 = COMPUTER、1 = OTHER、2 = SMARTPHONE、3 = TABLET、4 = SMARTTV、5 = CONNECTEDTV
DBM 移动设备品牌 ID 移动设备品牌的数字 ID。此值可能缺失
DBM 移动设备型号 ID 移动设备型号的数字 ID。此值可能缺失
DBM 媒体费用(美元) 为展示付费的金额(以纳米美元为单位),您可以将其除以 1,000,000,000 以查看其币种。此值可以为零
DBM 媒体费用(合作伙伴币种) 为展示付费的金额(以合作伙伴币种计,单位为纳米),您可以将其除以 1,000,000,000 以查看其币种。此值可以为零
DBM 媒体费用(广告客户币种) 为展示付费的金额(以广告客户币种为单位,以纳米为单位,您可以将其除以 1,000,000,000 以显示为币种)。此值可以为零
DBM 收入(美元) 合作伙伴账号因观看事件获得的总金额(以纳米美元为单位)。此值可以为零
DBM 收入(合作伙伴币种) 合作伙伴账号因观看事件而赚取的合作伙伴币纳米总金额。此值可以为零
DBM 收入(广告客户币种) 合作伙伴账号针对观看事件赚取的广告客户币种纳米金额总和。此值可以为零
DBM 总媒体费用(美元) 观看事件的总媒体费用(以纳米美元为单位)。此值可以为零
DBM 总媒体费用(合作伙伴币种) 观看事件的总媒体费用(以合作伙伴币种纳米为单位)。 此值可以为零
DBM 总媒体费用(广告客户币种) 观看事件的总媒体费用(以广告客户币种纳米为单位)。此值可以为零
DBM CPM 费用 1(美元) 整数 CPM 1 费用(以纳元计,单位为美元)。此值可以为零
DBM CPM 费用 1(合作伙伴币种) CPM 1 费用(以合作伙伴币种 nano 为单位)。此值可以为零
DBM CPM 费用 1(广告客户币种) CPM 1 费用(以广告客户币种纳米为单位)。此值可以为零
DBM CPM 费用 2(美元) CPM 2 费用(以纳米美元为单位)。此值可以为零
DBM CPM 费用 2(合作伙伴币种) CPM 2 费用(以合作伙伴币种 nano 为单位)。此值可以为零
DBM CPM 费用 2(广告客户币种) CPM 2 费用(以广告客户币种纳米为单位)。此值可以为零
DBM CPM 费用 3(美元) CPM 3 费用(以纳米美元为单位)。此值可以为零
DBM CPM 费用 3(合作伙伴币种) CPM 3 费用(以合作伙伴币种 nano 为单位)。此值可以为零
DBM CPM 费用 3(广告客户币种) CPM 3 费用(以广告客户币种纳米为单位)。此值可以为零
DBM CPM 费用 4(美元) CPM 4 费用(以纳米美元为单位)。此值可以为零
DBM CPM 费用 4(合作伙伴币种) CPM 4 费用(以合作伙伴币种 nano 为单位)。此值可以为零
DBM CPM 费用 4(广告客户币种) CPM 4 费用(以广告客户币种纳米为单位)。此值可以为零
DBM CPM 费用 5(美元) CPM 5 费用(以纳米美元为单位)。此值可以为零
DBM CPM 费用 5(合作伙伴币种) CPM 5 费用(以合作伙伴币种 nano 为单位)。此值可以为零
DBM CPM 费用 5(广告客户币种) CPM 5 费用(以广告客户币种纳米为单位)。此值可以为零
DBM 媒体费用 1(美元) 媒体费用 1(以纳米美元为单位)。此值可以为零
DBM 媒体费用 1(合作伙伴币种) 媒体费用 1(以合作伙伴币种 nano 为单位)。此值可以为零
DBM 媒体费用 1(广告客户币种) 媒体费用 1(以广告客户币种 nano 为单位)。此值可以为零
DBM 媒体费用 2(美元) 媒体费用 2(以纳米为单位的美元)。此值可以为零
DBM 媒体费用 2(合作伙伴币种) 媒体费用 2(以合作伙伴币种 nano 为单位)。此值可以为零
DBM 媒体费用 2(广告客户币种) 媒体费用 2(以广告客户币种 nano 为单位)。此值可以为零
DBM 媒体费用 3(美元) 媒体费用 3(以纳米美元为单位)。此值可以为零
DBM 媒体费用 3(合作伙伴币种) 媒体费用 3(以合作伙伴币种 nano 为单位)。此值可以为零
DBM 媒体费用 3(广告客户币种) 媒体费用 3(以广告客户币种 nano 为单位)。此值可以为零
DBM 媒体费用 4(美元) 媒体费用 4(以纳米美元为单位)。此值可以为零
DBM 媒体费用 4(合作伙伴币种) 媒体费用 4(以合作伙伴币种 nano 为单位)。此值可以为零
DBM 媒体费用 4(广告客户币种) 媒体费用 4(以广告客户币种纳米为单位)。此值可以为零
DBM 媒体费用 5(美元) 媒体费用 5(以纳米美元为单位)。此值可以为零
DBM 媒体费用 5(合作伙伴币种) 媒体费用 5(合作伙伴币种纳米)。此值可以为零
DBM 媒体费用 5(广告客户币种) 媒体费用 5(以广告客户币种纳米为单位)。此值可以为零
DBM 数据费用(美元) 用于定位此展示的所有数据的费用(以纳米美元为单位)
DBM 数据费用(合作伙伴币种) 用于定位此展示的所有数据的费用(以合作伙伴货币纳米为单位)
DBM 数据费用(广告客户币种) 用于定位此展示的所有数据的费用(以广告客户币种纳米为单位)
DBM 可结算费用(美元) 向合作伙伴收取的总金额(包括媒体费用和合作伙伴费用),以纳米美元为单位
DBM 可结算费用(合作伙伴币种) 向合作伙伴收取的总金额(包括媒体费用和合作伙伴费用),以合作伙伴币种纳米为单位
DBM 可结算费用(广告客户币种) 向合作伙伴收取的总金额(包括媒体费用和合作伙伴费用),以广告客户币种纳米为单位
Google Click ID 字符串 随广告点击传递的代码,用于标识与广告相关联的广告系列,以便跟踪转化情况
Sa360 广告系列 ID Search Ads 360 广告系列的 ID
Sa360 广告组 ID Search Ads 360 关键字组的唯一 ID
Sa360 关键字 ID Search Ads 360 关键字的唯一 ID