從 DT v1.0 遷移

取得 Files

DTv2 的擷取程序與 DTV1 類似,但遷移時需要變更一些重要事項。

處理檔案

DTv2 會處理每小時檔案 (曝光、點擊和互動式多媒體) 和每日檔案 (活動和比對表格)。系統會以世界標準時間 (UTC) 處理每小時的檔案 (檔案名稱包含 YYYYMMDDHH)。系統會以當地報表時間處理每日檔案 (檔案名稱包含 YYYYMMDD) 請參閱檔案名稱格式。當地時間與世界標準時間的時差會因所在位置而異。

檔案也會獨立處理,處理時間可能有所不同。較晚的小時檔案通常會比較早的小時檔案先完成處理 (例如第 6 小時的檔案比第 5 小時的檔案先完成)。請勿依賴檔案順序進行擷取程序,否則程序可能會停滯。

相較於事件時間,事件可能會出現在較早或較晚處理的檔案中。 系統不一定會在事件發生的當下處理事件。

資料欄順序

請勿依賴欄順序來使用檔案。我們希望您的處理程序能因應變化;如果您要求額外資料欄,或我們日後進行變更,報表中的資料欄順序和數量可能會變動。請先讀取每個檔案的標頭列,並對應至資料倉儲中的欄位,再嘗試寫入資料。

重複檔案

有時同一天和同一小時的檔案會重複寫入。如果有多個檔案具有相同的日期/小時戳記,請根據檔案名稱時間戳記,使用分鐘 / 秒數最新的檔案。由於後端程序判斷原始檔案有問題,因此建立重複檔案。

欄位

欄位名稱和格式都已變更,但 DCM 欄位遷移 (包括比對資料表) 提供新舊欄位的對應 (如有)。如果您不是 DBM 使用者,這些欄位會是空白,您可以忽略。

檔案中也可能會顯示 DBM 欄位。如果您是 DBM 使用者,只有在廣告主層級授予相關權限 (廣告主已連結) 時,系統才會填入這些欄位。如要查看新舊欄位的對應關係 (如有),請參閱「DBM 欄位遷移」一文。DBM 實體讀取檔案仍會用於對應。

bucket 名稱

DTv1 和 DTv2 的命名標準不同,具體來說,您無法變更現有 bucket 名稱的前置字元,來找出 DTv2 bucket 名稱。設定帳戶時,支援代表會提供值區名稱。

一般而言,DTv2 值區名稱類似 gs://dcdt_-dcm_account1234

如要在瀏覽器中查看 bucket 內容,請前往 https://cloud.google.com/console#/storage/browser/dcdt_-dcm_account1234

檔案名稱格式

每個檔案名稱都會有一串數字,例如:
dcm_account1234_impression_2016022601_20160225_234912_218211994.csv.gz
2016022601 的格式為 YYYYMMDDHH。這是該檔案中事件的世界標準時間 (小時以 0 到 23 編號)。
20160225_234912 的格式為 YYYYMMDD_HHMMSS。這是產生報表的時間。
218211994 是檔案 ID。

活動檔案

每天會產生一個活動記錄檔案,檔名如下:
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」比對表擷取)
Other-Data 其他資料
序數 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 字串

城市

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 字串

廣告素材

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 浮點數
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 浮點數
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 字串