Note di rilascio

Questa pagina fornisce le note di rilascio dell'API Display & Video 360.

Versione API più recente: v3

22 ottobre 2024

Nuove funzionalità

È stato aggiunto il supporto per l'obiettivo di rendimento costo per visualizzazione.

È stata aggiunta la possibilità di impostare e recuperare il targeting dei dispositivi connessi.

Sono state aggiunte nuove impostazioni di sicurezza del brand di Adloox in Targeting per verificatori di terze parti.

È stato aggiunto il supporto per il download dei file di dati strutturati v8, attualmente in versione beta chiusa.

v3

Valori deprecati

È stato rimosso il supporto per SDF 5.5 in seguito al suo ritiro il 3 ottobre 2024.

v3

  • I seguenti valori enumerati sono stati ritirati:

    EnumValori
    SdfVersion

    SDF_VERSION_5_5

15 agosto 2024

Nuove funzionalità

È stato aggiunto il supporto per il tipo Netflix Exchange.

v3

v2

15 luglio 2024

Nuove funzionalità

Nella versione 3 è stato aggiunto il supporto per il download dei file di dati strutturati di elementi pubblicitari e gruppi di annunci in formato QA.

v3

17 giugno 2024

Nuove funzionalità

È stato aggiunto il supporto per la gestione del targeting per parole chiave assegnato a livello di inserzionista.

È stato aggiunto un nuovo campo optimizationObjective alla risorsa ordine di inserzione. optimizationObjective è disponibile solo per i clienti inclusi nella lista consentita.

v3

v2

30 maggio 2024

Nuove funzionalità

È stato aggiunto il supporto per la versione 7.1 dei file di dati strutturati (SDF).

v3

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    SdfVersion

    SDF_VERSION_7_1

v2

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    SdfVersion

    SDF_VERSION_7_1

23 aprile 2024

Nuove funzionalità

È stato aggiunto il supporto di nuovi tipi di KPI, piattaforme di scambio pubblicitario e piattaforme per app.

v3

v2

28 febbraio 2024

Nuove funzionalità

È stata aggiunta la possibilità di rimuovere esplicitamente i membri dai segmenti di pubblico Customer Match.

È stato aggiunto il supporto per il targeting di nuove piattaforme di scambio pubblicitario.

v3

v2

29 gennaio 2024

Nuove funzionalità

È stata aggiunta la possibilità di recuperare le attività Floodlight tramite un nuovo servizio floodlightGroups.floodlightActivities.

È stato aggiunto un nuovo campo che indica se un elemento pubblicitario YouTube e partner include l'inventario di Google TV nel targeting.

È stato aggiunto un nuovo campo per trasmettere l'ora dell'ultimo accesso di un utente Display & Video 360.

v3

v2

14 novembre 2023

Nuove funzionalità

È stato aggiunto il supporto per il trasferimento del consenso dell'utente finale durante il caricamento dei membri del segmento di pubblico di Customer Match in tutte le versioni pubblicate.

v3

v2

31 ottobre 2023

Nuove funzionalità

La versione 3 è stata spostata dalla versione beta pubblica alla disponibilità generale.

È stato rinominato un valore dell'enum AdGroupFormat nella versione 3 per riflettere con maggiore precisione il formato pertinente.

È stato aggiunto il supporto per i file di dati strutturati 7 con l'aggiunta del valore enumerato SDF_VERSION_7 nelle versioni 2 e 3.

v3

  • I seguenti valori enum sono stati rimossi:

    EnumValori
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    SdfVersion

    SDF_VERSION_7

2 ottobre 2023

Nuove funzionalità

È stata rilasciata la versione 3 in versione beta pubblica, che include le seguenti modifiche:

Segui i passaggi descritti nella nostra guida alla migrazione per eseguire la migrazione dalla versione 2 alla versione 3.

È stato aggiunto il supporto di tre nuovi valori LineItemType, un nuovo YoutubeAndPartnersBiddingStrategyType e un nuovo PartnerCostType nelle versioni 2 e 3.

v3

v2

25 agosto 2023

Nuove funzionalità

