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.

Deprecazioni delle versioni

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 viene 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.

Questa tabella elenca tutte le deprecazioni delle funzionalità annunciate che interessano le versioni live, fornendo la data di validità iniziale e una descrizione della deprecazione con azioni consigliate e link alla documentazione pertinente:

Funzionalità Data di validità iniziale Descrizione
Gestione del targeting di ordini di inserzione e campagne nell'API Display & Video 360 e nei file di dati strutturati 23 febbraio 2026

Il 23 febbraio 2026, Display & Video 360 ritirerà il targeting per ordine di inserzione e campagna. Verranno apportate modifiche all'API Display & Video 360 e ai file di dati strutturati (SDF) per allinearsi a questa modifica. Nell'API Display & Video 360, un sottoinsieme di metodi verrà ritirato e restituirà un errore se chiamato. Nei file Insertion Order e Campaign (Ordine di inserzione e Campagna) di SDF, le colonne di targeting non verranno più compilate al momento del download e dovranno essere vuote al momento del 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:

Le voci SDF Campaign a cui sono assegnati valori alle seguenti colonne non verranno caricate:

  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Environment Targeting

Le voci SDF Ordine di inserzione a cui sono assegnati valori alle seguenti colonne non verranno caricate:

  • Geography Targeting - Include
  • Geography Targeting - Exclude
  • Proximity Targeting
  • Proximity Location List Targeting
  • Language Targeting - Include
  • Language Targeting - Exclude
  • Device Targeting - Include
  • Device Targeting - Exclude
  • Browser Targeting - Include
  • Browser Targeting - Exclude
  • Digital Content Labels - Exclude
  • Brand Safety Sensitivity Setting
  • Brand Safety Custom Settings
  • Third Party Verification Services
  • Third Party Verification Labels
  • Channel Targeting - Include
  • Channel Targeting - Exclude
  • Site Targeting - Include
  • Site Targeting - Exclude
  • App Targeting - Include
  • App Targeting - Exclude
  • App Collection Targeting - Include
  • App Collection Targeting - Exclude
  • Category Targeting - Include
  • Category Targeting - Exclude
  • Content Genre Targeting - Include
  • Content Genre Targeting - Exclude
  • Keyword Targeting - Include
  • Keyword Targeting - Exclude
  • Keyword List Targeting - Exclude
  • Audience Targeting - Include
  • Audience Targeting - Exclude
  • Affinity & In Market Targeting - Include
  • Affinity & In Market Targeting - Exclude
  • Custom List Targeting
  • Inventory Source Targeting - Authorized Seller Options
  • Inventory Source Targeting - Include
  • Inventory Source Targeting - Exclude
  • Inventory Source Targeting - Target New Exchanges
  • Daypart Targeting
  • Daypart Targeting Time Zone
  • Environment Targeting
  • Viewability Omid Targeting Enabled
  • Viewability Targeting Active View
  • Position Targeting - Display On Screen
  • Position Targeting - Video On Screen
  • Position Targeting - Display Position In Content
  • Position Targeting - Video Position In Content
  • Position Targeting - Audio Position In Content
  • Video Player Size Targeting
  • Content Duration Targeting
  • Content Stream Type Targeting
  • Audio Content Type Targeting
  • Demographic Targeting Gender
  • Demographic Targeting Age
  • Demographic Targeting Household Income
  • Demographic Targeting Parental Status
  • Connection Speed Targeting
  • Carrier Targeting - Include
  • Carrier Targeting - Exclude
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 eseguire la dichiarazione 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 la UI, 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:

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.
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.

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.
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 elemento pubblicitario 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.

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

A partire dal 7 aprile 2025, le risorse FirstAndThirdPartyAudience non consentiranno più una durata illimitata dell'appartenenza al segmento di 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.

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

Ritiri di funzionalità precedenti

Per informazioni sui ritiri annunciati che interessano le versioni ritirate dell'API Display & Video 360, consulta i nostri ritiri archiviati.