从 DT v1.0 迁移

获取文件

DTv2 的提取流程与 DTv1 类似,但在迁移过程中,您需要更改一些关键事项。

处理文件

DTv2 会处理每小时文件(展示、点击和富媒体)和每日文件(活动和匹配表)。 每小时文件(文件名包含 YYYYMMDDHH)以世界协调时间 (UTC) 处理。系统会根据您当地的报告时区处理每日文件(文件名包含 YYYYMMDD)请参阅文件名格式。您当地时间与世界协调时间 (UTC) 之间的时差因您所在的位置而异。

文件也会单独处理,处理时间可能因文件而异。通常情况下,较晚小时的文件会比较早小时的文件(例如第 6 小时的文件比第 5 小时的文件)更早完成处理。 请勿依赖文件顺序来完成提取流程,否则您的流程可能会停滞。

相对于事件时间,事件可能会出现在较早或较晚处理的文件中。 事件不一定会在发生时所在的小时内处理。

列顺序

请勿依赖列顺序来使用文件。 我们希望您的处理流程能够适应变化;如果您请求添加额外的列,或者我们将来做出更改,那么报告中的列顺序和列数可能会发生变化。 在尝试写入数据之前,请先读取每个文件的标题行,并将其映射到数据仓库中的字段。

重复文件

有时,系统会针对同一日期和小时写入重复的文件。如果多个文件具有相同的日期/小时标记,请根据文件名时间戳使用分钟 / 秒数最新的文件。由于后端进程确定原始文件存在问题,因此创建了重复文件。

字段

字段名称和字段名称格式都发生了变化,但在“DCM 字段迁移”(包括匹配表)中,旧字段名称与新字段名称之间存在映射关系(如果适用)。 如果您不是 DBM 用户,这些字段将为空,您可以忽略这些字段。

您还可能会在文件中看到 DBM 字段。如果您是 DBM 用户,只有在 DBM 广告客户级别授予相关权限(广告客户已关联)时,这些字段才会填充。 如需了解旧字段与新字段之间的映射关系(如有),请参阅 DBM 字段迁移。DBM 实体读取文件仍将用于映射目的。

存储桶名称

DTv1 和 DTv2 的命名标准不同,具体来说,您无法通过更改现有存储分区名称的前缀来确定 DTv2 存储分区名称。设置账号时,支持代表会向您提供存储分区名称。

一般来说,DTv2 存储分区名称形如 gs://dcdt_-dcm_account1234

您可以在浏览器中查看存储分区的内容,方法是访问 https://cloud.google.com/console#/storage/browser/dcdt_-dcm_account1234

文件名格式

每个文件名都包含一个数字字符串,例如:
dcm_account1234_impression_2016022601_20160225_234912_218211994.csv.gz
2016022601 采用 YYYYMMDDHH 格式。相应文件中事件的 UTC 小时(小时编号为 0 到 23)。
20160225_234912 的格式为 YYYYMMDD_HHMMSS。这是报告的生成时间。
218211994 是文件 ID。

activity 文件

您每天会收到一个活动文件,文件名如下所示:
dcm_account1234_activity_20160727_20160728_035750_268669761.csv.gz
此文件包含 2016 年 7 月 27 日的数据,于 2016 年 7 月 28 日 3:57:50 生成。

点击“文件”

您每天会收到 24 个点击文件,文件名如下所示:
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
请注意文件名中日期字符串后面的世界协调时间 (UTC) 小时;小时数从 0 到 23,因此 17 表示相应文件中的事件发生在 17:00 到 17:59(24 小时制时间)或下午 5:00 到下午 6:00。
此文件包含 2016 年 7 月 27 日下午 5 点到 6 点的数据,生成时间为 2016 年 7 月 28 日 1:23:31。

展示文件

您每天会收到 24 个展示次数文件,文件名如下所示:
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
除了文件名之外,此文件与点击次数文件的行为方式相同。

匹配表文件

匹配表文件每天生成一次,文件名如下所示:
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
此文件包含 2016 年 7 月 27 日的数据,于 2016 年 7 月 28 日 3:22:26 生成。
注意:对于某些新的匹配表,数据是静态的,不会生成每日可下载的文件;您可以从参考页面(例如富媒体标准事件类型)获取这些文件的数据。

数据转移字段

