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

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

  • 文件的第一行始终是包含列名称的标题行。
  • 对于包含特殊字符的字段,字段的内容会用引号括起来。
  • 缺失值留空。
  • 系统不会对行进行排序。
  • Display & Video 360 字段的匹配表采用实体读取文件格式。 详细了解 Display & Video 360 匹配表
  • 仅当广告客户在 DCM<>DBM 之间关联并获得了相关权限时,系统才会填充 DBM 字段。 必须为每个广告客户授予权限。您还可以授权合作伙伴默认启用所有新广告客户。 在 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 字符串 用于联接展示次数、点击次数和富媒体、数据传输文件数据的唯一 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”或留空
User-ID 字符串 跟踪 ID(基于用户的浏览器 Cookie 或移动设备 ID,但不会公开)。出于隐私保护方面的原因,此字段可能会为零。
广告客户 ID 广告客户的唯一 ID
广告系列 ID 广告系列的唯一 ID
Floodlight 配置 Floodlight 配置的唯一 ID
广告 ID 广告展示位置的唯一 ID
呈现 ID 用于数据传输的广告素材的唯一 ID。不对应于 UI-Creative-ID
广告素材版本 整数 广告素材版本号
网站 ID (DCM) 广告投放网站的唯一 ID
展示位置 ID 广告投放的网站网页 / 展示位置的唯一 ID
国家/地区代码 字符串字符(2) 2 个字母的 ISO 3166-1 国家/地区代码
州/省/自治区/直辖市 字符串 用户所在州或省/自治区/直辖市(美国/加拿大)的 ID
浏览器/平台 ID 浏览器类型的 ID
浏览器/平台版本 字符串 浏览器版本
操作系统 ID 操作系统 ID
特定媒体市场区域 (DMA) ID 特定媒体市场区域 ID(美国/加拿大)
城市 ID 城市 ID
邮编 字符串 邮政编码(美国/加拿大)
其他数据 字符串 存储未以其他方式标记的 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 富媒体广告的 MET 事件 ID。
富媒体事件类型 ID 富媒体事件类型的 ID。有关匹配说明,请参阅匹配表部分。您需要创建自己的匹配表。
事件计时器 双精度 MET 计时器值(etm= 值),以秒为单位
事件计数器 MET 计数器值(ecn= 值)
总转化次数 整数 可以包含类型或类别的其他值,例如销售量。使用“qty=”键值对传递
总收入 双精度 可以包含类型或类别的其他值,例如以美元 (USD) 为单位的销售金额。 您可以将它乘以 1,000,000 以将其显示为美元金额。
Partner1 ID 字符串 Partner1 加密值
Partner2 ID 字符串 Partner2 加密值
DBM 数据视图状态 字符串 当使用代码封装容器进行第三方验证或投放时,查看状态会指明 Display & Video 360 是否成功赢得展示机会、是否向相应广告资源投放了广告,以及 Campaign Manager 是否跟踪了此次展示。“外部”的值表示 Display & Video 360 赢得出价并返回封装后的代码,以便在发布商网站上投放。 “内部”值表示广告因该广告资源被视为具有品牌保障能力而投放。 如果两个事件都发生,系统会创建两条展示记录。如果一条展示记录包含“外部”值,而没有对应的记录包含“内部”值,则表示第三方验证服务在出价后屏蔽了相应展示。“3pas_merged”一值表示 Campaign Manager 成功跟踪了一次已封装的 Display & Video 360 展示。 “3pas_outer”一值表示向 Campaign Manager 发送了跟踪 ping,但没有响应。 不过,Display & Video 360 仍会赢得出价,并已请求从第三方广告服务器发送广告素材。
DBM 竞价 ID 字符串 用于联接观看/点击/转化类型之间的事件的字符串,例如“ABCDEFGH_abcdefgh-0123456789”。不要对 delivery_id 值做出任何排序、结构或含义
DBM 请求时间 收到广告请求时的 Unix 时间戳(以微秒为单位,1/1000000 秒),例如 1330403779608570 表示 2012 年 2 月 28 日星期二 04:36:19.608570。尽管此值在整个视图中保持一致,但点击和转化(即使不一定是唯一的值)也不一定是唯一的 - 请使用拍卖 ID 加入事件
Display & Video 360 广告客户 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 除以 1,000,000,000,以查看以美元为单位的出价。
DBM 出价(合作伙伴币种) 出价是订单项在调整最高出价竞价之前为展示机会指定的价值。对于采用固定 CPM 订单项,这是指在出价时该订单项的固定 CPM。虽然出价以 CPM 值的形式发送到广告交易平台,但为了与其他指标保持一致,出价以每次展示价值的形式表示。出价以合作伙伴币种纳米为单位。您可以除以 1,000,000,000,以查看采用实际合作伙伴币种的出价。
DBM 出价(广告客户币种) 出价是订单项在调整最高出价竞价之前为展示机会指定的价值。对于采用固定 CPM 订单项,这是指在出价时该订单项的固定 CPM。虽然出价以 CPM 值的形式发送到广告交易平台,但为了与其他指标保持一致,出价以每次展示价值的形式表示。出价以广告客户币种纳米为单位。您可以除以 1,000,000,000,得到以广告客户实际币种表示的出价。
DBM 网址 字符串 从广告交易平台收到的出价请求中获取的原始网址,例如“http://www.example.com”。由于某些广告交易平台会在其出价请求中遮盖网址,因此该值可能为“source_url_hidden”
DBM 网站 ID 与网址匹配的最具体通用网站的 Display & Video 360 数字 ID
DBM 语言 字符串 ISO-639-1 代码,或者“zh_CN”(简体中文)、“zh_TW”(繁体中文)或“其他”,表示与观看事件相关的语言
DBM AdX 网页类别 字符串 包含以空格分隔的 Ad Exchange 页面类别 ID,例如“65 189”。这些类别不能互斥
DBM 匹配的目标关键字 字符串 以英文逗号分隔的字符串,包含与查看事件相关的网页相匹配的指定关键字列表,例如“apple,orange,banana”。尽管与查看事件相关的网页可能与许多关键字匹配,但系统只会纳入已定位的关键字;如果关键字列表很庞大,我们可能会对返回的关键字数量施加限制
DBM 交易 ID 请求广告的广告交易平台的 Display & Video 360 数字 ID
DBM 促成转化的广告资源来源外部 ID 字符串 Display & Video 360 根据底价和竞价类型从广告客户可访问的与观看事件相关的网址中选择最匹配的归因广告资源来源的外部 ID
DBM 促成转化的广告资源来源是否公开 布尔值 如果广告资源来源可供所有买方使用,则为“true”。否则为 false
DBM 广告位置 指定广告在网页上的位置(如果已知)。1 表示首屏,2 表示非首屏
DBM 国家/地区代码 字符串 由 2 个字母组成的 ISO 3166-1 国家/地区代码,用于标识对展示机会的最佳猜测国家/地区,例如“US”
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 = 计算机,1 = 其他,2 = 智能手机,3 = 平板电脑,4 = 智能电视,5 = 联网电视
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 费用(以合作伙伴币种纳米为单位)。此值可以为零
DBM CPM 费用 1(广告客户币种) CPM 1 费用(广告客户币种为纳米)。此值可以为零
DBM CPM 费用 2(美元) CPM 2 费用(以美元纳秒为单位)。此值可以为零
DBM CPM 费用 2(合作伙伴币种) CPM 2 费用(以合作伙伴币种纳米为单位)。此值可以为零
DBM CPM 费用 2(广告客户币种) CPM 2 费用(广告客户币种为纳米)。此值可以为零
DBM CPM 费用 3(美元) CPM 3 费用(以美元纳米为单位)。此值可以为零
DBM CPM 费用 3(合作伙伴币种) CPM 3 费用(以合作伙伴币种纳米为单位)。此值可以为零
DBM CPM 费用 3(广告客户币种) CPM 3 费用(广告客户币种为纳米)。此值可以为零
DBM CPM 费用 4(美元) CPM 4 费用(以美元纳米为单位)。此值可以为零
DBM CPM 费用 4(合作伙伴币种) CPM 4 费用(以合作伙伴币种纳米为单位)。此值可以为零
DBM CPM 费用 4(广告客户币种) CPM 4 费用(广告客户币种为纳米)。此值可以为零
DBM CPM 费用 5(美元) CPM 5 费用(以美元纳米为单位)。此值可以为零
DBM CPM 费用 5(合作伙伴币种) CPM 5 费用(以合作伙伴币种纳秒表示)。此值可以为零
DBM CPM 费用 5(广告客户币种) CPM 5 费用(广告客户币种为纳米)。此值可以为零
DBM 媒体费用 1(美元) 媒体费用 1(美元纳秒)。此值可以为零
DBM 媒体费用 1(合作伙伴币种) 媒体费用 1(合作伙伴币种为纳米)。此值可以为零
DBM 媒体费用 1(广告客户币种) 媒体费用 1(广告客户币种为纳米)。此值可以为零
DBM 媒体费用 2(美元) 媒体费用 2(美元纳秒)。此值可以为零
DBM 媒体费用 2(合作伙伴币种) 媒体费用 2(合作伙伴币种为纳米)。此值可以为零
DBM 媒体费用 2(广告客户币种) 媒体费用 2(广告客户币种为纳米)。此值可以为零
DBM 媒体费用 3(美元) 媒体费用 3(美元纳秒)。此值可以为零
DBM 媒体费用 3(合作伙伴币种) 媒体费用 3(合作伙伴币种为纳米)。此值可以为零
DBM 媒体费用 3(广告客户币种) 媒体费用 3(广告客户币种为纳米)。此值可以为零
DBM 媒体费用 4(美元) 媒体费用 4(美元纳秒)。此值可以为零
DBM 媒体费用 4(合作伙伴币种) 媒体费用 4(合作伙伴币种为纳米)。此值可以为零
DBM 媒体费用 4(广告客户币种) 媒体费用 4(广告客户币种为纳米)。此值可以为零
DBM 媒体费用 5(美元) 媒体费用 5(美元纳秒)。此值可以为零
DBM 媒体费用 5(合作伙伴币种) 媒体费用 5(合作伙伴币种,以十亿分之一计)。此值可以为零
DBM 媒体费用 5(广告客户币种) 媒体费用 5(广告客户币种为纳米)。此值可以为零
DBM 数据费用(美元) 用于定位此展示的所有数据的费用,以美元纳米为单位
DBM 数据费用(合作伙伴币种) 用于定位此展示的所有数据的费用(以合作伙伴币种纳米)
DBM 数据费用(广告客户币种) 用于定位此展示的所有数据的费用,以广告客户币种纳米为单位
DBM 可结算费用(美元) 向合作伙伴收取的总金额,包括媒体费用和合作伙伴费用,以美元纳秒为单位
DBM 可结算费用(合作伙伴币种) 向合作伙伴收取的总金额,包括媒体费用和合作伙伴费用,以合作伙伴币种纳米为单位
DBM 可结算费用(广告客户币种) 向合作伙伴收取的总金额,包括媒体费用和合作伙伴费用,以广告客户币种纳米为单位
Google Click ID 字符串 与广告点击一起传递的代码,用于标识与广告相关联的广告系列以进行广告跟踪