Bid Manager API 1.1 版已淘汰。而針對停用版本的要求可能會傳回錯誤或資料不完整

您必須使用 Bid Manager API v2。請參閱遷移指南,瞭解從 1.1 版遷移至第 2 版的步驟。

資料移轉 2.0 版:檔案格式

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

  • 檔案的第一列一律是包含資料欄名稱的標題列。
  • 針對包含特殊字元的欄位,欄位內容會以引號括住。
  • 未留空。
  • 資料列不會排序。
  • Display &Video 360 欄位的對照表是實體讀取檔案格式。進一步瞭解 Display &Video 360 對照表
欄位 類型 曝光 點擊 活動 互動式多媒體 說明
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 UTC 起,以微秒為單位
事件類型 字串 包含事件相關詳細資料,例如「VIEW」和「click」;用於檢視和點擊事件,但轉換事件可以是「CONVERSION」或「空白」
事件子類型 字串 包含事件的其他詳細資料;這些檢視畫面為「VIEW」和「CLICK」,用於觀看和點擊事件,但轉換事件可以是「POSTVIEW」、「POSTCLICK」或空白
User-ID 字串 追蹤 ID (以 ID 為依據,但不會顯示使用者的瀏覽器 Cookie 或行動裝置 ID)。為了維護隱私權,這個欄位可能會留空。
合作夥伴 1 ID 字串 合作夥伴 1 加密值
合作夥伴 2 ID 字串 合作夥伴 2 加密值
DBM 資料檢視狀態 字串 將代碼包裝函式用於第三方驗證或放送時,查看狀態會指出 Display &Video 360 是否成功贏得曝光、影片已放送到該廣告空間,以及 Campaign Manager 是否追蹤曝光。「outout」的值代表 Display & Video;Display & Video 360 會出價並傳回包裝代碼,以便在發布商網站上放送。 「內部」值是指廣告空間因品牌安全而放送。 當這兩個事件發生時,系統就會記錄兩筆曝光記錄。如果曝光記錄只有「外部」值,但沒有對應的「內部」記錄,代表第三方驗證服務在出價後封鎖了該曝光。「3pas_merged」這個值代表 Campaign Manager 成功追蹤到 Display & Video 360 包裝曝光次數,「3pas_outer」值代表追蹤連線已傳送至 Campaign Manager,但沒有任何回應。 不過,Display &Video 360 仍會贏得出價,並要求從第三方廣告伺服器傳送廣告素材。
DBM 競價 ID 字串 用於彙整資料檢視/點擊/轉換類型事件的字串,例如「ABCDEFGH_abcdefgh-0123456789」。請勿假設拍賣_id 值的順序、結構或意義
DBM 請求時間 我們收到廣告請求時,以微秒 (1/1,000,000 秒) 表示的 Unix 時間戳記 (例如 1330403779608570) 代表 2012 年 2 月 28 日星期二 04:36:19.608570。儘管整個資料檢視中的這個值都不變,但不保證點擊和轉換不會重複,因此請使用競價 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 出價 (美元) 傳送給廣告交易平台的出價價格,以美元為單位 (USD)。您可以將費用除以 1,000,000,000 以美元為單位查看出價。出價是指在最高價得標競價前,委刊項指派給曝光的值。就固定千次曝光出價委刊項而言,這是指出價時採用的固定千次曝光出價委刊項。雖然出價是以千次曝光出價值傳送給廣告交易平台,但出價價格會顯示為每次曝光費用,以便與其他指標保持一致。
DBM 出價 (合作夥伴幣別) 傳送給合作夥伴的出價金額,以合作夥伴幣別 (nanos) 為單位。您可以將費用除以 1,000,000,000,以美元為單位查看出價。出價是指在最高價得標競價前,委刊項指派給曝光的值。如果是固定千次曝光出價的委刊項,這是出價時採用的固定千次曝光出價委刊項。雖然出價是以千次曝光出價的值傳送給廣告交易平台,但出價價格會顯示為每次曝光費用,以便與其他指標保持一致。
DBM 出價 (廣告客戶幣別) 傳送給廣告客戶的出價價格,以廣告客戶幣別 (NGB) 為單位。您可以將費用除以 1,000,000,000,以美元為單位查看出價。出價是指在最高價得標競價前,委刊項指派給曝光的值。如果是固定千次曝光出價的委刊項,這是出價時採用的固定千次曝光出價委刊項。雖然出價是以千次曝光出價的值傳送給廣告交易平台,但出價價格會顯示為每次曝光費用,以便與其他指標保持一致。
DBM 網址 字串 從廣告交易平台收到的出價要求取得的原始網址,例如 "http://www.example.com"。由於某些廣告交易平台會遮蓋出價要求中的網址,因此這個值可能為「source_url_hidden&quot」
DBM 網站 ID Display &Video 360 數字 ID 與與網址相符的最通用通用網站
DBM 語言 字串 ISO-639-1 代碼或「zh_CN」(簡體) 、「zh_TW」(繁體中文) 或「其他」代表觀看事件相關語言
DBM AdX 網頁類別 字串 包含以空格分隔的 Ad Exchange 網頁類別 ID,例如「65 189」。類別不可互斥
DBM 比對目標關鍵字 字串 以逗號分隔的關鍵字清單,當中包含與檢視畫面事件相關的網頁清單,例如「quot;apple,orange,banana」。雖然與觀看事件相關的網頁可能會與許多關鍵字達成比對,但系統只會納入已指定的關鍵字。如果關鍵字清單龐大,我們可能會對傳回的關鍵字數量設下限制
DBM 廣告交易平台 ID 要求廣告的廣告交易平台 &Video 360 數值 ID
DBM 歸因廣告空間來源外部 ID 字串 根據廣告空間價格和競價類型,顯示 Display &Video 360 的歸因廣告空間來源 ID
DBM 歸因廣告空間來源為公開 布林值 如果廣告空間來源適用於所有買方,傳回 True。否則為 False
DBM 廣告排序 指定廣告在網頁中的位置 (如果知道的話)。1 代表需捲動位置
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=寬頻/4G
7=不明
DBM 比對指定區隔 字串 指定訪客的名稱,以空格分隔 (例如「-4 456」)。如果訪客所屬的使用者名單不包含與此事件相關聯的廣告以外的使用者,就不會列在這裡
DBM 網際網路服務供應商 (ISP) ID Display &Video 360 的數字 ID,適用於成效最佳的曝光網際網路服務供應商。缺少這個值
DBM 裝置類型 指定裝置類型的數值。0 = 電腦,1 = 其他;2 = SMARTPHONE,3 = 平板電腦,4 = SMARTTV,5 = CONNECTEDTV
DBM 行動裝置廠商 ID 行動裝置廠商的數值 ID。缺少這個值
DBM 行動裝置模型 ID 行動裝置的數值 ID。缺少這個值
DBM 媒體費用 (美元) 計算為曝光所花費的金額 (以美元為單位) 除以 1,000,000,000 即可瞭解幣別。這個值可以是零
DBM 媒體費用 (合作夥伴幣別) 以曝光貨幣,以合作夥伴幣別 (nanos) 為單位計算的曝光次數,除以 1,000,000,000 即可視為幣別。這個值可以是零
DBM 媒體費用 (廣告客戶幣別) 以曝光廣告客戶幣別 (NIS) 為曝光次數支付的費用,除以 1,000,000,000 即可視為幣別。這個值可以是零
DBM 收益 (美元) 由合作夥伴帳戶針對瀏覽事件產生的總金額 (以美元為單位)。這個值可以是零
DBM 收益 (合作夥伴幣別) 針對合作夥伴事件,用於查看事件的合作夥伴幣別,總額。這個值可以是零
DBM 收益 (廣告客戶幣別) 由合作夥伴帳戶針對瀏覽事件發出的廣告客戶貨幣毛利總額。這個值可以是零
DBM 媒體總費用 (美元) 針對檢視事件計算的媒體費用總額 (以美元為單位)。這個值可以是零
DBM 媒體總費用 (合作夥伴幣別) 針對觀看事件 (以合作夥伴幣別為單位) 的媒體費用總額。這個值可以是零
DBM 媒體總費用 (廣告客戶幣別) 針對觀看事件的廣告客戶廣告客戶貨幣 (媒體費用) 總費用。這個值可以是零
DBM 千次曝光出價費用 1 (美元) 整數 千次曝光出價 1 費用 (以美元為單位)。這個值可以是零
DBM 千次曝光出價費用 1 (合作夥伴幣別) 千次曝光出價 1 費用,以合作夥伴幣別 (保姆) 為單位。這個值可以是零
DBM 千次曝光出價費用 1 (廣告客戶幣別) 千次曝光出價 1 費用 (廣告客戶幣別)。這個值可以是零
DBM 千次曝光出價費用 2 (美元) 千次曝光出價 2 費用 (以美元為單位)。這個值可以是零
DBM 千次曝光出價費用 2 (合作夥伴幣別) 千次曝光出價 2 費用,以合作夥伴幣別 (保姆) 為單位。這個值可以是零
DBM 千次曝光出價費用 2 (廣告客戶幣別) 千次曝光出價 2 的廣告客戶費用 (以廣告客戶幣別表示)。這個值可以是零
DBM 千次曝光出價費用 3 (美元) 千次曝光出價 3 費用 (以美元為單位)。這個值可以是零
DBM 千次曝光出價費用 3 (合作夥伴幣別) 千次曝光出價 3 費用,以合作夥伴幣別 (奈米) 為單位。這個值可以是零
DBM 千次曝光出價費用 3 (廣告客戶幣別) 廣告客戶千次曝光出價的千次曝光出價費用 3 的費用。這個值可以是零
DBM 千次曝光出價費用 4 (美元) 千次曝光出價 4 費用 (以美元為單位)。這個值可以是零
DBM 千次曝光出價費用 4 (合作夥伴幣別) 千次曝光出價 4 費用 (以合作夥伴幣別 (保加利亞) 計算。這個值可以是零
DBM 千次曝光出價費用 4 (廣告客戶幣別) 千次曝光出價 4 廣告客戶的廣告客戶幣別 (保加利亞列)。這個值可以是零
DBM 千次曝光出價費用 5 (美元) 千次曝光出價 5 費用 (以美元為單位)。這個值可以是零
DBM 千次曝光出價費用 5 (合作夥伴幣別) 千次曝光出價 5 費用 (以合作夥伴幣別 (保加利亞) 計算。這個值可以是零
DBM 千次曝光出價費用 5 (廣告客戶幣別) 千次曝光出價 5 費用 (廣告客戶幣別)。這個值可以是零
DBM 媒體費用 1 (美元) 媒體費用 1 (以美元為單位)。這個值可以是零
DBM 媒體費用 1 (合作夥伴幣別) 媒體費用 1 (合作夥伴幣別,以美元為單位)。這個值可以是零
DBM 媒體費用 1 (廣告客戶幣別) 廣告客戶幣別 1 的媒體費用 1。這個值可以是零
DBM 媒體費用 2 (美元) 媒體費用 2 (以美元為單位)。這個值可以是零
DBM 媒體費用 2 (合作夥伴幣別) 媒體費用 2 (以合作夥伴幣別為美元) 。這個值可以是零
DBM 媒體費用 2 (廣告客戶幣別) 廣告客戶幣別 2 的媒體費用 2。這個值可以是零
DBM 媒體費用 3 (美元) 媒體費用 3 (以美元為單位)。這個值可以是零
DBM 媒體費用 3 (合作夥伴幣別) 夥伴幣別 3 的夥伴媒體費用。這個值可以是零
DBM 媒體費用 3 (廣告客戶幣別) 廣告客戶幣別 3 的媒體費用 3。這個值可以是零
DBM 媒體費用 4 (美元) 媒體費用 4 (以美元為單位)。這個值可以是零
DBM 媒體費用 4 (合作夥伴幣別) 媒體費用 4 (以合作夥伴幣別 (納粹)) 計算。這個值可以是零
DBM 媒體費用 4 (廣告客戶幣別) 廣告客戶幣別 9 的媒體費用 4。這個值可以是零
DBM 媒體費用 5 (美元) 媒體費用 5 (以美元為單位)。這個值可以是零
DBM 媒體費用 5 (合作夥伴幣別) 媒體費用 5 (合作夥伴幣別,以美元為單位)。這個值可以是零
DBM 媒體費用 5 (廣告客戶幣別) 廣告客戶幣別 5 的媒體費用 5。這個值可以是零
DBM 資料費用 (美元) 用於指定這個曝光的任何資料費用 (以美元為單位)
DBM 資料費用 (合作夥伴幣別) 用於指定此曝光的任何資料費用,以合作夥伴幣別 (nanos) 為單位
DBM 資料費用 (廣告客戶幣別) 用於指定這個曝光的任何資料費用 (以廣告客戶幣別 (NGB))
DBM 可計費成本 (美元) 支付給合作夥伴的總金額 (包含媒體費用和合作夥伴費用),以美元為單位
DBM 可計費成本 (合作夥伴幣別) 支付給合作夥伴的總金額 (包含媒體費用和合作夥伴費用,以合作夥伴幣別)
DBM 可計費成本 (廣告客戶幣別) 支付給合作夥伴的總金額 (包括媒體費用和合作夥伴費用) (以廣告客戶幣別為單位)
Google Click ID 字串 透過廣告點擊傳送的代碼,識別與廣告追蹤相關聯的廣告活動