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