È stato aggiunto il supporto di due piattaforme di scambio pubblicitario e di due nuovi tipi di strategie di offerta YouTube e partner.

È stato aggiunto un nuovo campo effectiveContentCategory agli elementi pubblicitari YouTube e partner per visualizzare il valore YoutubeAndPartnersContentCategory utilizzato dall'elemento pubblicitario quando vengono presi in considerazione i valori assegnati sia a livello di inserzionista che di elemento pubblicitario.

v2

5 giugno 2023

Nuove funzionalità

È stato aggiunto un nuovo valore SdfVersion per la versione 6 dei File di dati strutturati (SDF) nelle versioni 1 e 2.

v2

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    SdfVersion

    SDF_VERSION_6

v1

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    SdfVersion

    SDF_VERSION_6

9 marzo 2023

Nuove funzionalità

È stato aggiunto un nuovo valore LineItemWarningMessage che verrà assegnato al campo warningMessages di un elemento pubblicitario se il campo excludeFirstPartyAudience deprecato è impostato su true. Il campo excludeFirstPartyAudience verrà ritirato e impostato su false dopo il 25 marzo 2023.

v2

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Sono stati aggiunti i seguenti valori enum:

    EnumValori
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 febbraio 2023

Nuove funzionalità

È stata aggiunta la possibilità di recuperare le risorse YouTubeAdGroup e YouTubeAdGroupAd, nonché il targeting per risorsa del gruppo di annunci di YouTube. Inoltre, abbiamo aggiunto nuovi tipi di targeting recuperabili utilizzati a livello di gruppi di annunci di YouTube. Per saperne di più, consulta la nuova pagina della guida sul recupero delle risorse di YouTube e partner.

È stato aggiunto il supporto di altri quattro piattaforme di scambio pubblicitario nelle versioni 1 e 2.

v2

v1

6 dicembre 2022

Nuove funzionalità

La versione 2 è stata spostata dalla versione beta pubblica alla disponibilità generale.

È stato aggiunto un nuovo campo assignedTargetingOptionIdAlias alla risorsa AssignedTargetingOption, che può essere utilizzato al posto di assignedTargetingOptionId per recuperare ed eliminare il targeting. Questo campo viene impostato solo per le opzioni di targeting assegnate dei tipi di targeting assegnati tramite enum. Il valore dell'alias è il valore dell'enum pertinente come stringa.

È stato aggiunto un nuovo campo billingConfig alla risorsa Advertiser.

È stato aggiunto il supporto per il recupero degli elementi pubblicitari over-the-top di YouTube e partner, identificati da tre nuovi valori LineItemType.

È stata aumentata la dimensione massima della pagina a 200 per numerosi metodi list nelle versioni v1 e v2. Le dimensioni della pagina predefinite rimangono invariate.

v2

v1

Problemi noti

Questo aggiornamento risolve i seguenti problemi noti nella versione 2:

27 ottobre 2022

È stata aggiunta la possibilità di duplicare un elemento pubblicitario esistente all'interno dell'elemento principale InsertionOrder.

È stato introdotto il supporto della scrittura del targeting per gli ordini di inserzione parziali per un sottoinsieme di tipi di targeting con l'aggiunta dei metodi create e delete al servizio advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Nuove funzionalità

v2

v1

Non sono state aggiunte nuove funzionalità alla versione 1.

20 settembre 2022

È stata rilasciata la versione 2 in versione beta pubblica, che include le seguenti modifiche:

Segui i passaggi descritti nella nostra guida alla migrazione per eseguire la migrazione dalla versione 1 alla versione 2.

È stato aggiunto il supporto di tre nuovi marketplace nella versione 1.

Nuove funzionalità

v2

Di seguito è riportato un elenco delle modifiche tra la versione 1 e la versione 2:

v1

26 maggio 2022

È stata aggiunta la possibilità di creare risorse InventorySource e gestire le risorse GuaranteedOrder tramite nuovi metodi di scrittura del servizio inventorySources e un nuovo servizio guaranteedOrders.

È stato introdotto il campo modelReadiness nella risorsa CustomBiddingAlgorithm. Questo campo elenca l'idoneità del modello dell'algoritmo per ogni inserzionista che può accedervi.

È stata attivata la nuova funzionalità del parametro di query filter per il metodo advertisers.creatives.list che consente all'utente di recuperare solo le creatività con un updateTime prima o dopo un determinato timestamp.

È stato aggiunto il supporto per la versione SDF più recente, v5.5, tramite l'aggiunta di un valore enum SdfVersion.

Nuove funzionalità

31 marzo 2022

È stato aggiunto il supporto per il recupero e l'impostazione del targeting in base a durata dei contenuti, tipo di stream e genere.

È stato aggiunto il campo billableOutcome all'oggetto InsertionOrder.

È stato introdotto il campo raiseBidForDeals nell'oggetto MaximizeSpendBidStrategy, che consente agli utenti di impostare se la strategia di offerta applica i prezzi minimi dell'inserzionista per i deal scelti come target.

Nuove funzionalità

2 febbraio 2022

È stato aggiunto il supporto per la creazione, l'aggiornamento e la modifica dei membri di determinate risorse Customer Match FirstAndThirdPartyAudience. La pagina Carica segmenti di pubblico Customer Match della nostra nuova guida all'utilizzo dei segmenti di pubblico illustra in dettaglio come utilizzare queste nuove funzionalità.

È stato introdotto un nuovo campo reservationType nelle risorse InsertionOrder e LineItem che indica se una risorsa è garantita da tag, programmaticamente garantita o non garantita.

È stata aggiunta la possibilità di recuperare e impostare se un elemento pubblicitario sceglie automaticamente come target nuove piattaforme di scambio pubblicitario tramite un nuovo campo excludeNewExchanges.

Oltre alle nuove funzionalità, i limiti di quota predefiniti sono stati raddoppiati.

Nuove funzionalità

8 dicembre 2021

È stato aggiunto il supporto per il targeting per tipo di contenuti audio nel tipo di targeting TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Nuove funzionalità

8 novembre 2021

È stato aggiunto il supporto completo per la gestione degli algoritmi di offerta personalizzata e dei relativi script. È incluso quanto segue:

È stata aggiunta una nuova pagina Implementare le offerte personalizzate alla nostra guida Gestire gli elementi pubblicitari che descrive la procedura per creare un algoritmo di offerte personalizzate, caricare uno script e assegnare l'algoritmo di offerte personalizzate come strategia di offerta di un elemento pubblicitario.

È stato aggiunto il supporto per la versione SDF più recente, v5.4, tramite l'aggiunta di un valore enum SdfVersion.

Nuove funzionalità

14 settembre 2021

È stato aggiunto il supporto per il targeting di prossimità nei tipi di targeting TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI.

È stata aggiunta la possibilità di cercare le opzioni di targeting disponibili per TARGETING_TYPE_BUSINESS_CHAIN e TARGETING_TYPE_POI utilizzando targetingTypes.targetingOptions.search, poiché non possono essere recuperate tramite i metodi targetingTypes.targetingOptions.get o targetingTypes.targetingOptions.list.

Sono stati introdotti nuovi campi sharedAdvertiserIds e customBiddingAlgorithmState nella risorsa Algoritmo delle offerte personalizzate e è stato aggiunto il supporto per il tipo di algoritmo delle offerte personalizzate GOAL_BUILDER_BASED.

Sono stati aggiunti due nuovi valori all'enum Exchange.

Nuove funzionalità

4 agosto 2021

È stato aggiunto il supporto per il targeting dell'inventario abilitato per Open Measurement nel tipo di targeting TARGETING_TYPE_OMID.

È stato aumentato il numero massimo di opzioni di targeting assegnate che possono essere restituite in una singola pagina di vari metodi di elenco di opzioni di targeting assegnate per inserzionista, campagna, ordine di inserzione ed elemento pubblicitario utilizzando il parametro del metodo pageSize.

Nuove funzionalità

26 maggio 2021

È stato lanciato il servizio advertisers.invoices, che consente agli utenti di:

  • recuperare le fatture emesse a un inserzionista durante un determinato mese.
  • Cerca il codice valuta utilizzato da un inserzionista in un determinato mese.

