Cómo acceder a los archivos de lectura de entidades

Los archivos de lectura de entidades son representaciones JSON de los objetos de campaña de un socio. Los archivos de lectura de entidades son de solo lectura y no se pueden usar para volver a escribir cambios en Google Display & Video 360. Si quieres obtener más información para usar los archivos de lectura de entidades, comunícate con tu administrador de cuentas, quien podrá analizar tus necesidades con más detalle.

Ten en cuenta que los archivos de lectura de entidades solo están disponibles durante 60 días desde la fecha de procesamiento.

El formato de los archivos de lectura de entidades se puede ver en la referencia de formato de archivo.

Los archivos de lectura de entidades se almacenan como dos grupos:

  • Tablas públicas, que contienen datos públicos comunes, como información sobre las versiones del navegador o los idiomas que se almacenan en el bucket gdbm-public.
  • Tablas privadas, que contienen información sobre las campañas, los presupuestos y otros datos privados del socio. Las tablas privadas se almacenan en buckets específicos de socios. Por ejemplo, si tu ID de socio es 123, el bucket que contenía tus tablas privadas sería gdbm-123.
Las tablas públicas y privadas se encuentran en un subdirectorio entity dentro del bucket. Para obtener más información sobre cómo administrar subdirectorios, consulta Espacio de nombres de objetos de Cloud Storage.
Las tablas públicas se generan a las 5 a.m. UTC. Las tablas privadas se generan a las 5 a.m. de la zona horaria de tu socio (aunque en casos excepcionales puede haber retrasos) y se almacenan de forma automática y segura en Google Cloud Storage. Se genera un archivo de resumen después de que se hayan generado todas las tablas públicas y privadas.

Tablas públicas

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
CampoDescripción
processing_dateEs la fecha en la que Display & Video 360 procesó los datos y no está necesariamente relacionada con los eventos contenidos en el archivo. El formato de fecha es YYYYMMDD. Por ejemplo, 20120320 sería el 20 de marzo de 2012.
batch_index Un índice del lote basado en cero. Por ejemplo, si se genera cada hora, el primer lote sería 0, el segundo sería 1, y así sucesivamente.
entity_typeEl tipo de archivo: SupportedExchange, DataPartner, UniversalSite, GeoLocation, Language, OperatingSystem, Browser, Isp, summary y SiteIdToPlacementId.csv.
Por ejemplo, si generas un nombre de archivo para recuperar el archivo de lectura de la entidad de la tabla browser del 15 de enero de 2013, la ruta de acceso al archivo sería como
gdbm-public/entity/20130115.0.Browser.json
.

Tablas privadas

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
CampoDescripción
partner_idEl ID numérico de tu socio.
processing_dateEs la fecha en la que Display & Video 360 procesó los datos. Esta fecha no está necesariamente relacionada con los eventos contenidos en el archivo. El formato de la fecha es YYYYMMDD, por ejemplo, 20120320 sería el 20 de marzo de 2012. Los archivos se generarán entre las 4 a.m. y las 6 a.m. en la zona horaria del socio.
batch_indexUn índice del lote basado en cero. Actualmente, es siempre 0.
entity_typeEl tipo de archivo: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel y summary.
Por ejemplo, si generas un nombre de archivo para recuperar el archivo de lectura de la entidad del socio 123 que accede a la tabla line_item desde el 2 de abril de 2013, el nombre del archivo debería ser similar a este:
gdbm-123/entity/20130402.0.LineItem.json