存取實體讀取檔案

實體讀取檔案是合作夥伴廣告活動物件的 JSON 表示法。實體讀取檔案為唯讀，無法用於將變更寫回 Google Display & Video 360。如要進一步瞭解如何使用實體讀取檔案，請與客戶經理聯絡，他們會進一步討論您的需求。

請注意，實體讀取檔案只會保留至處理當日起算的 60 天。

您可以在檔案格式參考資料中查看實體讀取檔案的格式。

實體讀取檔案會儲存為兩個群組：

  • 公開資料表，內含常見的公開資料，例如 gdbm-public 值區中儲存的瀏覽器版本或語言相關資訊。
  • 私人表格，其中包含合作夥伴的廣告活動、預算和其他私人資料的資訊。私人資料表會儲存在特定合作夥伴的值區中。舉例來說，如果合作夥伴 ID 為 123，則包含私人資料表的值區會是 gdbm-123。
公開和私人資料表都位於資料桶內的 entity 子目錄中。 如要進一步瞭解如何處理子目錄，請參閱 Cloud Storage 物件命名空間。
公開資料表會在世界標準時間上午 5 點產生。私人資料表會在合作夥伴時區的凌晨 5 點產生 (但在少數情況下可能會延遲)，並自動安全地儲存至 Google Cloud Storage。系統會在產生所有公開和私人資料表後，產生摘要檔案。

公開資料表

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
欄位說明
processing_dateDisplay & Video 360 處理資料的日期，不一定與檔案內含的事件相關。日期格式為 YYYYMMDD，例如 20120320 代表 2012 年 3 月 20 日。
batch_index 批次的索引，從零開始。舉例來說，如果每小時產生一次，第一批會是 0，第二批會是 1，以此類推。
entity_type檔案類型：SupportedExchange、DataPartner、UniversalSite、GeoLocation、Language、OperatingSystem、Browser、Isp、summary 和 SiteIdToPlacementId.csv。
舉例來說，如果您要產生檔案名稱，以便從 2013 年 1 月 15 日開始擷取 browser 資料表的實體讀取檔案，檔案路徑會像這樣：
gdbm-public/entity/20130115.0.Browser.json

私人表格

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
欄位說明
partner_id合作夥伴的數字 ID。
processing_dateDisplay & Video 360 處理資料的日期。這個日期不一定與檔案內的事件相關。日期格式為 YYYYMMDD，例如 20120320 代表 2012 年 3 月 20 日。系統將在合作夥伴時區的凌晨 4 點到上午 6 點之間產生檔案。
batch_index批次索引，從零開始。目前這項值一律為 0。
entity_type檔案類型：Partner、Advertiser、InsertionOrder、LineItem、Creative、Pixel、InventorySource、UserList、UniversalChannel 和 summary。
舉例來說，如果您要產生檔案名稱，以便擷取合作夥伴 123 自 2013 年 4 月 2 日起存取 line_item 資料表的實體讀取檔案，檔案名稱會類似以下格式： 
gdbm-123/entity/20130402.0.LineItem.json