获取文件
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 |
字符串 |
| 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 |
字符串 |
paid_search
| 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 |
字符串 |