实体读取文件是合作伙伴的广告系列对象的 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_date | Display & Video 360 处理数据的日期,与文件中包含的事件不一定相关。日期格式为 YYYYMMDD ,例如 20120320 表示 2012 年 3 月 20 日。 |
batch_index |
批次的索引(从零开始)。例如,如果按小时生成,则第一个批次为 0 ,第二个批次为 1 ,依此类推。 |
entity_type | 文件类型:SupportedExchange 、DataPartner 、UniversalSite 、GeoLocation 、Language 、OperatingSystem 、Browser 、Isp 、summary 和 SiteIdToPlacementId.csv 。 |
browser
表的实体读取文件,则文件的路径应如下所示: gdbm-public/entity/20130115.0.Browser.json
专用表
gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
字段 | 说明 |
---|---|
partner_id | 合作伙伴的数字 ID。 |
processing_date | Display & Video 360 处理数据的日期。此日期不一定与文件中包含的事件相关。日期格式为 YYYYMMDD (例如 20120320 表示 2012 年 3 月 20 日)。系统会在凌晨 4 点到早上 6 点之间生成文件(以合作伙伴所在时区为准)。 |
batch_index | 批次的索引(从零开始)。目前,此值始终为 0。 |
entity_type | 文件类型:Partner 、Advertiser 、InsertionOrder 、LineItem 、Creative 、Pixel 、InventorySource 、UserList 、UniversalChannel 和 summary 。 |
line_item
表的合作伙伴 123 的实体读取文件,则文件名将如下所示:
gdbm-123/entity/20130402.0.LineItem.json