Questa pagina fornisce le note di rilascio dell'API Google Bid Manager.
Versione API più recente: v2
1° marzo 2025
Nuove funzionalità
Problemi noti
Ritiro del report sulla disponibilità dell'inventario TrueView di YouTube e delle dimensioni correlate, come annunciato in precedenza nel Centro assistenza Display & Video 360.
v2
I seguenti valori enumerati sono stati ritirati:
Enum Valori ReportType
INVENTORY_AVAILABILITY
I seguenti filtri sono stati ritirati:
Valori del filtro FILTER_DETAILED_DEMOGRAPHICS
FILTER_DETAILED_DEMOGRAPHICS_ID
FILTER_HOUSEHOLD_INCOME
FILTER_LIFE_EVENT
FILTER_REMARKETING_LIST
FILTER_TRUEVIEW_IAR_AGE
FILTER_TRUEVIEW_IAR_CATEGORY
FILTER_TRUEVIEW_IAR_CITY
FILTER_TRUEVIEW_IAR_COUNTRY
FILTER_TRUEVIEW_IAR_COUNTRY_NAME
FILTER_TRUEVIEW_IAR_GENDER
FILTER_TRUEVIEW_IAR_INTEREST
FILTER_TRUEVIEW_IAR_LANGUAGE
FILTER_TRUEVIEW_IAR_PARENTAL_STATUS
FILTER_TRUEVIEW_IAR_REGION_NAME
FILTER_TRUEVIEW_IAR_REMARKETING_LIST
FILTER_TRUEVIEW_IAR_TIME_OF_DAY
FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL
FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO
FILTER_TRUEVIEW_IAR_ZIPCODE
FILTER_YOUTUBE_CHANNEL
FILTER_YOUTUBE_VIDEO
Le seguenti metriche sono state ritirate:
Valori delle metriche METRIC_POTENTIAL_VIEWS
METRIC_TEA_TRUEVIEW_IMPRESSIONS
METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20 novembre 2024
Nuove funzionalità
FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
è stato lanciato. In questo modo è possibile includere
dati con un livello di confidenza inferiore per le metriche con i seguenti prefissi:
METRIC_UNIQUE_REACH_
METRIC_VIRTUAL_PEOPLE_DUPLICATE_
METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
METRIC_VIRTUAL_PEOPLE_OVERLAP_
Quando utilizzi questo filtro, devi includere una delle metriche pertinenti.
Al momento del lancio, per le query che non includono questo filtro verrà applicato il comportamento predefinito precedente, ovvero l'inclusione solo dei dati con un'elevata affidabilità. A partire dal 4 febbraio 2025, per impostazione predefinita le query che non includono questo filtro includeranno i dati con un livello di attendibilità inferiore.
v2
Sono stati aggiunti i seguenti filtri:
Tipo di filtro Valori disponibili FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID
0
: includi i dati con un'affidabilità inferiore. (valore predefinito dopo il 4 febbraio 2025)1
: includi solo dati con un'alta attendibilità. (valore predefinito prima del 4 febbraio 2025)
1° ottobre 2024:
Nuove funzionalità
Nessuno.
Problemi noti
v2
Ritiro della dimensione dei report Modellazione inventario anonimo (AIM)
La dimensione FILTER_ANONYMOUS_INVENTORY_MODELING
è in fase di ritiro.
La creazione o l'esecuzione di risorse Query
che utilizzano valori di ritiro in
params.groupBy
restituisce un errore 400
.
Le metriche relative ai costi operativi di natura regolamentare (ISD/ROC) e al costo totale dei media non saranno più compatibili con i report YOUTUBE
.
I seguenti valori delle metriche non possono più essere utilizzati nei report YOUTUBE
:
METRIC_TOTAL_MEDIACOST_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
METRIC_TOTAL_MEDIACOST_ECPAPC_USD
METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
METRIC_TOTAL_MEDIACOST_ECPAPV_USD
METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
METRIC_TOTAL_MEDIACOST_ECPA_USD
METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
METRIC_TOTAL_MEDIACOST_ECPCV_USD
METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
METRIC_TOTAL_MEDIACOST_ECPC_USD
METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
METRIC_TOTAL_MEDIACOST_ECPM_USD
METRIC_TOTAL_MEDIACOST_PARTNER
METRIC_TOTAL_MEDIACOST_USD
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
METRIC_FEE32_ADVERTISER
METRIC_FEE32_PARTNER
METRIC_FEE32_USD
La creazione o l'esecuzione di risorse Query
con un valore params.type
di YOUTUBE
e un valore della metrica pertinente in params.metrics
restituisce un errore 400
.
1° maggio 2024
Nuove funzionalità
Nessuno.
Problemi noti
v2
Ritiro dei report Percorso completo e Attribuzione percorso
I report Percorso completo e Attribuzione percorso non sono più disponibili. Il recupero o la creazione di questi tipi di risorse Query
e Report
genera un errore.
I seguenti valori
ReportType
sono
in fase di ritiro:
FULL_PATH
PATH_ATTRIBUTION
Anche il
campo
pathQueryOptions
dell'oggetto
Options
è stato ritirato.
28 febbraio 2024
Nuove funzionalità
Nessuno.
Problemi noti
v2
Ritiro dei valori delle metriche di conversione cross-device
Le metriche di conversione cross-device non sono più supportate. Sono inclusi i seguenti valori delle metriche dell'API Bid Manager:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 luglio 2022
Nuove funzionalità
È stata rilasciata la versione 2 dell'API Bid Manager.
Sono state apportate modifiche strutturali all'API, tra cui l'aggiornamento dell'endpoint del servizio e la ridenominazione di servizi e metodi.
Aggiornamento significativo delle risorse Query e Report tramite la rimozione di campi non necessari, la riorganizzazione di quelli esistenti e la modifica dei tipi di campo. Sono incluse le modifiche ai tipi di campo per utilizzare oggetti denominati anziché una definizione generale di "oggetto nidificato".
È necessario eseguire query ad hoc utilizzando il metodo queries.run
anziché eseguirle automaticamente dopo la creazione.
Il parametro di query asynchronous
di queries.run
è stato sostituito con
synchronous
.
Retrieval dei report semplificato tramite le seguenti modifiche:
- L'aggiunta di un metodo
queries.reports.get
. - L'aggiunta di un parametro di query
orderBy
aqueries.reports.list
. - L'aggiornamento del corpo della risposta
queries.run
da un oggetto vuoto a un'istanza della risorsaReport
generata.
I messaggi di errore restituiti dall'API sono stati aggiornati per essere più specifici e fornire soluzioni più prescriptive.
Segui le istruzioni riportate nella Guida alla migrazione alla versione 2 per eseguire la migrazione dalla versione 1.1 alla versione 2.
v2
L'endpoint di servizio è stato modificato:
Endpoint di servizio v1 Endpoint di servizio v2 https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
I servizi sono stati rinominati come segue:
Servizio v1 Servizio v2 Query query Report queries.reports I metodi sono stati rinominati come segue:
Sono stati aggiunti i seguenti metodi:
Servizio Metodo o metodi queries.reports get I seguenti metodi hanno un nuovo corpo di risposta:
Metodo Nuovo oggetto del corpo della risposta queries.run Report I seguenti campi sono stati rimossi:
Risorsa Campo/i queries.list
Corpo della rispostakind
queries.reports.list
Corpo della rispostakind
Query kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Il tipo di oggetto dei seguenti campi è stato modificato nel seguente modo:
Risorsa Campo/i Tipo di oggetto Query Report RunQueryRequest Sono stati aggiunti i seguenti parametri di query del metodo:
Metodo Parametri di query queries.list orderBy queries.reports.list orderBy queries.run sincrona I seguenti parametri di query del metodo sono stati rimossi:
Metodo Parametri di query queries.create asincrono queries.run asincrono Sono stati aggiunti i seguenti valori di filtro:
Valore filtro FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION I seguenti valori di filtro sono stati rimossi:
Valore filtro FILTER_TRUEVIEW_IAR_REGION Sono stati aggiunti i seguenti valori della metrica:
Valore metrica METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
Problemi noti
Nessuno.
Versioni precedenti
Per informazioni sulle release precedenti dell'API Bid Manager per le versioni ritirate, consulta le nostre note di rilascio archiviate.