Eseguire la migrazione alla versione 8 dei file di dati strutturati

Ultimo aggiornamento: 12/11/2024

Questa guida illustra la procedura di migrazione dall'utilizzo dei file di dati strutturati v7.1 alla versione 8 e spiega le modifiche tra le due versioni che potrebbero influire sulla tua integrazione.

Consulta le note di rilascio per un elenco esaustivo delle differenze tra la versione 7.1 e la versione 8.

Esegui la migrazione della versione dei file di dati strutturati

Per eseguire la migrazione alla versione 8 dei file di dati strutturati (SDF) da una versione precedente:

  1. Aggiorna le risorse e le azioni di generazione di SDF per utilizzare la versione 8.
  2. Aggiorna la logica della risorsa annuncio per identificare un tipo al momento della creazione.
  3. Aggiungi nuova logica per la lettura, la creazione e l'aggiornamento delle risorse Demand Gen.

Aggiornare la versione dei file di dati strutturati

Per utilizzare una nuova versione dei file di dati strutturati, aggiorna la versione assegnata nelle risorse Partner e Inserzionista principali e utilizza la nuova versione quando crei singole attività di download nell'API Display & Video 360.

Aggiorna le impostazioni della risorsa principale

Una versione predefinita dei file di dati strutturati è impostata a livello di risorsa del partner e dell'inserzionista. Questa versione viene utilizzata come predefinita per il download dei file di dati strutturati tramite l'interfaccia o l'API.

Impostato nell'interfaccia

A livello di partner

  1. Vai al partner previsto.
  2. Espandi il menu Impostazioni partner nel menu di navigazione a sinistra e vai alla pagina Dettagli di base.
  3. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati a v8.

A livello di inserzionista

  1. Accedi all'inserzionista previsto.
  2. Espandi il menu Impostazioni inserzionista nel menu di navigazione a sinistra e vai alla pagina Dettagli di base.
  3. Aggiorna la configurazione della versione SDF nella sezione File di dati strutturati a v8. Se la versione predefinita è impostata a livello di Partner, questa impostazione potrebbe non essere modificabile.
Impostato nell'API
A livello di partner
Non puoi impostare la versione SDF predefinita a livello di partner nell'API.
A livello di inserzionista
Invia una richiesta advertisers.patch per aggiornare il valore dataAccessConfig.sdfConfig.sdfConfig.version a SDF_VERSION_8 e, se necessario, dataAccessConfig.sdfConfig.overridePartnerSdfConfig a True.

Aggiorna le richieste sdfdownloadtasks.create nell'API

Quando effettui una richiesta sdfdownloadtasks.create utilizzando l'API Display & Video 360, imposta il campo version del corpo della richiesta su SDF_VERSION_8.

Specifica il tipo nelle risorse annuncio

La versione 8 aggiunge una colonna Ad Type ai file Ad, che mostra il tipo di annunci rappresentato da ogni riga. Questa nuova colonna è obbligatoria e verrà compilata per le risorse esistenti al momento del download dei file annunci v8.

Quando aggiorni gli annunci esistenti, il valore di questa colonna non deve essere modificato.

Quando crei nuovi annunci, devi compilare questa colonna con uno dei valori elencati nella descrizione della colonna.

Aggiorna la logica per le risorse Demand Gen

La versione 8 supporta la creazione, il recupero e l'aggiornamento delle campagne Demand Gen utilizzando i file Elemento pubblicitario, Gruppo di annunci e Annuncio. Le risorse Demand Gen utilizzano una logica diversa per la verifica del timestamp, richiedono la compilazione di colonne aggiuntive e sono limitate da nuove restrizioni nei tre tipi di file.

Verifica del timestamp

Per tutti gli elementi pubblicitari non Demand Gen, la colonna Timestamp di un file Line Item viene compilata al momento del download con l'ultima volta che un elemento pubblicitario è stato modificato. Questo valore viene utilizzato per verificare che un elemento pubblicitario non sia stato aggiornato dal download del file originale quando lo aggiorni utilizzando un file SDF. Se è così, l'aggiornamento non va a buon fine.

Per gli elementi pubblicitari Demand Gen, la colonna Timestamp e la verifica associata funzionano in modo diverso. Per le voci degli elementi pubblicitari Demand Gen, la colonna viene compilata con l'ora corrente al momento del download. Al momento del caricamento, Display & Video 360 controlla se sono trascorse più di 24 ore dal timestamp specificato. Se sono trascorse più di 24 ore, la voce del file originale viene considerata obsoleta e l'aggiornamento non va a buon fine. In questo caso, scarica di nuovo il file e apporta gli aggiornamenti in base alla versione più recente. Questo nuovo metodo di verifica non impedisce di sovrascrivere le modifiche apportate nelle ultime 24 ore. Per evitare sovrascritture accidentali, includi nei file che carichi solo gli elementi pubblicitari Demand Gen che vuoi aggiornare.

Colonne obbligatorie

I seguenti tipi di file hanno colonne che ora sono obbligatorie per alcune risorse Demand Gen, oltre alle colonne obbligatorie per tutte le entità di quel tipo di file.

Elemento pubblicitario
Colonne obbligatorie per i seguenti valori della colonna Type: Voce di bilancio
Demand Gen
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
Colonne obbligatorie per i seguenti valori della colonna Annuncio Ad Type
Carosello Demand Gen
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Immagine Demand Gen
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
Prodotto Demand Gen
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Demand Gen
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

Restrizioni aggiornate

Oltre alle nuove colonne obbligatorie per determinati annunci e elementi pubblicitari Demand Gen, più colonne dei tipi di file Elemento pubblicitario, Gruppo di annunci e Annuncio sono soggette a nuove limitazioni di utilizzo che si applicano alle risorse Demand Gen.

Queste limitazioni sono numerose e specifiche per le colonne in questione, pertanto questa guida non fornisce un elenco esaustivo delle limitazioni. Ti consigliamo di leggere attentamente la documentazione di riferimento della versione 8 per i tipi di file Elemento pubblicitario, Gruppo di annunci e Annuncio prima di creare o aggiornare le risorse Demand Gen utilizzando il caricamento SDF.