Annunciati ritiri

In questa pagina sono elencate le date di ritiro e dismissione delle versioni dell'API e delle singole funzionalità nell'API Display & Video 360.

Le date di ritiro e dismissione dell'API verranno annunciate anche nel blog per sviluppatori di Google Ads.

Deprecazioni delle versioni

Le versioni dell'API Display & Video 360 vengono rilasciate, ritirate e dismesse regolarmente. Questi passaggi sono definiti come segue:

  • Release: la versione esce dallo stato alpha o beta ed è considerata stabile. Per la versione potrebbero comunque essere rilasciate nuove funzionalità.
  • Ritiro: la versione verrà ritirata e viene annunciata una data di fine del supporto (ritiro). Gli utenti devono eseguire la migrazione a una versione più recente prima della data di ritiro. Non verranno più rilasciate nuove funzionalità per la versione.
  • Disattivata: 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 ritiro definitivo, 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 imminenti ritiri di funzionalità importanti.

Questa tabella elenca tutte le funzionalità ritirate annunciate che interessano le versioni pubblicate, fornendo la data di validità iniziale e una descrizione del ritiro con i comportamenti consigliati e i link alla documentazione pertinente:

Funzionalità Data di validità iniziale Descrizione
Valori del nome e del logo dell'attività obbligatori per gli annunci adattabili di YouTube

Data di validità iniziale aggiornata

Gennaio 2027

A gennaio 2027, gli asset nome e logo dell'attività saranno obbligatori per gli annunci adattabili di YouTube se non è stato impostato un valore predefinito per l'inserzionista.

Di conseguenza, le colonne Business Name e Logo Asset IDs negli SDF Annuncio dovranno essere impostate per gli annunci di tipo "Adattabile" se non vengono assegnati valori predefiniti all'inserzionista principale. Se viene assegnato un valore predefinito e la colonna viene lasciata vuota, l'annuncio erediterà i valori predefiniti a livello di inserzionista al momento del salvataggio.

Ritiro dell'esclusione di categorie sensibili 1° ottobre 2026

A partire dal 1° ottobre 2026, non potrai più escludere la maggior parte delle categorie sensibili quando assegni il targeting degli elementi pubblicitari. Per supportare questa modifica, verranno apportate le seguenti modifiche all'API Display & Video 360 e ai file di dati strutturati:

  • I seguenti valori enum SensitiveCategory verranno ritirati e non saranno più accettati nel campo excludedSensitiveCategory dell'oggetto SensitiveCategoryAssignedTargetingOptionDetails quando si assegna il targeting di tipo TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
    • SENSITIVE_CATEGORY_ADULT
    • SENSITIVE_CATEGORY_ALCOHOL
    • SENSITIVE_CATEGORY_DEROGATORY
    • SENSITIVE_CATEGORY_DOWNLOADS_SHARING
    • SENSITIVE_CATEGORY_DRUGS
    • SENSITIVE_CATEGORY_GAMBLING
    • SENSITIVE_CATEGORY_POLITICS
    • SENSITIVE_CATEGORY_PROFANITY
    • SENSITIVE_CATEGORY_RELIGION
    • SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES
    • SENSITIVE_CATEGORY_SHOCKING
    • SENSITIVE_CATEGORY_SUGGESTIVE
    • SENSITIVE_CATEGORY_TOBACCO
    • SENSITIVE_CATEGORY_TRAGEDY
    • SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS
    • SENSITIVE_CATEGORY_VIOLENCE
    • SENSITIVE_CATEGORY_WEAPONS
  • La colonna Brand Safety Sensitivity Setting negli SDF Elemento pubblicitario non consentirà più l'opzione "Utilizza personalizzato".
  • La colonna Brand Safety Custom Settings negli SDF Elemento pubblicitario non sarà più supportata e verrà compilata con un valore vuoto al momento del download.
Ritiro dell'esclusione delle etichette contenuti digitali 1° ottobre 2026

A partire dal 1° ottobre 2026, non potrai più escludere determinate etichette contenuti digitali utilizzando il targeting. Per supportare questa modifica, verranno apportate le seguenti modifiche all'API Display & Video 360 e ai file di dati strutturati:

  • I seguenti valori enum ContentRatingTier verranno ritirati e non saranno più accettati nel campo excludedContentRatingTier dell'oggetto DigitalContentLabelAssignedTargetingOptionDetails quando viene assegnato il targeting di tipo TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
    • CONTENT_RATING_TIER_FAMILIES
    • CONTENT_RATING_TIER_GENERAL
    • CONTENT_RATING_TIER_MATURE
    • CONTENT_RATING_TIER_PARENTAL_GUIDANCE
    • CONTENT_RATING_TIER_TEENS
    • CONTENT_RATING_TIER_UNSPECIFIED
  • La colonna Digital Content Labels - Exclude negli SDF Elemento pubblicitario consente solo l'assegnazione dell'opzione "?", altrimenti la colonna deve essere vuota. Se provi ad assegnare un altro valore, si verificherà un errore durante il caricamento.
Nielsen come fornitore di terze parti che misura il brand lift 13 luglio 2026

A partire dal 13 luglio 2026, Nielsen non potrà più essere assegnato come fornitore di terze parti per la misurazione del brand lift. Per supportare questa modifica, verranno apportate le seguenti modifiche all'API Display & Video 360 e ai file di dati strutturati:

L'utilizzo esistente di Nielsen come fornitore di brand lift verrà rimosso.

Per evitare un'interruzione del servizio, rimuovi dall'integrazione qualsiasi assegnazione di Nielsen come fornitore di brand lift.

