访问实体读取文件

实体读取文件是合作伙伴的广告系列对象的 JSON 表示法。实体读取文件是只读的,不能用于将更改回写到 Google Display &Video 360。如需详细了解如何使用实体读取文件,请与您的客户经理联系,他们可以更详细地讨论您的需求。

请注意,实体读取文件自处理之日起仅可供 60 天。

您可以在文件格式参考文档中查看实体读取文件的格式。

实体读取文件分为两组存储:

  • 公共表,其中包含常见的公共数据,例如存储在 gdbm-public 存储分区中的浏览器版本或语言相关信息。
  • 私有表格,包含合作伙伴的广告系列、预算和其他私有数据的相关信息。专用表存储在合作伙伴专用存储分区中;例如,如果您的合作伙伴 ID 为 123,则专用表所在的存储分区将为 gdbm-123
公共表和私有表都位于存储分区内的 entity 子目录中。 如需详细了解如何处理子目录,请参阅 Cloud Storage 对象命名空间
公共表格会在世界协调时间 (UTC) 凌晨 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文件类型:SupportedExchangeDataPartnerUniversalSiteGeoLocationLanguageOperatingSystemBrowserIspsummarySiteIdToPlacementId.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文件类型:PartnerAdvertiserInsertionOrderLineItemCreativePixelInventorySourceUserListUniversalChannelsummary
例如,如果您要生成文件名以检索合作伙伴 123 在 2013 年 4 月 2 日访问 line_item 表的实体读取文件,则您的文件名将如下所示:
gdbm-123/entity/20130402.0.LineItem.json