È stato aggiunto il campo campaignBudgets alla risorsa della campagna. I segmenti di budget degli ordini di inserzione possono essere collegati a un budget della campagna, limitando la somma del budget dei segmenti associati all'importo totale del budget della campagna.

È stato aggiunto il supporto per il targeting per posizione dei contenuti nativi nel nuovo tipo di targeting TARGETING_TYPE_NATIVE_CONTENT_POSITION.

È stato introdotto un nuovo campo prismaEnabled nella risorsa dell'inserzionista, che consente agli utenti di attivare l'integrazione con lo strumento Prisma di Mediaocean.

È stato attivato il supporto del valore dell'enum ENTITY_STATUS_PAUSED per il campo entityStatus dell'inserzionista.

Nuove funzionalità

29 aprile 2021

Sono stati aggiunti nuovi campi alle risorse Canale e Elenco di parole chiave escluse che restituiscono il conteggio degli elementi di riga che utilizzano la risorsa per il targeting. Sono state attivate nuove proprietà filter per il metodo elenco di elementi pubblicitari che consentono all'utente di recuperare solo gli elementi pubblicitari che utilizzano canali o elenchi di parole chiave escluse specifici nel targeting.

Nuove funzionalità

30 marzo 2021

È stato aggiunto un nuovo metodo al servizio degli elementi pubblicitari che genera un elemento pubblicitario con configurazioni predefinite. Questi valori predefiniti si basano sul tipo di elemento pubblicitario specificato, nonché sulle impostazioni e sul targeting assegnati all'ordine di inserzione principale.

È stato attivato il recupero del targeting della campagna tramite un nuovo servizio di targeting della campagna e un metodo aggiuntivo per gli elenchi collettivi.

Targeting per app ampliato per consentire il targeting delle app su più piattaforme.

Sono state apportate diverse modifiche ai servizi advertisers.channels.sites, partners.channels.sites e advertisers.negativeKeywordLists.negativeKeywords per consentire una gestione più facile dei contenuti dei canali e degli elenchi di parole chiave escluse. Queste modifiche includono:

  • L'aggiunta di metodi replace, che consente a un utente di sovrascrivere completamente i contenuti esistenti di un canale o di un elenco di parole chiave escluse.
  • La rimozione del requisito che nessun elemento esistente sia incluso nei campi createdSites o createdNegativeKeywords delle richieste di modifica collettiva.
  • L'aumento del numero massimo di elementi che possono essere restituiti in una singola pagina di una risposta elenca siti o elenca parole chiave escluse.

Nuove funzionalità

Deprecazioni

24 febbraio 2021

È stato introdotto un nuovo servizio di targeting per gli ordini di inserzione e un metodo aggiuntivo per gli elenchi collettivi che consente di recuperare il targeting assegnato agli ordini di inserzione. È stata espansa la risorsa creatività, aggiungendo campi della creatività solo per l'output da utilizzare per le creatività audio di terze parti. Sono stati aggiunti nuovi tipi di obiettivi di rendimento per l'utilizzo da parte delle risorse ordine di inserzione e campagna.

Nuove funzionalità

27 gennaio 2021

È stato attivato il recupero e la gestione degli ordini di inserzione TV e degli elementi pubblicitari over-the-top tramite l'introduzione di un nuovo campo InsertionOrderType e di un nuovo valore enumerato LineItemType. È stato aggiunto il supporto per gli elementi pubblicitari per app mobile tramite un campo elemento pubblicitario mobileApp. Supporto ampliato per piattaforme di scambio pubblicitario, segmenti di pubblico di Google e SDF tramite valori enumerati aggiuntivi. È stata introdotta la possibilità di filtrare e ordinare i valori advertisers.list in base all'ora dell'ultimo aggiornamento.

Nuove funzionalità

4 dicembre 2020