Ereditarietà del nome e del logo dell'attività predefiniti 13 luglio 2026

A partire dal 13 luglio 2026, gli annunci adattabili di YouTube inizieranno a supportare gli asset nome e logo dell'attività e tutti gli annunci Demand Gen e adattabili di YouTube con asset nome e logo dell'attività non impostati erediteranno i valori predefiniti impostati a livello di inserzionista. Allo stesso tempo, questa modifica comporterà le seguenti modifiche al comportamento dell'API Display & Video 360 e dei file di dati strutturati:

  • I campi businessName, logo e logoImages nelle risorse Demand Gen ad_details AdGroupAd non saranno più obbligatori se all'inserzionista principale vengono assegnati valori predefiniti. Se non viene fornito, l'annuncio erediterà le impostazioni predefinite a livello di inserzionista.
  • Le colonne Business Name e Logo Asset IDs negli SDF Annuncio potranno essere impostate per gli annunci con uno dei seguenti tipi: "Adattabile", "Prodotto Demand Gen", "Video Demand Gen", "Immagine Demand Gen" e "Carosello Demand Gen". Se queste colonne non sono impostate per una voce di annuncio pertinente e all'inserzionista principale sono assegnati valori predefiniti, l'annuncio erediterà i valori predefiniti a livello di inserzionista al momento del salvataggio.
  • Le colonne Business Name e Logo Asset IDs negli SDF Annuncio non sono più obbligatorie per gli annunci Demand Gen se l'inserzionista principale ha assegnato valori predefiniti.

Se i valori predefiniti sono impostati a livello di inserzionista, a tutti gli annunci di quell'inserzionista verranno assegnati un nome e un logo dell'attività. Se non vuoi impostare i valori degli asset nome e logo dell'attività per gli annunci adattabili di YouTube, non impostare valori predefiniti per l'inserzionista.

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. 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 al momento del download e dovranno essere vuote al momento del caricamento. Consigliamo agli utenti di assegnare il targeting direttamente agli elementi pubblicitari al momento della loro creazione.

I seguenti metodi dell'API Display & Video 360 restituiranno un errore 404 se chiamati:

Le voci SDF della campagna con valori assegnati 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 con valori assegnati 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
Dichiara 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 contiene 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à stato impostato. La dichiarazione di un elemento pubblicitario può essere aggiornata in qualsiasi momento dopo la creazione utilizzando la UI, l'API o l'SDF.

Se non puoi effettuare la dichiarazione a livello di inserzionista o hai dichiarato che gli annunci politici dell'UE possono essere pubblicati per il tuo inserzionista, aggiorna l'integrazione dell'API Display & Video 360 e dei file 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 nell'ambito di un aggiornamento dell'esperienza di idoneità al brand. Le impostazioni delle categorie di contenuti, invece, verranno controllate esclusivamente a livello di inserzionista. Per supportare 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 anziché il 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 degli elementi pubblicitari 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 utilizzando strategie di offerta automatica.

Per evitare interruzioni del servizio:
Limitazioni relative ai siti per i file di dati strutturati 12 giugno 2025

A partire dal 12 giugno 2025, rimuoveremo una limitazione esistente per il targeting per URL nelle voci SDF che impediva l'inclusione dei siti più recenti. Invece, SDF corrisponderà al comportamento dell'API e della UI e consentirà il targeting degli URL, purché siano formattati correttamente.

Questo è pertinente per le colonne Site Targeting - Include e Site Targeting - Exclude nei file Ordine di inserzione e Elemento pubblicitario.
Colonna "Moltiplicatori di offerta" nei file di dati strutturati degli elementi pubblicitari 1° maggio 2025

Il 1° maggio 2025, le voci nei file di dati strutturati degli elementi pubblicitari che tentano di impostare la colonna "Moltiplicatori di offerta" non riusciranno a creare o aggiornare la risorsa al caricamento del file.

Richiedi 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 "Video Partners" nella colonna TrueView Inventory Source Targeting delle voci degli elementi pubblicitari che hanno il valore "Demand Gen" nella colonna Type. Una volta iniziata l'applicazione, il valore verrà inserito retroattivamente per gli elementi pubblicitari esistenti e incluso durante il download di nuovi file di dati strutturati.

Per evitare interruzioni del servizio:

  • Aggiorna l'integrazione per 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 Demand Gen Inventory Source Strategy e Demand Gen Enabled Inventory Sources di SDF v8.1 Ad Group.
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, poiché 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.

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

Il 7 aprile 2025, le risorse FirstAndThirdPartyAudience non consentiranno più una durata inclusione nel segmento di pubblico infinita. 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 inclusione verrà applicata retroattivamente alle inclusioni esistenti. In questo modo, scadranno tutte le inclusioni risalenti a più di 540 giorni fa.

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 segmenti di pubblico non si riducano involontariamente.

Nella versione 4, questa modifica si riflette nelle risorse FirstPartyAndPartnerAudience.

Algoritmo di offerte personalizzate e attività Floodlight non corrispondenti 1° aprile 2025

Il 1° aprile 2025:

Per evitare interruzioni del servizio, aggiorna l'integrazione in modo da:

  • Verifica che le attività Floodlight pertinenti siano assegnate a un elemento pubblicitario prima o contemporaneamente all'assegnazione di un algoritmo di offerte personalizzate.
  • Gli algoritmi di offerte personalizzate esistenti vengono rimossi da tutti gli elementi pubblicitari prima di tentare l'aggiornamento.

Funzionalità deprecate in precedenza

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