Le versioni dell'API Display & Video 360 vengono rilasciate, ritirate e ritirate regolarmente. Questi
passaggi sono definiti come segue:
Release: la versione esce da qualsiasi stato alpha o beta ed è considerata
stabile. Potrebbero comunque essere rilasciate aggiunte di funzionalità per la versione.
Deprecazione: la versione verrà ritirata e verrà annunciata una data di fine del supporto. Gli utenti devono eseguire la migrazione a una versione più recente prima della data di ritiro. Non verranno più rilasciate aggiunte di funzionalità per la versione.
Disattivazione: la versione non è più supportata. Le richieste effettuate alla versione
restituiscono un errore.
Questa tabella elenca tutte le versioni principali esistenti dell'API Display & Video 360, le relative date di rilascio
e le date di ritiro e fine del ciclo di vita, se annunciate.
La tabella seguente elenca tutti i ritiri delle funzionalità annunciati, fornendo la data di entrata in vigore iniziale e una descrizione del ritiro con azioni consigliate e link alla documentazione pertinente:
Funzionalità
Data di validità iniziale
Descrizione
Espansione del targeting
25 marzo 2023
Sostituzione della funzionalità di espansione del targeting con il targeting ottimizzato, implementata gradualmente dal 25 marzo 2023 all'inizio di maggio 2023. Le modifiche pertinenti al comportamento dell'API Display & Video 360 e dei file di dati strutturati, nonché le azioni consigliate, sono state annunciate in un post del blog.
Trigger manuali
17 maggio 2023
Sequenza temporale
17 maggio 2023: la pubblicazione degli elementi pubblicitari che utilizzano trigger manuali verrà interrotta in Display & Video 360. Se attivi un attivatore manuale collegato a un elemento pubblicitario attivo dopo questa data, l'elemento pubblicitario non pubblicherà annunci.
Tipi di app installate e nuovi dispositivi mobili GoogleAudience
20 maggio 2023
Sequenza temporale
20 maggio 2023: non potrai più assegnare risorse GoogleAudience con un GoogleAudienceType di GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS o GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES al targeting per segmento di pubblico di elementi pubblicitari o ordini di inserzione. Le richieste di assegnazione di questi segmenti di pubblico al targeting per pubblico di un elemento pubblicitario restituiranno un errore. Sono incluse le richieste advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault, se l'elemento pubblicitario creato include segmenti di pubblico ritirati nel targeting per pubblico.
8 giugno 2023: i segmenti di pubblico interessati verranno rimossi da tutto il targeting degli elementi pubblicitari e degli ordini di inserzione e da tutti i segmenti di pubblico combinati. Se un elemento pubblicitario non è in grado di pubblicare annunci quando questi segmenti di pubblico vengono rimossi, verrà messo in pausa. A partire da questa data, questi segmenti di pubblico non saranno più recuperabili utilizzando il servizio googleAudiences.
Attività consigliate:
Ti consigliamo di interrompere immediatamente l'utilizzo dei segmenti di pubblico interessati quando apporti aggiornamenti futuri al targeting dell'elemento pubblicitario.
Rimuovi tutti i segmenti di pubblico interessati dal targeting esistente di elementi pubblicitari e ordini di inserzione. Scopri di più sull'aggiornamento del targeting per pubblico nella nostra guida ai segmenti di pubblico di destinazione.
20 maggio 2023: non potrai più assegnare risorse FirstAndThirdPartyAudience con un AudienceType di ACTIVITY_BASED o FREQUENCY_CAP al targeting per segmento di pubblico di elementi pubblicitari o ordini di inserzione. Le richieste di assegnazione di questi segmenti di pubblico al targeting per pubblico di un elemento pubblicitario restituiranno un errore. Sono incluse le richieste advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault, se l'elemento pubblicitario creato include segmenti di pubblico ritirati nel targeting per pubblico.
8 giugno 2023: i segmenti di pubblico interessati verranno rimossi da tutto il targeting degli elementi pubblicitari e degli ordini di inserzione e da tutti i segmenti di pubblico combinati. Se un elemento pubblicitario non è in grado di pubblicare annunci quando questi segmenti di pubblico vengono rimossi, verrà messo in pausa. A partire da questa data, questi segmenti di pubblico non saranno più recuperabili utilizzando il servizio firstAndThirdPartyAudiences.
Attività consigliate:
Ti consigliamo di interrompere immediatamente l'utilizzo dei segmenti di pubblico interessati quando apporti aggiornamenti futuri al targeting dell'elemento pubblicitario.
Rimuovi tutti i segmenti di pubblico interessati dal targeting esistente di elementi pubblicitari e ordini di inserzione. Scopri di più sull'aggiornamento del targeting per pubblico nella nostra guida ai segmenti di pubblico di destinazione.
Limiti delle quote API esistenti
30 maggio 2023
Il 30 maggio 2023, i limiti di utilizzo esistenti verranno sostituiti da una struttura di quote ibrida che:
Elimina la quota di richieste al giorno per progetto.
Stabilisce una quota di richieste al minuto per inserzionista per progetto per i metodi idonei.
Questi nuovi limiti consentiranno una maggiore flessibilità nell'utilizzo dell'API e la parallelizzazione delle richieste tra gli inserzionisti. I dettagli di questa modifica sono disponibili nella nostra documentazione sui limiti di quota esistenti.
Utilizzo dell'operatore OR tra le limitazioni di campi diversi nei filtri LIST
21 giu 2023
A partire dal 21 giugno 2023, i parametri della richiesta LISTfilter non consentiranno più l'utilizzo di operatori logici OR tra le limitazioni di campi diversi.
Ad esempio, le risorse identificate con la stringa di filtro lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" devono essere recuperate utilizzando due richieste LIST con le seguenti stringhe di filtro:
Controlla i filter parametri di query di tutte le chiamate LIST esistenti e verifica che utilizzino correttamente l'operatore logico OR prima del 21 giugno 2023 per evitare un'interruzione del servizio.
Rimuovi tutta la logica di filtro utilizzando questi quattro campi prima del 21 giugno 2023 per evitare un'interruzione del servizio.
Acquisto basato sui risultati
1° agosto 2023
Il 1° agosto 2023, gli ordini di inserzione che utilizzano l'acquisto basato sui risultati, definito da un valore del campo billableOutcome pari a BILLABLE_OUTCOME_PAY_PER_CLICK o BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, e i relativi elementi pubblicitari secondari verranno archiviati.
Questa modifica interesserà le seguenti richieste:
Il tentativo di utilizzare advertisers.insertionOrders.create per creare un ordine di inserzione utilizzando l'acquisto basato sui risultati restituirà un errore 400
Dato che le risorse archiviate non sono incluse nelle richieste LIST per impostazione predefinita, le risorse interessate non verranno più restituite dai metodi advertisers.insertionOrders.list e advertisers.lineItems.list per impostazione predefinita.
Le opzioni di targeting ritirate verranno rimosse automaticamente dal targeting degli elementi pubblicitari esistenti. Questi valori saranno comunque disponibili per l'utilizzo nel targeting a livello di inserzionista.
Per evitare interruzioni del servizio, rimuovi questo targeting da tutti gli elementi pubblicitari YouTube e partner esistenti prima della data di ritiro.
Segmenti di pubblico proprietari e di terze parti Oracle
30 settembre 2024
Il 30 settembre 2024, le origini delle risorse FirstAndThirdPartyAudience di Oracle verranno ritirate. Al termine del ritiro, questi segmenti di pubblico verranno rimossi da qualsiasi targeting delle risorse e segmento di pubblico combinato esistenti. Se un elemento pubblicitario ha come target solo segmenti di pubblico ritirati o ha come target negativo segmenti di pubblico ritirati, questo aggiornamento metterà automaticamente in pausa l'elemento pubblicitario.
Per evitare interruzioni del servizio, identifica e rimuovi tutti i segmenti di pubblico Oracle dal targeting per segmento di pubblico e dai segmenti di pubblico combinati delle voci di inventario esistenti prima della data di ritiro.
Targeting ottimizzato a livello di elemento pubblicitario per un sottoinsieme di strategie di offerta
Per evitare interruzioni del servizio, aggiorna e verifica che gli elementi pubblicitari che utilizzano queste strategie di offerta non abbiano attivato il targeting ottimizzato.
Periodo di pubblicazione/Appena possibile Pacing per gli ordini di inserzione
5 novembre 2024
A partire dal 5 novembre 2024, PACING_TYPE_ASAP non sarà più compatibile con PACING_PERIOD_FLIGHT quando si imposta il campo pacing dell'ordine di inserzione. Il pacingType per tutti gli ordini di inserzione esistenti con questa configurazione verrà aggiornato a PACING_TYPE_AHEAD.
Per evitare interruzioni del servizio, aggiorna il pacing di tutti gli ordini di inserimento esistenti utilizzando PACING_TYPE_ASAP e PACING_PERIOD_FLIGHT.
Periodo della quota limite superiore a 30 giorni
28 febbraio 2025
Il 28 febbraio 2025:
Le richieste di creazione o aggiornamento delle risorse LineItem, InsertionOrder e Campaign per utilizzare un oggetto FrequencyCap con un campo timeUnit impostato su TIME_UNIT_LIFETIME o un campo timeUnit impostato su TIME_UNIT_MONTH e un campo timeUnitCount impostato su 2 restituiranno un errore 400.
Le voci nei file di dati strutturati Elemento pubblicitario, Ordine di inserzione e Campagna con il valore della colonna "Periodo di frequenza" impostato su "Lifetime" (Durata) o con il valore della colonna "Periodo di frequenza" impostato su "Months" (Mesi) e il valore della colonna "Importo frequenza" impostato su "2" non verranno create o aggiornate al caricamento del file.
Le campagne, gli ordini di inserzione e gli elementi pubblicitari esistenti verranno aggiornati in modo da utilizzare un periodo di quota limite di 30 giorni o meno.
Per evitare interruzioni del servizio:
Aggiorna le risorse esistenti di campagne, ordini di inserzione ed elementi pubblicitari che utilizzano un periodo di quota limite superiore a 30 giorni in modo che sia pari o inferiore a 30 giorni.
Verifica che l'integrazione non imposti un periodo di quota limite superiore a 30 giorni durante la creazione o l'aggiornamento delle risorse di campagne, ordini di inserzione o elementi pubblicitari utilizzando l'API Display & Video 360 o i file di dati strutturati.
Targeting ottimizzato per gli elementi pubblicitari che utilizzano l'offerta fissa
Le voci nei file di dati strutturati Elemento pubblicitario con il valore della colonna "Tipo di strategia di offerta" impostato su "Fissa" e il valore della colonna "Targeting ottimizzato" impostato su "Vero" non verranno create o aggiornate al caricamento del file.
Gli elementi pubblicitari esistenti che utilizzano l'offerta fissa verranno aggiornati per disattivare il targeting ottimizzato.
Per evitare interruzioni del servizio:
Aggiorna le risorse degli elementi pubblicitari esistenti che utilizzano sia l'offerta fissa che il targeting ottimizzato.
Verifica che l'integrazione non imposti una strategia di offerta fissa e un targeting ottimizzato quando crei o aggiorni le risorse degli elementi pubblicitari utilizzando l'API Display & Video 360 o i file di dati strutturati.
Aggiornamento delle dimensioni della pagina predefinite di firstAndThirdPartyAudiences.list
6 marzo 2025
Il 6 marzo 2025, la dimensione della pagina predefinita per le richieste firstAndThirdPartyAudiences.list verrà aggiornata da 100 a 5000.
Per evitare un'interruzione del servizio, aggiorna l'integrazione in modo da impostare il parametro di query pageSize delle richieste firstAndThirdPartyAudiences.list sulla dimensione di pagina che preferisci.
Nuovo errore di mancata corrispondenza tra partner/inserzionista sdfdownloadtasks.create
Limitazioni degli elementi pubblicitari per la copertura di YouTube nel formato SDF
24 marzo 2025
A partire dal 24 marzo 2025, i file di dati strutturati richiederanno l'utilizzo di formati degli annunci più ampi durante la creazione o l'aggiornamento degli elementi pubblicitari. Ciò significa che:
I file SDF v6 e v7 non supportano più la creazione di nuove voci di file dell'elemento pubblicitario con il valore "Copertura" di Subtype.
Le nuove voci nei file Elemento pubblicitario SDF con il valore Subtype "Copertura" devono utilizzare un valore "Responsive" nella colonna TrueView Video Ad Formats. Le voci esistenti con il valore "Copertura" di Subtype non possono aggiornare il valore della colonna TrueView Video Ad Formats.
Le nuove voci nei file SDF Elemento pubblicitario con il valore Subtype "Copertura" richiedono il completamento della colonna TrueView Video Ad Inventory Control.
Algoritmo di offerta personalizzata e attività Floodlight non corrispondenti
I valori nei file di dati strutturati Elemento pubblicitario che tentano di aggiornare la colonna "ID attività Floodlight di conversione" quando la colonna "ID algoritmo" è impostata non verranno aggiornati al caricamento del file.
Per evitare interruzioni del servizio, aggiorna l'integrazione a:
Verifica che le attività Floodlight pertinenti siano assegnate a un elemento pubblicitario prima o contemporaneamente all'assegnazione di un algoritmo di offerta personalizzata.
Gli algoritmi di offerta personalizzata esistenti vengono annullati da tutti gli elementi pubblicitari prima di tentare l'aggiornamento.
Il 7 aprile 2025, le risorse FirstAndThirdPartyAudience non consentiranno più una durata illimitata dell'appartenenza al pubblico. Le richieste firstAndThirdPartyAudiences.create e firstAndThirdPartyAudiences.patch che impostano il valore del campo membershipDurationDays su 10.000 restituiranno un errore 400. I segmenti di pubblico esistenti con un valore del campo membershipDurationDays pari a 10.000 verranno aggiornati a 540 e la nuova durata dell'abbonamento verrà applicata retroattivamente agli abbonamenti esistenti. In questo modo, tutte le inclusioni più vecchie di 540 giorni scadranno.
Per evitare interruzioni del servizio:
Verifica che l'integrazione non imposti il valore del campo membershipDurationDays dei segmenti di pubblico nuovi o esistenti su 10.000.
Aggiorna regolarmente le iscrizioni ai segmenti di pubblico Customer Match per assicurarti che le dimensioni degli elenchi dei tuoi segmenti di pubblico non si riducano involontariamente.
Campagne video per azione nei file di dati strutturati
22 aprile 2025
Il 22 aprile 2025 non potrai più creare elementi pubblicitari per le campagne video per azione utilizzando i file di dati strutturati, in quanto è in corso l'upgrade a Demand Gen. I tentativi di caricamento delle voci degli elementi pubblicitari con un valore della colonna Subtype "Azione" e un valore della colonna Type "TrueView" non andranno a buon fine.
Per evitare interruzioni del servizio, aggiorna l'integrazione in modo da utilizzare Demand Gen anziché le campagne video per azione.
Richiedere l'origine dell'inventario dei partner video per gli elementi pubblicitari Demand Gen nei file di dati strutturati
22 aprile 2025
A partire dal 22 aprile 2025, dovrai includere il valore "Partner video" nella colonna TrueView Inventory Source Targeting delle voci elemento pubblicitario che hanno un valore della colonna Type pari a "Demand Gen". Una volta iniziato l'applicazione, il valore verrà compilato per gli elementi pubblicitari esistenti e incluso durante il download dei nuovi file di dati strutturati.
Per evitare interruzioni del servizio:
Aggiorna l'integrazione in modo da includere il valore "Partner video" in tutte le voci degli elementi pubblicitari Demand Gen.
Aggiorna l'integrazione per gestire le origini dell'inventario Demand Gen a livello di gruppo di annunci utilizzando le colonne Gruppo di annunci SDF v8.1Demand Gen Inventory Source Strategy e Demand Gen Enabled Inventory Sources.
Colonna "Moltiplicatori di offerta" nei file di dati strutturati delle voci di inventario
1° maggio 2025
Il 1° maggio 2025, le voci nei file di dati strutturati Elemento pubblicitario che tentano di impostare la colonna "Moltiplicatori di offerta" non riusciranno a creare o aggiornare la risorsa al caricamento del file.
Impostazioni delle categorie di contenuti per gli elementi pubblicitari YouTube e partner
12 giugno 2025
Il 12 giugno 2025, le configurazioni delle categorie di contenuti per i singoli elementi pubblicitari YouTube e partner non saranno più modificabili a livello di elemento pubblicitario nell'ambito di un aggiornamento dell'esperienza di idoneità al brand. Le impostazioni delle categorie di contenuti verranno invece controllate esclusivamente a livello di inserzionista. Per adattarsi a questa modifica, verranno apportate le seguenti modifiche all'API Display & Video 360 e ai file di dati strutturati:
Interrompi la modifica della colonna TrueView Content Filter durante l'aggiornamento delle voci dell'elemento pubblicitario SDF. Lascia vuota la colonna quando crei nuovi elementi pubblicitari.
Aggiornamenti del budget degli elementi pubblicitari con l'ottimizzazione dell'ordine di inserzione
12 giugno 2025
A partire dal 12 giugno 2025, non potrai più aggiornare le impostazioni del budget per gli elementi pubblicitari con ordini di inserzione principali impostati per l'ottimizzazione tramite strategie di offerta automatiche.
In SDF: controlla se la voce SDF per l'ordine di inserzione principale dell'elemento pubblicitario ha la colonna Insertion Order Optimization impostata su TRUE. In questo caso, non tentare di aggiornare le colonne Budget Type o Budget Amount per la voce SDF elemento pubblicitario.
Limitazioni del sito per i file di dati strutturati
12 giugno 2025
A partire dal 12 giugno 2025, rimuoveremo una limitazione esistente per gli URL di destinazione nelle voci SDF che impediva l'inclusione dei siti più recenti. Al contrario, SDF corrisponderà al comportamento dell'API e della UI e consentirà il targeting degli URL purché siano formattati correttamente.
Dichiarare se gli elementi pubblicitari pubblicano annunci politici dell'UE
8 settembre 2025
A partire dall'8 settembre 2025, quando crei un nuovo elemento pubblicitario utilizzando l'API Display & Video 360 o i file SDF, dovrai dichiarare se l'elemento pubblicitario pubblicherà o meno annunci politici dell'Unione Europea. Queste dichiarazioni possono essere effettuate nei seguenti modi:
Utilizzando la colonna Contains EU Political Ads nel tipo di file elemento pubblicitario SDF v9.
Se l'inserzionista principale non conterrà elementi pubblicitari che pubblicano annunci politici dell'UE, puoi dichiararlo a livello di inserzionista utilizzando il campo containsEuPoliticalAds nella risorsa API Display & Video 360 Advertiser. Se questo campo è impostato su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, a tutti i nuovi elementi pubblicitari dell'inserzionista verrà assegnato lo stesso valore, se non diversamente specificato, e tutti gli elementi pubblicitari esistenti dell'inserzionista verranno aggiornati in modo da utilizzare lo stesso valore, se non è già impostato. La dichiarazione di un elemento pubblicitario può essere aggiornata in qualsiasi momento dopo la creazione utilizzando l'interfaccia utente, l'API o SDF.
Se non puoi dichiarare a livello di inserzionista o hai dichiarato che gli annunci politici dell'UE potrebbero essere pubblicati nel tuo inserzionista, aggiorna l'integrazione dell'API Display & Video 360 e di SDF prima dell'8 settembre 2025 per evitare un'interruzione del servizio:
Esegui la migrazione per utilizzare i file di dati strutturati versione 9 e imposta la colonna Contains EU Political Ads per tutti i nuovi elementi pubblicitari su Yes o No al momento del caricamento. Consulta la nostra guida alla migrazione alla versione 9 per istruzioni passo passo.
Prima di aggiornare il targeting geografico per un elemento pubblicitario esistente utilizzando l'API Display & Video 360 o il file SDF, aggiorna l'elemento pubblicitario per fornire una dichiarazione.
Gestione del targeting di ordini di inserzione e campagne nell'API Display & Video 360 e nei file di dati strutturati
Febbraio 2026
A febbraio 2026, Display & Video 360 ritirerà il targeting a livello di ordine di inserzione e campagna. Per allinearsi a questa modifica, verranno apportate modifiche all'API Display & Video 360 e ai file di dati strutturati (SDF). Nell'API Display & Video 360, un sottoinsieme di metodi verrà ritirato e restituirà un errore se chiamato. In SDF, le colonne di targeting nei file Ordine di inserzione e Campagna non verranno più compilate durante il download e dovranno essere vuote durante il caricamento. È consigliabile che gli utenti assegnino il targeting direttamente agli elementi pubblicitari al momento della loro creazione.
Se chiamati, i seguenti metodi dell'API Display & Video 360 restituiranno un errore 404:
