Accedere ai file di lettura entità

I file per la lettura delle entità sono rappresentazioni JSON degli oggetti delle campagne di un partner. I file per la lettura delle entità sono di sola lettura e non possono essere utilizzati per scrivere le modifiche apportate in Google Display & Video 360. Per saperne di più sull'utilizzo dei file per la lettura delle entità, contatta il tuo account manager, che potrà discutere delle tue esigenze in modo più dettagliato.

Tieni presente che i file per la lettura delle entità sono disponibili solo per 60 giorni dalla data di elaborazione.

Il formato dei file di lettura delle entità può essere visualizzato nella pagina di riferimento sul formato file.

I file per la lettura delle entità sono archiviati in due gruppi:

  • Tabelle pubbliche che contengono dati pubblici comuni, ad esempio informazioni sulle versioni del browser o sulle lingue archiviate nel bucket gdbm-public.
  • Tabelle private contenenti informazioni sulle campagne, sui budget e altri dati privati del partner. Le tabelle private sono archiviate in bucket specifici del partner; ad esempio, se l'ID partner è 123, il bucket che conteneva le tabelle private sarebbe gdbm-123.
Le tabelle pubbliche e private si trovano in una sottodirectory entity del bucket. Per maggiori informazioni sulla gestione delle sottodirectory, consulta Spazio dei nomi degli oggetti Cloud Storage.
Le tabelle pubbliche vengono generate alle 05:00 UTC. Le tabelle private vengono generate alle ore 05:00 nel fuso orario del partner (anche se in rari casi potrebbero verificarsi ritardi) e archiviate automaticamente e in modo sicuro in Google Cloud Storage. Dopo aver generato tutte le tabelle pubbliche e private, viene generato un file di riepilogo.

Tabelle pubbliche

gdbm-public/entity/(processing_date).(batch_index).(entity_type).json
CampoDescrizione
processing_dateLa data in cui Display & Video 360 ha elaborato i dati e non è necessariamente correlata agli eventi contenuti all'interno del file. Il formato della data è YYYYMMDD, ad esempio 20120320 corrisponde al 20 marzo 2012.
batch_index Un indice in base zero del batch. Ad esempio, se viene generato su base oraria, il primo batch sarà 0, il secondo batch sarà 1 e così via.
entity_typeIl tipo di file: SupportedExchange, DataPartner, UniversalSite, GeoLocation, Language, OperatingSystem, Browser, Isp, summary e SiteIdToPlacementId.csv.
Ad esempio, se generi un nome file per recuperare il file di lettura delle entità per la tabella browser dal 15 gennaio 2013, il percorso del file sarà
gdbm-public/entity/20130115.0.Browser.json

Tabelle private

gdbm-(partner_id)/entity/(processing_date).(batch_index).(entity_type).json
CampoDescrizione
partner_idL'ID numerico del tuo partner.
processing_dateLa data in cui Display & Video 360 ha elaborato i dati. Questa data non è necessariamente correlata agli eventi contenuti all'interno del file. Il formato della data è YYYYMMDD, ad esempio 20120320 corrisponde al 20 marzo 2012. I file verranno generati tra le 04:00 e le 06:00 nel fuso orario del partner.
batch_indexUn indice in base zero del batch. Attualmente il valore è sempre 0.
entity_typeIl tipo di file: Partner, Advertiser, InsertionOrder, LineItem, Creative, Pixel, InventorySource, UserList, UniversalChannel e summary.
Ad esempio, se generi un nome file per recuperare il file di lettura delle entità per il partner 123 che accede alla tabella line_item dal 2 aprile 2013, il nome del tuo file sarà simile al seguente:
gdbm-123/entity/20130402.0.LineItem.json