Acessar arquivos da leitura de entidades

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 gravar alterações no Google Display & Video 360. Para saber mais sobre o uso de arquivos de leitura de entidade, entre em contato com seu gerente de contas, que poderá discutir suas necessidades com mais detalhes.

Os arquivos da leitura de entidades ficam disponíveis por apenas 60 dias a partir da data de processamento.

Consulte o formato dos arquivos de leitura de entidade na referência de formato do arquivo.

Os arquivos de 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 as campanhas, os orçamentos e outros dados particulares do parceiro. As tabelas particulares são armazenadas em buckets específicos do parceiro. Por exemplo, se o ID do parceiro for 123, o bucket que continha as tabelas particulares será gdbm-123.
As tabelas públicas e privadas estão em um subdiretório entity dentro do bucket. Para mais informações sobre como processar subdiretórios, consulte Namespace de objetos do Cloud Storage.
As tabelas públicas são geradas às 5h UTC. As tabelas particulares são geradas às 5h no fuso horário do seu parceiro (em casos raros, pode haver atrasos) e armazenadas de forma automática e segura no Google Cloud Storage. Um arquivo de resumo é gerado depois que todas as tabelas públicas e privadas são geradas.

Tabelas públicas

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
CampoDescrição
processing_dateA 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 baseado em zero do lote. Por exemplo, se for gerado a cada hora, o primeiro lote será 0, o segundo lote será 1 e assim por diante.
entity_typeO tipo de arquivo: SupportedExchange, DataPartner, UniversalSite, GeoLocation, Language, OperatingSystem, Browser, Isp, summary e SiteIdToPlacementId.csv.
Por exemplo, se você estivesse gerando um nome de arquivo para extrair o arquivo de leitura de entidade da tabela browser a partir de 15 de janeiro de 2013, o caminho para o arquivo seria:
gdbm-public/entity/20130115.0.Browser.json

Mesas particulares

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
CampoDescrição
partner_idÉ o ID numérico do 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_indexUm índice baseado em zero do lote. Atualmente, esse valor é sempre 0.
entity_typeO tipo de arquivo: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel e summary.
Por exemplo, se você estivesse gerando um nome de arquivo para recuperar o arquivo de leitura de entidade do parceiro 123 que acessa a tabela line_item a partir de 2 de abril de 2013, o nome do arquivo seria semelhante a este:
gdbm-123/entity/20130402.0.LineItem.json