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

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

  • 文件的第一行始终是标题行,其中包含 列名称。
  • 对于包含特殊字符的字段,此字段的内容 用引号括起来。
  • 缺失值留空。
  • 行未排序。
  • 适用于展示广告和Video 360 字段采用实体读取文件格式。 <ph type="x-smartling-placeholder"></ph> 详细了解展示广告和Video 360 匹配表
  • 仅当广告客户在 DCM<>DBM 之间建立关联且已授予权限时,系统才会填充 DBM 字段。 您必须为每个广告客户授予权限。此外,您还可以授权合作伙伴在默认情况下启用每个新广告客户。 展示广告和Video 360,转到:广告客户(或合作伙伴)>基本详情 >DCM 配置 >然后启用 包括展示广告和DCM 数据传输中的 Video 360 数据

价格文件

仅适用于欧洲经济区内的广告客户。前往帮助中心了解详情: <ph type="x-smartling-placeholder"></ph> 详细了解价格透明度报告

文件命名惯例

文件名是 DCM ID(例如账号或 Floodlight)、数据传输类型的组合 (展示、点击、活动或富媒体)、已处理文件的日期和时间 (YYYYMMDDHH); 报表的生成日期 (YYYYMMDD)、报表的生成时间 (HHMMSS) 以及 报告(用下划线分隔)。

例如,账号展示次数文件可能如下所示: 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) 该代码成功与 Active View 代码进行通信 Google Marketing Platform 服务器。

