存取實體讀取檔案

實體讀取檔案是合作夥伴廣告活動物件的 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