Annunciati ritiri

Sequenza temporale

• 17 maggio 2023: la pubblicazione degli elementi pubblicitari che utilizzano attivatori 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 1.0 e 2.0, il valore dell'enum LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER nell'API DV360 1.0 e il campo LineItemFlight.triggerId nell'API DV360 1.0 verranno ritirati. Dopo questa data, le richieste inviate 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 gli attivatori manuali.

Sequenza temporale

• 20 maggio 2023: non potrai più assegnare risorse GoogleAudience con un valore GoogleAudienceType pari a 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 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 tutti i 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 degli elementi pubblicitari.
• Rimuovi tutti i segmenti di pubblico interessati dal targeting degli elementi pubblicitari e degli ordini di inserzione esistenti. Scopri di più sull'aggiornamento del targeting per pubblico nella nostra guida sui segmenti di pubblico di destinazione.

Sequenza temporale

• 20 maggio 2023: non potrai più assegnare risorse FirstAndThirdPartyAudience con un valore AudienceType pari a ACTIVITY_BASED o FREQUENCY_CAP al targeting per 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 tutti i 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 degli elementi pubblicitari.
• Rimuovi tutti i segmenti di pubblico interessati dal targeting degli elementi pubblicitari e degli ordini di inserzione esistenti. Scopri di più sull'aggiornamento del targeting per pubblico nella nostra guida sui segmenti di pubblico di destinazione.

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

1. Elimina la quota di richieste giornaliere 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 attiveranno la parallellizzazione delle richieste tra gli inserzionisti. I dettagli di questa modifica sono disponibili nella documentazione esistente relativa al limite di quota.

A partire dal 21 giugno 2023, i parametri filter della richiesta LIST non consentiranno più di utilizzare gli operatori logici OR tra le limitazioni di campi diversi.

Ad esempio, le risorse identificate con la stringa filtro lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" devono essere recuperate utilizzando due richieste LIST con le seguenti stringhe filtro:

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

Consulta la nostra guida pratica su come filtrare le richieste LIST per ulteriori dettagli sulle limitazioni degli operatori logici.

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 un'interruzione del servizio.

Data di validità iniziale aggiornata

Il 21 giugno 2023, budget.budget_segments.date_range.end_date e flight.dateRange.endDate non saranno più campi accettati 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.

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

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

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

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

Il 1° agosto 2023, gli ordini di inserzione che utilizzano l'acquisto basato sui risultati, definiti 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
• Se si tenta di utilizzare advertisers.lineItems.create, advertisers.lineItems.duplicate o advertisers.lineItems.generateDefault per creare un elemento pubblicitario in un ordine di inserzione che utilizza l'acquisto basato sui risultati, verrà restituito un errore 400
• Poiché 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.

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

Il 30 settembre 2 del 2024, i seguenti valori per i tipi di targeting identificati non saranno più supportati per gli elementi pubblicitari YouTube e partner:

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION:
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION:
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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.

Il 30 settembre 2024, le origini risorse FirstAndThirdPartyAudience di Oracle verranno ritirate. Al termine del ritiro, questi segmenti di pubblico verranno rimossi da qualsiasi targeting per risorse esistente e dal segmento di pubblico combinato. Se un elemento pubblicitario ha come target solo i segmenti di pubblico ritirati o li ha come target esclusi, questo aggiornamento lo metterà automaticamente in pausa.

Per evitare interruzioni del servizio, identifica e rimuovi i segmenti di pubblico Oracle dal targeting per pubblico degli elementi pubblicitari esistenti e dai segmenti di pubblico combinati prima della data di ritiro.

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 per gli elementi pubblicitari che utilizzano queste strategie di offerta non sia attivato il targeting ottimizzato.

A partire dal 5 novembre 2024, PACING_TYPE_ASAP non sarà più compatibile con PACING_PERIOD_FLIGHT per l'impostazione del campo dell'ordine di inserzione pacing. Il valore 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 eventuali ordini di inserzione esistenti utilizzando PACING_TYPE_ASAP e PACING_PERIOD_FLIGHT.

Il 28 febbraio 2025:

• Le richieste di creazione o aggiornamento delle risorse LineItem, InsertionOrder e Campaign che utilizzano 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 "Lifetime" per la colonna "Periodo di frequenza" o il valore "Months" per la colonna "Periodo di frequenza" e il valore "2" per la colonna "Importo frequenza" 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 pari o inferiore a 30 giorni.

Per evitare interruzioni del servizio:

• Aggiorna le risorse di campagna, ordine di inserzione ed elemento pubblicitario esistenti 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 quando crei o aggiorni risorse di campagna, ordine di inserzione o elemento pubblicitario utilizzando l'API Display & Video 360 o i file di dati strutturati.

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 "Fissa" per la colonna "Tipo di strategia di offerta" e il valore "Vero" per la colonna "Targeting ottimizzato" non verranno create o aggiornate al caricamento del file.
• Gli elementi pubblicitari esistenti che utilizzano le offerte fisse verranno aggiornati per disattivare il targeting ottimizzato.

Per evitare interruzioni del servizio:

• Aggiorna le risorse degli elementi pubblicitari esistenti che utilizzano sia le offerte fisse sia il targeting ottimizzato.
• Verifica che l'integrazione non imposti una strategia di offerta fissa e un targeting ottimizzato quando crei o aggiorni le risorse elemento pubblicitario utilizzando l'API Display & Video 360 o i file di dati strutturati.

Il 6 marzo 2025, le dimensioni pagina predefinite per le richieste firstAndThirdPartyAudiences.list verranno aggiornate 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 sul numero di pagine che preferisci.

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

Il 1° aprile 2025:

• Le richieste advertisers.lineItems.create che tentano di impostare il campo floodlightActivityConfigs dell'oggetto ConversionCountingConfig e il campo customBiddingAlgorithmId degli oggetti MaximizeSpendBidStrategy o PerformanceGoalBidStrategy che non utilizzano attività Floodlight corrispondenti restituiranno un errore 400.
• Le richieste advertisers.lineItems.patch che tentano di aggiornare il campo floodlightActivityConfigs dell'oggetto ConversionCountingConfig quando è impostato il campo customBiddingAlgorithmId degli oggetti MaximizeSpendBidStrategy o PerformanceGoalBidStrategy restituiranno un errore 400.
• Le voci nei file di dati strutturati Elemento pubblicitario che tentano di aggiornare la colonna "ID attività Floodlight di conversione" quando è impostata la colonna "ID algoritmo" non verranno aggiornate al caricamento del file.
• Le richieste customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create, customBiddingAlgorithms.scripts.create per le risorse CustomBiddingAlgorithm assegnate a un elemento pubblicitario restituiranno un errore.

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

• 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 annullati da tutti gli elementi pubblicitari prima di tentare di aggiornarli.

A partire dal 7 aprile 2025, le risorse FirstAndThirdPartyAudience non consentiranno più la durata infinita 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 in modo retroattivo agli abbonamenti esistenti. In questo modo, tutte le inclusioni precedenti a 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 ai segmenti di pubblico Customer Match esistenti utilizzando firstAndThirdPartyAudiences.editCustomerMatchMembers.
• Aggiorna regolarmente le inclusioni nei segmenti di pubblico Customer Match per assicurarti che le dimensioni degli elenchi dei segmenti di pubblico non diminuiscano involontariamente.

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.