请参阅 Active View 帮助 了解详情
Active View:可衡量展示次数 相应展示是否可通过 Active View 衡量
Active View:可见展示次数 相应展示是否可见
活动 ID 与转化事件相关的 Floodlight 代码的 ID
事件时间 自 1970-01-01 00:00:00 世界协调时间 (UTC) 开始的时间(以微秒为单位)
事件类型 字符串 包含与活动相关的详细信息 - 这些是“查看”和 “CLICK”(针对观看事件和点击事件),但也可能是“CONVERSION”或 留空表示转化事件
事件子类型 字符串 包含与活动相关的更多详细信息 - 这些是“查看” 和“CLICK”但也可能是“POSTVIEW”“POSTCLICK” 或留空(表示转化事件)
用户 ID 字符串 跟踪 ID(基于用户的浏览器 Cookie,但不会公开该 Cookie) 或移动设备 ID)。出于隐私保护方面的原因,此字段可能为零。
广告客户 ID 广告客户的唯一 ID
广告系列 ID 广告系列的唯一 ID
Floodlight 配置 Floodlight 配置的唯一 ID
广告 ID 广告展示位置的唯一 ID
呈现 ID 广告素材的唯一 ID,用于数据传输。与 用户界面广告素材 ID
广告素材版本 整数 广告素材版本号
网站 ID (DCM) 投放广告的网站的唯一 ID
展示位置 ID 投放广告的网页 / 展示位置的唯一 ID
国家/地区代码 字符串字符(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=”传递键值(也用于存储客户端的 销售代码中的 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=”键值对
总收入 双精度 可以包含类型或类别的其他值,例如以百万美元为单位的销售金额。 您可以将其乘以 1,000,000,以查看其为美元金额。
Partner1 ID 字符串 Partner1 加密值
Partner2 ID 字符串 Partner2 加密值
DBM 数据视图状态 字符串 当代码封装容器用于第三方验证或投放时,视图状态会指明视频 360 如果广告已投放到相应广告资源,以及 Campaign Manager 是否跟踪了该展示,就成功赢得了展示机会。“outer”的值 指“展示广告”和Video 360 赢得出价,并返回了要在发布商网站上投放的封装后代码。 “内部”值是指由于广告资源被认为具有品牌保障能力而投放的广告。 同时发生这两个事件时,将有两条展示记录。单个展示记录 具有“外部”值,而没有包含“内部”的相应记录,则意味着第三方 验证服务在出价后屏蔽了展示机会。值“3pas_merged”意味着 是封装后的展示广告,Campaign Manager 成功跟踪的 Video 360 展示次数。 值“3pas_outer”表示已向 Campaign Manager 发送了跟踪 ping,但无响应。 不过,展示广告和Video 360 仍然胜出,并请求第三方广告服务器发送广告素材。
DBM 竞价 ID 字符串 用于联接浏览/点击/转化类型之间的事件的字符串, 例如“ABCDEFGH_abcdefgh-0123456789”。不要假定任何顺序 对 Auction_id 值指定结构或含义
DBM 请求时间 以微秒(1/1,000,000 秒)为单位的 Unix 时间戳,表示 收到了广告请求,例如 1330403779608570 表示星期二 2012 年 2 月 28 日 04:36:19.608570。尽管此值 跨浏览、点击和转化,即使这并不能保证 唯一 - 请使用广告竞价 ID 来加入事件
DBM 广告客户 ID 展示广告与广告客户相关联系人的 Video 360 数字 ID 事件,例如 164332
DBM 广告订单 ID 展示广告与广告订单的 Video 360 数字 ID 与事件相关,例如 1079941
DBM 订单项 ID 展示广告与相关订单项的 Video 360 数字 ID 事件,例如 1155785
DBM 广告系列 ID 展示广告的唯一 ID 和Video 360 广告系列
DBM 广告素材 ID 展示广告与相关广告素材的 Video 360 数字 ID 事件,例如 367487
DBM 出价(美元) 出价是订单项为展示机会指定的价值 调整预算金额。对于采用固定每千次展示费用的订单项, 是订单项出价时的固定每千次展示费用。虽然出价 作为 CPM 值发送到广告交易平台,则出价将表示为 展示机会价值,以便与其他指标保持一致。出价现在处于 美元(以十亿分之一计)。您可以除以 1,000,000,000 以查看以美元为单位的出价。注意: 出价不适用于 YouTube 订单项。
DBM 出价(合作伙伴币种) 出价是订单项为展示机会指定的价值 调整预算金额。对于采用固定每千次展示费用的订单项, 是订单项出价时的固定每千次展示费用。虽然出价 作为 CPM 值发送到广告交易平台,则出价将表示为 展示机会价值,以便与其他指标保持一致。出价现在处于 合作伙伴币种(以十亿分之一计)。您可以除以 1,000,000,000 以查看出价 (以实际合作伙伴币种计算)。注意:出价不适用于 YouTube 订单项。
DBM 出价(广告客户币种) 出价是订单项为展示机会指定的价值 调整预算。对于采用固定每千次展示费用的订单项, 是订单项出价时的固定每千次展示费用。虽然出价 作为 CPM 值发送到广告交易平台,则出价将表示为 展示机会价值,以便与其他指标保持一致。出价现在处于 广告客户币种(以十亿分之一计)。您可以除以 1,000,000,000 以查看出价 以实际广告客户币种显示价格。注意:出价不适用于 YouTube 订单项。
DBM 网址 字符串 从广告交易平台收到的出价请求中获取的原始网址; 例如“http://www.example.com”。由于有些广告交易平台会将网址 此值可以为“source_url_hidden”
DBM 网站 ID 展示广告与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 展示广告与广告交易平台, 请求广告
DBM 促成转化的广告资源来源外部 ID 字符串 归因于指定广告资源来源的广告资源来源的外部 ID 展示广告和从可供客户访问的 根据底价和竞价类型与观看事件相关的广告客户
DBM 促成转化的广告资源来源是否公开 布尔值 如果广告资源来源可供所有买方使用,则为“true”。错误 否则
DBM 广告位置 指定广告在网页上的位置(如果已知)。1 表示 首屏,2 代表非首屏
DBM 国家/地区代码 字符串 用 2 个字母表示的 ISO 3166-1 国家/地区代码,用来标识最佳猜测国家/地区 展示次数,例如“US”
DBM 特定媒体市场区域 (DMA) ID 特定媒体市场区号(如果已知),例如 807
DBM 邮政编码 字符串 用于标识最佳猜测邮政区域的邮政编码 展示次数(如果已知),例如“98033”。不要假定 其他国家/地区
DBM 州/省/区域 ID 与报告和报告中可用的州/区域整数匹配的整数 定位条件
DBM 城市 ID 展示广告与用于识别最佳猜测的视频 360 数字 ID 展示所在的城市
DBM 操作系统 ID 展示广告与用于标识经营业务的视频 360 数字 ID 与此事件相关的系统
DBM 浏览器/平台 ID 展示广告与用于识别浏览器的 Video 360 数字 ID 与此活动相关
DBM 浏览器时区偏差(分钟) 用户所在时区的有效时区之间的时差(以分钟为单位) 和 GMT-12,例如 1320 表示浏览器时区 格林尼治标准时间 +10
DBM 网络速度 展示广告与表示广告资源网的 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 展示广告与用于最佳猜测的视频 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 字符串 随广告点击一起传递的代码,用于标识与广告相关联的广告系列,以便进行广告跟踪