Os arquivos da leitura de entidades são representações JSON dos objetos de campanha de um parceiro. Os arquivos da leitura de entidades são somente leitura e não podem ser usados para write-back de alterações no Google Display & Video 360. Para saber mais sobre como usar arquivos da leitura de entidades, entre em contato com o gerente da sua conta, que poderá discutir suas necessidades com mais detalhes.
Os arquivos da leitura de entidades ficam disponíveis apenas por 60 dias a partir da data de processamento.
O formato dos arquivos da leitura de entidades pode ser visualizado na referência de formato de arquivo.
Os arquivos da leitura de entidades são armazenados em dois grupos:
- Tabelas públicas, que contêm dados públicos comuns, como informações sobre versões do navegador
ou idiomas armazenados no bucket
gdbm-public
. - Tabelas particulares, que contêm informações sobre campanhas, orçamentos e outros dados particulares do parceiro. As tabelas privadas são armazenadas em buckets específicos do parceiro. Por exemplo, se o ID do parceiro for 123, o bucket que continha as tabelas privadas seria
gdbm-123
.
entity
dentro do bucket.
Para mais informações sobre como gerenciar subdiretórios, consulte Namespace do objeto do Cloud Storage.
As tabelas públicas são geradas às 5h UTC. As tabelas privadas são geradas às 5h no fuso horário do seu parceiro (embora em casos raros possam ocorrer atrasos) e armazenadas de maneira automática e segura no Google Cloud Storage. Um arquivo de resumo é gerado depois de todas as tabelas públicas e privadas terem sido geradas.
Tabelas públicas
gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
Campo | Descrição |
---|---|
processing_date | A data em que o Display & Video 360 processou os dados e não está necessariamente relacionada aos eventos contidos no arquivo. O formato da data é YYYYMMDD . Por exemplo, 20120320 seria 20 de março de 2012. |
batch_index |
Um índice do lote baseado em zero. Por exemplo, se gerado a cada hora, o primeiro lote será 0 , o segundo lote será 1 e assim por diante. |
entity_type | O tipo de arquivo: SupportedExchange ,
DataPartner , UniversalSite ,
GeoLocation , Language , OperatingSystem , Browser ,
Isp , summary e SiteIdToPlacementId.csv . |
browser
de 15 de janeiro de 2013, o caminho para o arquivo seria gdbm-public/entity/20130115.0.Browser.json.
Tabelas privadas
gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
Campo | Descrição |
---|---|
partner_id | O ID numérico do seu parceiro. |
processing_date | A data em que o Display & Video 360 processou os dados. Essa data não está necessariamente relacionada aos eventos contidos no arquivo. O formato da data é YYYYMMDD , por exemplo, 20120320 seria 20 de março de 2012. Os arquivos serão gerados entre 4h e 6h no fuso horário do parceiro. |
batch_index | Um índice do lote baseado em zero. Atualmente, esse valor é sempre 0. |
entity_type | O tipo de arquivo: Partner , Advertiser , InsertionOrder , LineItem , Creative , Pixel , InventorySource , UserList , UniversalChannel e summary . |
line_item
de 2 de abril de 2013, o nome do arquivo ficaria assim:
gdbm-123/entity/20130402.0.LineItem.json