1.0 版字段名称 DT v2.0 字段名称
时间 已弃用
User-ID 用户 ID
广告客户 ID 广告客户 ID
购买 ID 已弃用
订单 ID 广告系列 ID
广告 ID 广告 ID
广告素材 ID 呈现 ID
Creative-Version 广告素材版本
Creative-Size-ID 已弃用(从匹配表中检索为“广告素材像素尺寸”)
网站 ID 网站 ID (DCM)
Page-ID 展示位置 ID
关键字 已弃用
国家/地区 ID 国家/地区代码
州/省 州/省/自治区/直辖市
区号 已弃用
浏览器 ID 浏览器/平台 ID
浏览器版本 浏览器/平台版本
OS-ID 操作系统 ID
DMA-ID 特定媒体市场区域 (DMA) ID
城市 ID 城市 ID
Zip-Code 邮编
Time-UTC-Sec 已弃用
Local-User-ID 已弃用
Activity-Type 已弃用(从“activity_cats”匹配表中检索)
活动子类型 已弃用(从“activity_cats”匹配表中检索)
其他数据 其他数据
序数 ORD 值
点击时 互动时间
活动 ID 转化 ID
SV1 细分值 1
PartnerID1 合作伙伴 1 ID
PartnerID2 合作伙伴 2 ID
数量 总转化次数
收入 总收入

匹配表文件名

1.0 版文件名 2.0 文件名
activity_cat activity_cats
activity_type activity_types
ad ads
ad_page_assignments ad_placement_assignments
advertiser advertisers
browser browsers
campaign campaigns
cities cities
countries countries
creative creatives
creative_ad_assignments creative_ad_assignments
custom_creative_fields custom_creative_fields
dartsearch paid_search
designated_market_area designated_market_areas
keyval keyword_values
met_event rich_media_events
operating_system operating_systems
page placements
page_cost/page_flight_cost placement_cost
site sites
states states
user-defined_spot_vars custom_floodlight_variables

匹配表字段

activity_cats

1.0 版字段名称 2.0 版字段名称 类型
Spot-ID Floodlight Configuration 整数
Activity-Type-ID Activity Group ID 整数
Activity-Type Activity Type 字符串
Activity-ID Activity ID 整数
Activity Sub-Type Activity Sub-Type 字符串
Report-Name Activity 字符串
Tag-Method-ID Tag Counting Method ID 整数

activity_types

1.0 版字段名称 2.0 版字段名称 类型
Spot-ID Floodlight Configuration 整数
Activity-Group-ID Activity Group ID 整数
Activity-Type Activity Type 字符串
Report-Name Activity Group 字符串

ads

1.0 版字段名称 2.0 版字段名称 类型
Advertiser-ID Advertiser ID 整数
Buy-ID Campaign ID 整数
Ad-ID Ad ID 整数
Ad-Description Ad 字符串
Click-URL Ad Click URL 字符串
Ad-Type Ad Type 字符串
Creative-Size-ID Creative Pixel Size 字符串
Ad-Comments Ad Comments 字符串

ad_placement_assignments

1.0 版字段名称 2.0 版字段名称 类型
Ad-ID Ad ID 整数
Page-ID Placement ID 整数

广告客户

1.0 版字段名称 2.0 版字段名称 类型
Spot-ID Floodlight Configuration 整数
Advertiser-ID Advertiser ID 整数
Advertiser Advertiser 字符串
Advertiser-Group-ID Advertiser Group ID 整数
Advertiser-Group Advertiser Group 字符串

浏览器

1.0 版字段名称 2.0 版字段名称 类型
Browser-ID Browser/Platform ID 整数
Browser Browswer/Platform 字符串

广告系列

1.0 版字段名称 2.0 版字段名称 类型
Advertiser-ID Advertiser ID 整数

