Annunciati ritiri

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

I ritiri e le date di ritiro dell'API verranno annunciati anche sul blog per gli 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. Le aggiunte di funzionalità potrebbero comunque essere rilasciate per questa versione.
  • Ritiro: la versione viene 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. Le aggiunte di funzionalità non verranno più rilasciate per questa versione.
  • Ritiro: la versione non è più supportata. Le richieste effettuate alla versione restituiscono un errore.

Nella tabella che segue sono elencate tutte le versioni principali dell'API Display & Video 360 esistenti, le relative date di rilascio e le date di ritiro e ritiro, se annunciate.

Versione API Data di uscita Data di deprecazione Data di ritiro Guida alla migrazione
v3 31 ottobre 2023
v2 6 dicembre 2022 15 febbraio 2024 3 settembre 2024 Eseguire la migrazione dalla versione 2 alla v3
v1 9 marzo 2020 13 marzo 2023 14 settembre 2023 Eseguire la migrazione da v1 a v2

Funzionalità deprecate

Segui il nostro blog per gli sviluppatori di Google Ads per non perderti gli annunci relativi al imminente ritiro di funzionalità significative.

La tabella seguente elenca tutti i ritiri di funzionalità annunciati, fornendo la data di validità iniziale e una descrizione del ritiro con le azioni consigliate e i link alla documentazione pertinente:

Selezione delle Data di validità iniziale Descrizione
Espansione del targeting 25 marzo 2023 La 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.
Attivatori manuali 17 maggio 2023

Spostamenti:

  • 17 maggio 2023: gli elementi pubblicitari che utilizzano attivatori manuali non verranno più pubblicati 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 di enumerazione LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER nell'API DV360 v1 e il campo LineItemFlight.triggerId nell'API DV360 v1 verrà ritirato. 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 che utilizzano gli attivatori manuali.
Tipi di app installata e nuovi dispositivi mobili GoogleAudience 20 maggio 2023

Spostamenti:

  • 20 maggio 2023: non potrai più assegnare risorse GoogleAudience con GoogleAudienceType GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS o GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES al targeting per pubblico di elementi pubblicitari o ordini di inserzione. Le richieste che assegnano 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 suo targeting per pubblico.
  • 8 giugno 2023: i segmenti di pubblico interessati verranno rimossi da tutti i targeting degli elementi pubblicitari e degli ordini di inserzione e da tutti i segmenti di pubblico combinati. Se un elemento pubblicitario non può pubblicare annunci quando questi segmenti di pubblico vengono rimossi, vengono messi in pausa. In questa data, questi segmenti di pubblico non potranno più essere recuperati utilizzando il servizio googleAudiences.

Attività consigliate:

  • Ti consigliamo di interrompere immediatamente l'utilizzo dei segmenti di pubblico interessati quando aggiorni in futuro il targeting degli elementi pubblicitari.
  • Rimuovi tutti i segmenti di pubblico interessati dal targeting esistente degli elementi pubblicitari e degli ordini di inserzione. Scopri come aggiornare il targeting per pubblico nella nostra guida sui segmenti di pubblico di destinazione.
Tipi di FirstAndThirdPartyAudience basati sull'attività e di quota limite 20 maggio 2023

Spostamenti:

  • 20 maggio 2023: non potrai più assegnare risorse FirstAndThirdPartyAudience con AudienceType ACTIVITY_BASED o FREQUENCY_CAP al targeting per pubblico di elementi pubblicitari o ordini di inserzione. Le richieste che assegnano 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 suo targeting per pubblico.
  • 8 giugno 2023: i segmenti di pubblico interessati verranno rimossi da tutti i targeting degli elementi pubblicitari e degli ordini di inserzione e da tutti i segmenti di pubblico combinati. Se un elemento pubblicitario non può pubblicare annunci quando questi segmenti di pubblico vengono rimossi, vengono messi in pausa. In questa data, questi segmenti di pubblico non potranno più essere recuperati utilizzando il servizio firstAndThirdPartyAudiences.

Attività consigliate:

  • Ti consigliamo di interrompere immediatamente l'utilizzo dei segmenti di pubblico interessati quando aggiorni in futuro il targeting degli elementi pubblicitari.
  • Rimuovi tutti i segmenti di pubblico interessati dal targeting esistente degli elementi pubblicitari e degli ordini di inserzione. Scopri come aggiornare il targeting per pubblico nella nostra guida sui segmenti di pubblico di destinazione.
Limiti di quota delle API esistenti 30 maggio 2023

Il 30 maggio 2023, i limiti di utilizzo esistenti verranno sostituiti con una struttura di quote ibrida che:

  1. Elimina la quota di richieste al giorno per progetto.
  2. Istituisce una quota di richieste al minuto per inserzionista per progetto per i metodi idonei.

Questi nuovi limiti consentiranno una maggiore flessibilità nell'utilizzo delle API e consentiranno il caricamento in contemporanea delle richieste tra gli inserzionisti. I dettagli di questa modifica sono disponibili nella nostra documentazione esistente sui limiti di quota.

Utilizzo dell'operatore OR tra le limitazioni di campi diversi nei filtri LIST

21 giu 2023

Il 21 giugno 2023, i parametri filter della richiesta LIST non consentiranno più l'utilizzo degli operatori logici OR tra 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 restrizioni degli operatori logici, consulta la nostra guida illustrativa al filtro delle richieste LIST.

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

Possibilità di filtrare o ordinare le richieste di elenco 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ù accettati i campi rispettivamente nei parametri di query advertisers.insertionOrders.list e advertisers.lineItems.list filter e orderBy. Dopo questa data, le richieste che utilizzano questi campi nei parametri di query filter e orderBy restituiranno un errore.

Per evitare interruzioni del servizio, rimuovi tutta la logica di filtro e ordine utilizzando questi due campi prima del 21 giugno 2023.

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

Il 21 giugno 2023, advertisers.lineItems.list non supporterà più i filtri in base ai seguenti campi:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Per evitare interruzioni del servizio, rimuovi tutta la logica dei filtri utilizzando questi quattro campi prima del 21 giugno 2023.

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, verranno archiviati e i relativi elementi pubblicitari secondari.

Questa modifica interesserà le seguenti richieste: