Cómo acceder a los archivos de lectura de entidades

Los archivos de lectura de entidades son representaciones JSON de los objetos de la 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. Para obtener más información sobre el uso de 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 a partir de su fecha de procesamiento.

El formato de los archivos leídos de entidades se puede ver en la referencia de formato de archivo.

Los archivos de lectura de la entidad se almacenan como dos grupos:

  • Tablas públicas, que contienen datos públicos comunes, como información sobre las versiones de navegadores 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 para cada socio. Por ejemplo, si tu ID de socio es 123, el bucket que contiene 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 la administración de 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:00 a.m. en 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 se relaciona necesariamente con los eventos que contiene el archivo. El formato de fecha es YYYYMMDD. Por ejemplo, 20120320 sería el 20 de marzo de 2012.
batch_index Es un índice basado en cero del lote. Por ejemplo, si se genera por hora, el primer lote sería 0, el segundo lote 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 generaras un nombre de archivo para recuperar el archivo de lectura de entidades de la tabla browser del 15 de enero de 2013, la ruta de acceso al archivo se vería de la siguiente manera:
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 incluidos 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. (hora local del socio).
batch_indexEs un índice basado en cero del lote. Actualmente, siempre es 0.
entity_typeEl tipo de archivo: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel y summary.
Por ejemplo, si estuvieras generando un nombre de archivo para recuperar el archivo de lectura de entidades del socio 123 que accede a la tabla line_item a partir del 2 de abril de 2013, el nombre del archivo se vería de la siguiente manera:
gdbm-123/entity/20130402.0.LineItem.json