注意:新帳戶無法啟用 Ad Exchange 資料移轉功能。
資料移轉功能可以提供關於客戶 Ad Exchange 交易的事件層級報表。資料移轉報表中的資訊會優先於無效活動的篩選資料。
Google Cloud Storage
系統每天會透過 Google Cloud Storage 提供一份資料移轉報表 (使用太平洋時間)。您不需要註冊 Google Cloud Storage 帳戶,只要選擇一或多位可存取報表的 Ad Exchange 使用者即可。使用者可以在 sandbox.google.com/storage 的已驗證瀏覽器工作階段下載報表,也可以使用下列其中一項工具:
進一步瞭解 Google Cloud Storage 驗證。
由於 Google 儲存空間管理工具只會顯示您擁有的類別,因此請勿使用該工具存取 Ad Exchange 資料移轉報表。
通知
每次系統提供新的資料移轉檔案時,有權存取 Google Cloud Storage 的使用者就會收到通知電子郵件。這些電子郵件中包含下列資訊:
- 所提供報表檔案的名稱
- 包含檔案的 Google Cloud Storage Bucket
- 在瀏覽器畫面登入並下載報表的連結
解讀資料移轉報表
所有資料移轉報表都會以 .CSV 和/或 Parquet 格式提供。資料移轉報表有兩種類型:
- 曝光和點擊
列出您的資源的曝光資訊及相關點擊記錄。這份報表會分成多個檔案,每小時一個。 - 廣告版位屬性
列出自訂廣告版位屬性的資訊。我們針對可繼承的屬性提供資源層級設定,也提供個別廣告版位的額外設定 (兩者並用可取得某個廣告版位的有效屬性清單)。這份報表會每天提供一個檔案。
資料移轉報表檔案中的每一列都代表一筆 Ad Exchange 交易。只要展開下方的部分,就可以查看詳細資料。
注意:選填欄位不一定每次都會提供;要是沒有提供,這些欄位會在報表中保留空白。布林值會顯示為
曝光和點擊
true
或 false
。整數/小數值會以小數點表示。範例:
TOEw6QAElpQK2l8H8LRh9g,2016-05-17 05:08:57,false,Some Buyer Network, www.examplesite.com,,http://www.examplesite.com/examplepath?%2Cxxx&nodebug=1,false,true,true,,docvertical::258,Sports,4,123456789, 0.00140351999645645,0.649999,false,false,1,0,0,Some DSP,Some Advertiser
欄位 | 說明 | 類型 | 是否為必要欄位 |
---|---|---|---|
query_id |
不重複的廣告請求編號。 | 字串 | 是 |
datetime |
系統收到廣告請求的日期和時間 (以太平洋時間表示)。 | 字串 | 是 |
is_anonymous |
已淘汰 Ad Manager 已不再採用匿名曝光的概念。 |
布林值 | 否 |
buyer |
得標買方名稱。如果是影片廣告連播,則會列出各個得標買方,並以加號 (+) 分隔。 | 字串 | 否 |
DEPRECATED_sitename |
使用 referer_url 欄位。 |
字串 | 否 |
anonymous_id |
已淘汰。 | 字串 | 否 |
referer_url |
這個廣告請求的網址。 | 字串 | 否 |
allow_data_collection_for_interest_targeting |
指出這次曝光是否允許收集指定興趣相關資料。 | 布林值 | 否 |
allow_user_list_targeting |
指出這次曝光是否允許指定使用者名單。 | 布林值 | 否 |
allow_user_interest_targeting |
指出這次曝光是否允許指定使用者興趣。 | 布林值 | 否 |
matched_geo_list |
使用 ISO 3166-1/ISO 3166-2 代碼列出地理區域資訊,並以加號 (+) 分隔。 | 字串 | 否 |
matched_verticals_list |
採用 docvertical::xxx 格式列出發布商產業別 (xxx 為數字代碼),並以加號 (+) 分隔。 |
字串 | 否 |
channels |
追蹤管道名稱,以加號 (+) 分隔。 | 字串 | 否 |
ad_type |
必須以點陣圖解讀。ad_type 和 0x1 = 曝光是否包含文字廣告。ad_type 和 0x2 = 曝光是否包含靜態或動態圖像廣告。ad_type 和 0x4 = 曝光是否包含其他類型的廣告。 |
int32 | 否 |
client_ip |
已淘汰 這個廣告請求的來源 IP 位址。整個八位元組會設為 0,以保護客戶隱私。 |
字串 | 否 |
adslot_code |
Ad Exchange 廣告代碼 ID。 | 字串 | 否 |
seller_impression_revenue_usd |
這次曝光為發布商帶來的收益 (以美元表示)。 | 雙精準數 | 否 |
seller_reserve_price_usd |
所採用的千次曝光出價預留價格 (幣別為美元)。 | 雙精準數 | 否 |
was_userlist_targeted |
指出這次曝光是否有指定使用者名單。 | 布林值 | 否 |
was_match_on_keyword |
指出這次曝光是否有關鍵字比對成功。 | 布林值 | 否 |
num_clicks |
指出是否有記錄到點擊。以布林值表示,非 0 即 1。 | int32 | 是 |
transaction_type |
交易類型 (0 = 公開競價,1 = 首選交易,2 = 私下競價,3 = 程式輔助保證,4 = 優先認購)。 | int32 | 否 |
deal_ids |
得標曝光的交易編號,以加號 (+) 分隔。 | 字串 | 否 |
buyer_network_names |
需求端平台的聯播網名稱,以加號 (+) 分隔。 | 字串 | 否 |
advertiser |
贏得曝光的廣告客戶名稱,以加號 (+) 分隔。 | 字串 | 否 |
範例:
ca-pub-123456789,property_wide,26+110+9+12+1+55+5+11+6+57+17+8+113+60+2+65+7+69+70+4+18+13+3+14+92+94+19+96,,firstblockedurl.com+secondblockedurl.com+thirdblockedurl.com
ca-pub-123456789,987654321,,10,
欄位 | 說明 | 類型 | 是否為必要欄位 |
property_code |
Ad Exchange 資源代碼。 | 字串 | 是 |
adslot_code |
Ad Exchange 廣告代碼 ID。 如果為 site_wide 值,表示使用的是 Ad Exchange 帳戶或資源層級設定。 |
字串 | 是 |
allowed_vendor_types |
供應商類型的數值代碼,以加號 (+) 分隔。這個欄位不適用於已設定取代封鎖條件的交易。 詳情請參閱即時出價工具通訊協定。 |
字串 | 否 |
allowed_video_formats |
影片檔案格式,以加號 (+) 分隔。詳情請參閱即時出價工具通訊協定。 | 字串 | 否 |
blocked_urls |
已封鎖的網址,以加號 (+) 分隔。 | 字串 | 否 |