访问实体读取文件

实体读取文件是对合作伙伴广告系列对象的 JSON 表示法。实体读取文件 都是只读属性,不能用于对 Google 展示广告网络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_date展示广告和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_date展示广告和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