Order-ID (之前为 Buy-ID

Campaign ID 整数
Order(之前称为 Buy Campaign 字符串
Start-Date Campaign Start Date 日期
End-Date Campaign End Date 日期
Billing-Invoice-Code Billing Invoice Code 字符串

cities

1.0 版字段名称 2.0 版字段名称 类型
City-ID City ID 整数
City City 字符串
Creative-Library-Enabled Deprecated (now always 1) 整数

国家/地区

1.0 版字段名称 2.0 版字段名称 类型
Country-ID Deprecated 整数
Country Deprecated 字符串

creatives

1.0 版字段名称 2.0 版字段名称 类型
Advertiser-ID Advertiser ID 整数
Rendering-ID Rendering ID 整数
UI-Creative-ID 已弃用 整数
Creative Creative 字符串
Last-Modified-Date Creative Last Modified Date 日期
Creative-Type Creative Type 字符串
Creative-Sub-Type Deprecated 字符串
Creative-Size-ID Creative Pixel Size 字符串
Image-URL Creative Image URL 字符串
Creative-Version Creative Version integer

creative_ad_assignments

1.0 版字段名称 2.0 版字段名称 类型
Ad-ID Ad ID 整数
Creative-ID Creative ID 整数
Start-Date Creative Start Date 日期
End-Date Creative End Date 日期
Rotation-Type Creative Rotation Type 字符串
Creative-Group-1 Creative Groups 1 字符串
Creative-Group-2 Creative Groups 2 字符串
Click-URL Ad Click URL 字符串

custom_creative_fields

1.0 版字段名称 2.0 版字段名称 类型
Advertiser-ID Advertiser ID 整数
Creative-ID Creative ID 整数
Custom-Field-Number Creative Custom Field Number 整数
Custom-Field-Name Creative Custom Field Name 字符串
Custom-Field-Value Creative Custom Field Value 字符串

custom_rich_media

1.0 版字段名称 2.0 版字段名称 类型
Advertiser-ID Advertiser ID 整数
Met-Event-ID Rich Media Event ID 整数
Met-Event-Name Rich Media Event 字符串
Met-Event-Type-ID Rich Media Event Type ID 整数
Met-Event-Type-Name Rich Media Event Type 字符串

designated_market_areas

1.0 版字段名称 2.0 版字段名称 类型
DMA-ID Designated Market Area (DMA) ID 整数
DMA Designated Market Area 字符串

keyword_values

1.0 版字段名称 2.0 版字段名称 类型
Ad-ID Ad ID 整数
Keyword-Expression Keyword 字符串
1.0 版字段名称 2.0 版字段名称 类型
Ad-ID Ad ID 整数
Advertiser-ID Advertiser ID 整数
Buy-ID Campaign ID 整数
DS-Ad-ID Paid Search Ad ID 整数
Extended-Keyword-ID Paid Search Keyword ID 整数
Keyword-ID Paid Search Legacy Keyword ID 整数
DS-Campaign-Name Paid Search Campaign 字符串
KW-Ad-Group-Name Paid Search Ad Group 字符串
Bid-Strategy-Name Paid Search Bid Strategy 字符串
Landing-Page-URL Paid Search Landing Page URL 字符串
Keyword-Name Paid Search Keyword 字符串
Match-Type Paid Search Match Type 字符串

operating_systems

1.0 版字段名称 2.0 版字段名称 类型
OS-ID Operating System ID 整数
OS Operating System 字符串

展示位置

1.0 版字段名称 2.0 版字段名称 类型
Buy-ID Campaign ID 整数
Site-ID Site ID (DCM) 整数
Page-ID Placement ID 整数
Page Site keyname 字符串
Site-Placement Placement 字符串
Content-Category Content Category 字符串
Strategy Placement Strategy 字符串
Start-Date Placement Start Date 日期
End-Date Placement End Date 日期
Group-Type 展示位置组类型 字符串
Group-Parent-ID 打包/包版 ID 整数
Price-Type Placement Cost Structure 字符串
Cap-Cost Placement Cap Cost Option float
CPA-Activity-ID Activity ID 整数

placement_cost

1.0 版字段名称 2.0 版字段名称 类型
Page-ID Placement ID 整数
Effective-Date Placement Start Date 日期
End-Date Placement End Date 日期
Units Placement Total Booked Units 整数
Rate Placement Rate float
Comments Placement Comments 字符串

网站

1.0 版字段名称 2.0 版字段名称 类型
Site-ID Site ID (DCM) 整数
Site Site (DCM) 字符串
Directory-Site-ID Site ID (Site Directory) 整数
Directory-Site Site (Site Directory) 字符串

1.0 版字段名称 2.0 版字段名称 类型
State/Province State/Region 字符串
State/Province Name State/Region Full Name 字符串

custom_floodlight_variables

1.0 版字段名称 2.0 版字段名称 类型
Spot-ID Floodlight Configuration ID 整数
Variable-ID Floodlight Variable ID 字符串
Variable-Name Floodlight Variable Name 字符串