È stata aggiunta la possibilità di cercare opzioni di targeting per regione geografica e filtrare più risultati del metodo dell'elenco di risorse in base all'ora dell'ultimo aggiornamento. È stato introdotto un nuovo messaggio LineItemWarningMessage per informare gli utenti quando un elemento pubblicitario utilizza il targeting geografico deprecato.

Nuove funzionalità

5 novembre 2020

È stata aggiunta la possibilità di creare, assegnare e attivare attivatori manuali che avviano la spesa degli elementi pubblicitari associati. Sono state introdotte le opzioni di espansione del targeting che, se impostate, possono espandere il targeting di un elemento pubblicitario in modo da includere gli utenti simili a quelli dei segmenti di pubblico di destinazione. È stato aggiunto un campo ID segmento personalizzato agli oggetti DoubleVerify e Integral Ad Science utilizzati nel targeting per la verifica di terze parti.

Nuove funzionalità

12 ottobre 2020

Sono stati introdotti messaggi di avviso recuperabili nella risorsa elemento pubblicitario e un tipo di obiettivo di rendimento basato sulla percentuale di clic (CTR). È stato aggiunto warningMessages come campo filtrabile durante la visualizzazione degli elementi pubblicitari.

Oltre alle nuove funzionalità, sono ora in vigore nuovi limiti di quota ed è disponibile nuova documentazione sull'utilizzo delle richieste batch.

Nuove funzionalità

28 agosto 2020

Sono stati aggiunti nuovi campi alla risposta del metodo di controllo dell'inserzionista e nuovi campi filtrabili a vari metodi di elenco.

Nuove funzionalità

4 agosto 2020

Sono stati lanciati nuovi servizi di gestione degli utenti, dei partner e di targeting per i partner. Sono stati introdotti strumenti per aiutare gli utenti a evitare in modo proattivo di raggiungere i limiti di entità dell'account. È stato aggiunto il supporto per gli elementi pubblicitari audio e l'utilizzo di algoritmi di offerta personalizzata nelle strategie di offerta degli elementi pubblicitari e degli ordini di inserzione.

Nuove funzionalità

24 giugno 2020

È stato lanciato un piccolo aggiornamento che aggiunge un metodo di creazione per i canali partner e inserzionista, nuovi campi FirstAndThirdPartyAudience e valori enumerati exchange aggiuntivi.

Nuove funzionalità

2 giugno 2020

È stata introdotta la possibilità di creare, correggere e compilare un sottoinsieme di entità selezionabili e di modificare il targeting a livello di inserzionista per tre tipi di targeting: canale, esclusione di etichette di contenuti digitali ed esclusione di categorie sensibili.

Nuove funzionalità

27 aprile 2020

È stato lanciato un ampio insieme di funzionalità, che ha ampliato l'ambito dell'API oltre SDF. È stata aggiunta la gestione delle risorse di base che consente di creare, recuperare, aggiornare ed eliminare entità come inserzionisti, campagne, ordini di inserzione, elementi pubblicitari e creatività. Le nuove funzionalità consentono anche di modificare il targeting a livello di elemento pubblicitario.

Nuove funzionalità

Sono stati aggiunti i seguenti servizi:

ServizioMetodo o metodi
inserzionisti

create

elimina

get

elenco

patch

advertisers.assets

carica

advertisers.campaigns

create

elimina

get

elenco

patch

advertisers.channels

get

Elenco

advertisers.creatives

create

elimina

get

elenco

patch

advertisers.insertionOrders

create

elimina

get

elenco

patch

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

create

elimina

get

Elenco

patch

advertisers.lineItems.targetingTypes.assignedTargetingOptions

create

elimina

get

elenco

advertisers.locationLists

get

Elenco

advertisers.negativeKeywordLists

get

elenco

combinedAudiences

get

elenco

customLists

get

elenco

firstAndThirdPartyAudiences

get

Elenco

floodlightGroups

get

patch

googleAudiences

get

Elenco

inventorySourceGroups

get

Elenco

inventorySources

get

elenco

partners.channels

get

Elenco

partners.channels

get

Elenco

9 marzo 2020

È stata lanciata la versione 1 dell'API Display & Video 360. Questa è la versione iniziale dell'API.

Problemi noti

Nessuno.