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

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

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

价格文件

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

文件命名惯例

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