Annunciati ritiri

Questa pagina elenca le date di ritiro e fine del ciclo di vita per le versioni dell'API e le singole funzionalità dell'API Display & Video 360.

I ritiri e le date di ritiro dell'API verranno annunciati anche sul blog per sviluppatori di Google Ads.

Ritiri delle versioni

Le versioni dell'API Display & Video 360 vengono rilasciate, ritirate e ritirate definitivamente a intervalli regolari. 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.

Versione API Data di uscita Data di deprecazione Data di ritiro Guida alla migrazione
v4 27 marzo 2025
v3 31 ottobre 2023 2 aprile 2025 7 ottobre 2025 Esegui la migrazione dalla versione 3 alla versione 4
v2 6 dicembre 2022 15 febbraio 2024 3 settembre 2024 Esegui la migrazione dalla versione 2 alla versione 3
v1 9 marzo 2020 13 marzo 2023 14 settembre 2023 Esegui la migrazione dalla versione 1 alla versione 2

Funzionalità deprecate

Segui il nostro blog per sviluppatori di Google Ads per gli annunci di ritiro di funzionalità importanti imminenti.

La tabella seguente elenca tutti i ritiri delle funzionalità annunciati, fornendo la data di entrata in vigore iniziale e una descrizione del ritiro con le azioni consigliate e i 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.
  • 1° agosto 2023: il servizio advertisers.manualTriggers nell'API DV360 v1 e v2, il valore enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER nell'API DV360 v1 e il campo LineItemFlight.triggerId nell'API DV360 v1 verranno ritirati. Dopo questa data, le richieste effettuate a questi servizi o a questi campi restituiranno un errore.

Azioni consigliate:

  • Interrompi immediatamente l'utilizzo degli attivatori manuali per avviare e interrompere la pubblicazione degli elementi pubblicitari.
  • Interrompi l'invio di richieste al servizio advertisers.manualTriggers.
  • Aggiorna i campi flight.flightDateType e flight.triggerId per tutti gli elementi pubblicitari utilizzando i trigger manuali.
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.
Tipi di quota limite e basati sull'attività FirstAndThirdPartyAudience 20 maggio 2023

Sequenza temporale

  • 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:

  1. Elimina la quota di richieste al giorno per progetto.
  2. 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 LIST della richiesta filter 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:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Per ulteriori dettagli sulle limitazioni degli operatori logici, consulta la nostra guida su come filtrare le richieste LIST.

Rivedi i parametri di query di tutte le chiamate filter esistenti LIST e verifica che utilizzino correttamente l'operatore logico OR prima del 21 giugno 2023 per evitare un'interruzione del servizio.

Possibilità di filtrare o ordinare le richieste di elenchi in base ai campi budget.budget_segments.date_range.end_date e flight.dateRange.endDate

Data di validità iniziale aggiornata

21 giu 2023

Il 21 giugno 2023, budget.budget_segments.date_range.end_date e flight.dateRange.endDate non saranno più campi accettati nei parametri di query advertisers.insertionOrders.list e advertisers.lineItems.list filter e orderBy, rispettivamente. Dopo questa data, le richieste che utilizzano questi campi nei parametri di query filter e orderBy restituiranno un errore.

Rimuovi tutta la logica di filtro e ordinamento che utilizza questi due campi prima del 21 giugno 2023 per evitare un'interruzione del servizio.

Possibilità di filtrare le richieste di advertisers.lineItems.list in base a quattro campi aggiuntivi 21 giu 2023

A partire dal 21 giugno 2023, advertisers.lineItems.list non supporterà più il filtro in base ai seguenti campi:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

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:

Campo publisherReviewStatuses nelle risorse creative 26 giugno 2024

A partire dal 26 giugno 2024, il campo publisherReviewStatuses verrà ritirato e sarà vuoto durante il recupero delle risorse Creative.

Targeting dei contenuti per gli elementi pubblicitari YouTube e partner 30 settembre 2024

Il 30 settembre 2024, i seguenti valori per i tipi di targeting identificati verranno ritirati per gli elementi pubblicitari YouTube e partner:

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 esistenti prima della data di ritiro.

Targeting ottimizzato a livello di elemento pubblicitario per un sottoinsieme di strategie di offerta 30 settembre 2024

Il 30 settembre 2024, le risorse LineItem che utilizzano un sottoinsieme di strategie di offerta non saranno più compatibili con il targeting ottimizzato. Con questa modifica, le risorse LineItem con targetingExpansion.enableOptimizedTargeting impostato su True e bidStrategy.maximizeSpendAutoBid.performanceGoalType impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN o BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED o bidStrategy.performanceGoalAutoBid.performanceGoalType impostato su BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM verranno aggiornate in modo da impostare targetingExpansion.enableOptimizedTargeting su False.

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 imposti 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 la pacing di tutti gli ordini di inserzione 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" (A vita) 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 di frequenza superiore a 30 giorni durante la creazione o l'aggiornamento di 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 6 marzo 2025

Il 6 marzo 2025:

  • Le richieste di creazione o aggiornamento delle risorse LineItem per impostare il campo BiddingStrategy fixedBid e il campo TargetingExpansionConfig enableOptimizedTargeting su true restituiranno un errore 400.
  • 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 della pagina che preferisci.

Nuovo errore di mancata corrispondenza tra partner/inserzionista sdfdownloadtasks.create 6 marzo 2025

Il 6 marzo 2025, le richieste sdfdownloadtasks.create che utilizzano un filtro entità principale per filtrare in base agli inserzionisti che non sono secondari dell'partnerId inizieranno a restituire un errore 400.

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 SDF Elemento pubblicitario 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 Elemento pubblicitario SDF con il valore Subtype &quotCopertura" richiedono il completamento della colonna TrueView Video Ad Inventory Control.
Algoritmo di offerta personalizzata e attività Floodlight non corrispondenti 1° aprile 2025

Il 1° aprile 2025:

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 personalizzato.
  • Gli algoritmi di offerta personalizzata esistenti vengono annullati da tutti gli elementi pubblicitari prima di tentare l'aggiornamento.

Durata inclusione infinita per i segmenti di pubblico proprietari 7 aprile 2025

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 le iscrizioni dei segmenti di pubblico Customer Match esistenti utilizzando firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • 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.

Nella versione 4, questa modifica è riportata nelle risorse FirstPartyAndPartnerAudience.

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, perché verrà eseguito 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 dell'elemento pubblicitario 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.1 Demand 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:

Per evitare interruzioni del servizio:
  • Recupera il campo effectiveContentCategory al posto del campo contentCategory quando esamini gli elementi pubblicitari YouTube e partner nell'API.
  • 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.

Per evitare interruzioni del servizio:
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.

Questo è pertinente alle colonne Site Targeting - Include e Site Targeting - Exclude nei file Ordine di inserzione ed Elemento pubblicitario.
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:

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 Advertiser dell'API Display & Video 360. 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 la UI, l'API o il formato 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: