資料移轉 2.0 版:檔案格式

所有資料移轉檔案都會以逗號分隔值 (CSV) 儲存。由於資料移轉的可自訂性質,因此檔案可能不會包含以下所有欄位。

  • 檔案的第一列一律為包含資料欄名稱的標頭列。
  • 如果欄位含有特殊字元,則會在欄位內容前後加上半形引號。
  • 缺少的值會留空。
  • 資料列未排序。
  • Display & Video 360 欄位的對照表是採用實體讀取檔案格式。 進一步瞭解 Display & Video 360 對照表
  • 只有在廣告客戶之間已連結 DCM<> DBM 和相關權限時, DBM 欄位才會填入資料。 您必須為每個廣告客戶設定權限。您也可以授權夥伴預設啟用所有新的廣告客戶。 在 Display & Video 360 中,依序前往「廣告客戶」(或合作夥伴) >「基本詳細資料」>「Dcm 設定」> 啟用 在 DCM 資料移轉中加入 Display & Video 360 資料

檔案命名慣例

檔案名稱是由 DCM ID (例如帳戶或 Floodlight)、資料移轉類型 (曝光、點擊、活動或 Rich_media)、處理檔案的日期和小時 (YYYYMMDDHH)、報表產生日期 (YYYYMMDD)、報表產生時間 (HHMMSS) 和以底線分隔的報表執行 ID。

舉例來說,帳戶曝光檔案看起來可能像這樣: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 字串 用於彙整曝光、點擊和 Rich Media 及資料移轉檔案資料的專屬 ID
資產 ID 長整數 資產的專屬 ID。
Active View:符合資格的曝光 長整數 曝光是否符合可視度評估資格。曝光必須符合下列條件,才能評估曝光:(a) 廣告素材含有 Active View 代碼,以及 (b) 這個代碼在曝光時與 Google Marketing Platform 伺服器通訊成功。

詳情請參閱 Active View 說明
Active View:可評估曝光 長整數 曝光是否可透過 Active View 評估
Active View:可視曝光 長整數 曝光是否為可視
活動 ID 長整數 與轉換事件相關的 Floodlight 代碼 ID
事件時間 長整數 時間 (以世界標準時間 1970-01-01 00:00:00 為準)
事件類型 字串 包含事件相關詳細資料,這些是觀看和點擊事件的「觀看」和「點擊」,但轉換事件顯示為「轉換」或空白
事件子類型 字串 包含與事件相關的更多詳細資料,這些是觀看和點擊事件的「VIEW」和「CLICK」,但轉換事件可能是「POSTVIEW」、「POSTCLICK」或空白
使用者 ID 字串 追蹤 ID (其依據,但不會揭露使用者的瀏覽器 Cookie 或行動裝置 ID)。基於隱私權考量,這個欄位可能會留空。
廣告客戶 ID 長整數 廣告客戶的專屬 ID
廣告活動 ID 長整數 廣告活動的專屬 ID
Floodlight 設定 長整數 Floodlight 設定的專屬 ID
廣告 ID 長整數 廣告刊登位置的專屬 ID
顯示 ID 長整數 用於資料移轉的廣告素材專屬 ID。未對應至 UI-Creative-ID
廣告素材版本 整數 廣告素材版本號碼
網站 ID (DCM) 長整數 放送廣告的網站專屬 ID
刊登位置 ID 長整數 放送廣告的網站網頁 / 刊登位置專屬 ID
國家/地區代碼 字串字元(2) ISO 3166-1 國家/地區代碼 (2 個字母)
州/省/區域 字串 使用者所在的州或省 ID (美國/加拿大)
瀏覽器/平台 ID 長整數 瀏覽器類型的 ID
瀏覽器/平台版本 字串 瀏覽器版本
作業系統 ID 長整數 作業系統的 ID
指定行銷區域 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 以來,與活動相關聯的點擊或曝光時間 (以微秒為單位)
轉換 ID 整數 表示活動是否與點擊後 (值 1) 或曝光後 (值 2) 相符,或是不相符 (值為 0)
區隔價值 1 長整數 Search Ads 360 關鍵字 ID
互動式多媒體活動 ID 長整數 互動式多媒體廣告的 MET 事件編號。
互動式多媒體活動類型 ID 長整數 Rich Media 事件類型的 ID。如需比對說明,請參閱「對照表」一節。您必須自行建立對照表。
事件計時器 二壘安打 MET 計時器值 (etm= 值),以秒表示
事件計數器 長整數 MET 計數器值 (ecn= 值)
轉換總數 整數 可包含類型或類別的其他值,例如銷售數量。系統傳送時會使用「qty=」鍵/值
總收益 二壘安打 可包含類型或類別的其他值,例如以美元為單位的銷售金額。 您可以將 1,000,000 乘以 1,000,000,查看以金額表示。
合作夥伴 1 ID 字串 合作夥伴 1 加密值
合作夥伴 2 ID 字串 合作夥伴 2 加密值
DBM 資料檢視狀態 字串 將代碼包裝函式用於第三方驗證或放送時,查看狀態會指出 Display & Video 360 是否成功贏得曝光、廣告是否已放送到該廣告空間,以及 Campaign Manager 是否追蹤了該次曝光。「外部」值 表示 Display & Video 360 贏得了出價,並傳回包裝代碼,要在發布商網站上放送。「內部」值代表系統因廣告空間認定為品牌安全而放送的廣告。 如果這兩個事件都發生,系統就會提供兩筆曝光記錄。如果某筆曝光記錄含有「外部」值,且沒有包含「內部」的對應記錄,就表示第三方驗證服務在出價後封鎖了曝光。如果這個值為「3pas_merged」,表示 Campaign Manager 已成功追蹤 已包裝的 Display & Video 360 曝光。 如果這個值為「3pas_outer」,表示追蹤連線偵測 (ping) 已傳送至 Campaign Manager,但沒有回應。 但 Display & Video 360 仍會贏得出價,並要求從第三方廣告伺服器傳送廣告素材。
DBM 競價 ID 字串 用來彙整瀏覽/點擊/轉換類型之間的事件,例如「ABCDEFGH_abcdefgh-0123456789」。請勿為 transaction_id 值假設任何排序、結構或意義
DBM 請求時間 長整數 收到廣告請求時,以微秒為單位 (1/1,000,000 秒) 的 Unix 時間戳記,例如:example1330403779608570 代表 2012 年 2 月 28 日星期二 04:36:19.608570。雖然這個值在觀看、點擊和轉換中均保持一致,但不保證會獨一無二,請使用 transaction_id 彙整事件
DBM 廣告主 ID 長整數 與事件相關的廣告客戶 Display & Video 360 數字 ID,例如:164332
DBM 廣告訂單 ID 長整數 事件相關廣告訂單的 Display & Video 360 數字 ID,例如:1079941
DBM 委刊項 ID 長整數 事件相關委刊項的 Display & Video 360 數字 ID,例如:1155785
DBM 廣告活動 ID 長整數 Display & Video 360 廣告活動的專屬 ID
DBM 廣告素材 ID 長整數 事件相關廣告素材的 Display & Video 360 數字 ID,例如 367487
DBM 出價 (美元) 長整數 出價是指在採用最高價得標競價調整前,委刊項指派給曝光的值。對固定千次曝光出價委刊項來說,這是指委刊項在出價時的固定千次曝光出價。雖然出價是以千次曝光出價的形式傳送至廣告交易平台,但為了與其他指標保持一致,出價會以單次曝光費用表示。出價的單位是美元。如果除以 1,000,000,000,系統就會以美元顯示出價。
DBM 出價 (合作夥伴幣別) 長整數 出價是指在採用最高價得標競價調整前,委刊項指派給曝光的值。對固定千次曝光出價委刊項來說,這是指委刊項在出價時的固定千次曝光出價。雖然出價是以千次曝光出價的形式傳送至廣告交易平台,但為了與其他指標保持一致,出價會以單次曝光費用表示。出價的單位是合作夥伴幣別 (nanos)。只要將 1,000,000,000 除以,即可以合作夥伴的實際幣別查看出價價格。
DBM 出價 (廣告主所用幣別) 長整數 出價是指在採用最高價得標競價調整前,委刊項指派給曝光的值。對固定千次曝光出價委刊項來說,這是指委刊項在出價時的固定千次曝光出價。雖然出價是以千次曝光出價的形式傳送至廣告交易平台,但為了與其他指標保持一致,出價會以單次曝光費用表示。出價的單位是廣告客戶幣別 (十億分之一)。如果除以 1,000,000,000,即可以廣告客戶的實際幣別查看出價價格。
DBM 網址 字串 從廣告交易平台收到的出價要求中取得的原始網址,例如「http://www.example.com」。由於部分廣告交易平台會遮蓋出價要求中的網址,這個值可能會是「source_url_hidden」
DBM 網站 ID 長整數 Display & Video 360 數字 ID 代表與網址相符的最明確通用網站
DBM 語言 字串 ISO-639-1 代碼或「zh_CN」(簡體)、「zh_TW」(中文 (繁體)) 或「其他」,代表與觀看事件相關的語言
DBM AdX 網頁類別 字串 包含 Ad Exchange 網頁類別 ID,並以空格分隔,例如「65 189」。類別不能相互排斥
DBM 比對目標關鍵字 字串 以半形逗號分隔的字串,包含與瀏覽事件相關的網頁相符的指定關鍵字清單,例如「apple,orange,banana」。雖然與瀏覽事件相關的網頁可能會比對到多個關鍵字,但只有指定的目標關鍵字才會納入。如果關鍵字清單很大,我們可能限制傳回的關鍵字數量
DBM 廣告交易平台 ID 長整數 廣告請求廣告交易平台的 Display & Video 360 數字 ID
DBM 歸因廣告空間來源外部 ID 字串 歸因廣告空間來源的外部 ID。Display & Video 360 根據底價和競價類型,從與廣告客戶相關的觀看事件中選出最符合廣告客戶需求的來源廣告空間來源 ID
DBM 歸因廣告空間來源為公開 布林值 如果廣告空間來源可供所有買方使用,則為「是」。否則傳回 False
DBM 廣告排序 長整數 指定廣告在網頁上的位置 (如果已知)。1 代表不需捲動位置,2 代表需捲動位置
DBM 國家/地區代碼 字串 以 2 個英文字母表示的 ISO 3166-1 國家/地區代碼,用於指出曝光的最佳猜測國家/地區,例如「US」
DBM 指定行銷區域 (DMA) ID 長整數 指定市場區域代碼 (如果已知),例如 807
DBM 郵遞區號 字串 指出曝光中最適合猜測的郵遞區號區域 (如果已知),例如「98033」。請勿假設不同國家/地區的不重複性
DBM 州/省/區域 ID 長整數 與報表和指定目標中可用的州/地區整數相符的整數
DBM 城市 ID 長整數 Display & Video 360 數字 ID 用於識別曝光中最佳預測的城市
DBM 作業系統 ID 長整數 Display & Video 360 數字 ID 用於識別與此事件相關的作業系統
DBM 瀏覽器/平台 ID 長整數 Display & Video 360 數字 ID 用於識別與這個事件相關的瀏覽器
DBM 瀏覽器時區偏移 (分鐘) 長整數 使用者瀏覽器使用時區與 GMT-12 時區之間的時差 (分鐘)。舉例來說,1320 表示瀏覽器時區為 GMT+10
DBM 網路速度 長整數 Display & Video 360 數字 ID,代表與觀看事件相關的網路速度。
1=撥接網路
2=EDGE/2G
3=UMTS/3G
4=基本 DSL
5=HSDPA/3.5G
6=Broadband/4G
7=不明
DBM 比對指定區隔 字串 符合訪客的指定使用者名單名稱,並以空格分隔,例如「-4 456」。如果訪客所屬的使用者名單不是與此事件相關聯的廣告指定目標,就不會納入到這裡
DBM 網際網路服務供應商 (ISP) ID 長整數 Display & Video 360 數字 ID,最適合曝光的網際網路服務供應商。可能缺少這個值
DBM 裝置類型 長整數 所識別裝置類型的數值。0 = COMPUTER, 1 = 其他,2 = SMARTPHONE,3 = 平板電腦,4 = SMARTTV,5 = CONNECTEDTV
DBM 行動裝置廠商 ID 長整數 行動裝置品牌的數字 ID。可能缺少這個值
DBM 行動裝置模型 ID 長整數 行動裝置型號的數字 ID。可能缺少這個值
DBM 媒體費用 (美元) 長整數 針對曝光支付的金額 (以美元為單位),您可以將 1,000,000,000 除以 1,000,000,000,即可視為貨幣。這個值可以是零
DBM 媒體費用 (合作夥伴幣別) 長整數 針對曝光支付的金額,以合作夥伴幣別表示,只要將金額除以 1,000,000,000,即可視為幣別。這個值可以是零
DBM 媒體費用 (廣告主所用幣別) 長整數 針對曝光支付的金額,以廣告客戶幣別表示,只要將金額除以 1,000,000,000,即可看見幣別。這個值可以是零
DBM 收益 (美元) 長整數 合作夥伴帳戶針對觀看事件所賺取的美元總額,以美元為單位。這個值可以是零
DBM 收益 (合作夥伴幣別) 長整數 合作夥伴帳戶針對觀看事件所產生,以合作夥伴幣別表示的總金額 (以奈秒為單位)。這個值可以是零
DBM 收益 (廣告主所用幣別) 長整數 觀看事件由合作夥伴帳戶產生的廣告客戶幣別 (十億分之一) 總金額。這個值可以是零
DBM 媒體總費用 (美元) 長整數 觀看事件的媒體費用總額,以奈秒為單位。這個值可以是零
DBM 媒體總費用 (合作夥伴幣別) 長整數 觀看事件的媒體費用總額,以合作夥伴幣別奈秒表示。這個值可以是零
DBM 媒體總費用 (廣告主所用幣別) 長整數 觀看事件的媒體費用總額,以廣告客戶幣別表示 (奈秒)。這個值可以是零
DBM 千次曝光出價費用 1 (美元) 整數 千次曝光出價 1 費用,以美元為單位。這個值可以是零
DBM 千次曝光出價費用 1 (合作夥伴幣別) 長整數 千次曝光出價 1 費用,以合作夥伴幣別 (nanos) 為單位。這個值可以是零
DBM 千次曝光出價費用 1 (廣告主所用幣別) 長整數 千次曝光出價 1 費用,以廣告客戶幣別表示。這個值可以是零
DBM 千次曝光出價費用 2 (美元) 長整數 千次曝光出價 2 費用,以美元為單位。這個值可以是零
DBM 千次曝光出價費用 2 (合作夥伴幣別) 長整數 千次曝光出價 2 費用,以合作夥伴幣別 (nanos) 為單位。這個值可以是零
DBM 千次曝光出價費用 2 (廣告主所用幣別) 長整數 千次曝光出價 2 費用,以廣告客戶幣別表示。這個值可以是零
DBM 千次曝光出價費用 3 (美元) 長整數 千次曝光出價 3 費用,以美元為單位。這個值可以是零
DBM 千次曝光出價費用 3 (合作夥伴幣別) 長整數 千次曝光出價 3 費用,以合作夥伴幣別 (nanos) 為單位。這個值可以是零
DBM 千次曝光出價費用 3 (廣告主所用幣別) 長整數 千次曝光出價 3 費用,以廣告客戶幣別表示。這個值可以是零
DBM 千次曝光出價費用 4 (美元) 長整數 千次曝光出價 4 費用,以美元為單位。這個值可以是零
DBM 千次曝光出價費用 4 (合作夥伴幣別) 長整數 千次曝光出價 4 費用,以合作夥伴幣別 (nanos) 為單位。這個值可以是零
DBM 千次曝光出價費用 4 (廣告主所用幣別) 長整數 千次曝光出價 4 費用,以廣告客戶幣別表示。這個值可以是零
DBM 千次曝光出價費用 5 (美元) 長整數 千次曝光出價 5 費用,以美元為單位。這個值可以是零
DBM 千次曝光出價費用 5 (合作夥伴幣別) 長整數 千次曝光出價 5 費用,以合作夥伴幣別表示。這個值可以是零
DBM 千次曝光出價費用 5 (廣告主所用幣別) 長整數 千次曝光出價 5 費用,以廣告客戶幣別表示。這個值可以是零
DBM 媒體費用 1 (美元) 長整數 媒體費用 1 (以美元為單位)。這個值可以是零
DBM 媒體費用 1 (合作夥伴幣別) 長整數 以合作夥伴幣別表示的媒體費用 1 (奈米)。這個值可以是零
DBM 媒體費用 1 (廣告主所用幣別) 長整數 廣告客戶幣別的媒體費用 1 (以十億分之一為單位)。這個值可以是零
DBM 媒體費用 2 (美元) 長整數 媒體費用 2 (以美元為單位)。這個值可以是零
DBM 媒體費用 2 (合作夥伴幣別) 長整數 夥伴幣別 2 的媒體費用 2 (奈秒)。這個值可以是零
DBM 媒體費用 2 (廣告主所用幣別) 長整數 廣告客戶幣別的媒體費用 2。這個值可以是零
DBM 媒體費用 3 (美元) 長整數 媒體費用 3 (以美元為單位)。這個值可以是零
DBM 媒體費用 3 (合作夥伴幣別) 長整數 夥伴幣別 3 的媒體費用 3 (奈米)。這個值可以是零
DBM 媒體費用 3 (廣告主所用幣別) 長整數 廣告客戶幣別的媒體費用 3。這個值可以是零
DBM 媒體費用 4 (美元) 長整數 媒體費用 4 (以美元為單位)。這個值可以是零
DBM 媒體費用 4 (合作夥伴幣別) 長整數 夥伴幣別 4 的媒體費用 4 (奈米)。這個值可以是零
DBM 媒體費用 4 (廣告主所用幣別) 長整數 廣告客戶幣別的媒體費用 4 (十億分之一)。這個值可以是零
DBM 媒體費用 5 (美元) 長整數 媒體費用 5 (以美元為單位)。這個值可以是零
DBM 媒體費用 5 (合作夥伴幣別) 長整數 夥伴幣別 5 的媒體費用 5 (奈秒)。這個值可以是零
DBM 媒體費用 5 (廣告主所用幣別) 長整數 廣告客戶幣別的媒體費用 5。這個值可以是零
DBM 資料費用 (美元) 長整數 用於指定這次曝光的任何資料費用,以美元為單位
DBM 資料費用 (合作夥伴幣別) 長整數 用於指定這次曝光的任何資料費用,以合作夥伴幣別表示
DBM 資料費用 (廣告主所用幣別) 長整數 用於指定這次曝光的任何資料費用,以廣告客戶幣別表示
DBM 可計費成本 (美元) 長整數 支付給合作夥伴的總金額 (包括媒體費用和合作夥伴費用,以美元為單位)
DBM 可計費成本 (合作夥伴幣別) 長整數 支付給合作夥伴的總金額,包括媒體費用和合作夥伴費用 (以合作夥伴幣別表示)
DBM 可計費成本 (廣告主所用幣別) 長整數 支付給合作夥伴的總金額,包括媒體費用和夥伴費用 (以廣告客戶幣別表示)
Google Click ID 字串 與廣告點擊傳遞的代碼,用於識別與廣告相關聯的廣告活動,以便進行廣告追蹤