Note di rilascio

Questa pagina fornisce le note di rilascio dell'API Google Bid Manager.

Ultima versione dell'API: v2

22 settembre 2025

Problemi noti

Ritiro di tre valori di enumerazione Filter a causa del basso utilizzo, come annunciato in precedenza nel Centro assistenza Display & Video 360.

v2

• I seguenti Filters sono stati ritirati:

  Valore o valori Filter
  FILTER_DFP_ORDER_ID FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER

1° marzo 2025

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 filtri sono stati ritirati:

  Valore o 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:

  Valore o valori della metrica
  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. Ciò consente l'inclusione di 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, le query che non includono questo filtro utilizzeranno il comportamento predefinito precedente, ovvero includere solo i dati con un'alta confidenza. A partire dal 4 febbraio 2025, le query che non includono questo filtro includeranno per impostazione predefinita dati con un livello di confidenza inferiore.

v2

• Sono stati aggiunti i seguenti filtri:

  Tipo di filtro	Valori disponibili
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: Includi dati con un livello di attendibilità inferiore. (Impostazione predefinita dopo il 4 febbraio 2025) 1: includi solo i dati con un'attendibilità elevata. (Impostazione predefinita prima del 4 febbraio 2025)

1° ottobre 2024

Nuove funzionalità

Nessuno.

Problemi noti

v2

Ritiro della dimensione dei report Modelli di inventario anonimo (AIM)

La dimensione FILTER_ANONYMOUS_INVENTORY_MODELING è stata ritirata.

La creazione o l'esecuzione di risorse Query utilizzando 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 sono state rese incompatibili 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 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 sono stati ritirati. Il recupero o la creazione di questi tipi di risorse Query e Report genera un errore.

I seguenti valori ReportType sono tramonto:

• FULL_PATH
• PATH_ATTRIBUTION

Anche il campo pathQueryOptions dell'oggetto Options è in fase di ritiro.

28 febbraio 2024

Nuove funzionalità

Nessuno.

Problemi noti

v2

Ritiro dei valori delle metriche di conversione cross-device

Le metriche di conversione cross-device sono state ritirate. 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 l'API Bid Manager v2.

Sono state apportate modifiche strutturali all'API, tra cui l'aggiornamento dell'endpoint del servizio e la ridenominazione di servizi e metodi.

Risorse Query e Report aggiornate in modo significativo tramite la rimozione di campi non necessari, la riorganizzazione di quelli esistenti e la modifica dei tipi di campi. Ciò include la modifica dei tipi di campi 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 queries.run è stato sostituito con synchronous.

Recupero semplificato dei report grazie alle seguenti modifiche:

• L'aggiunta di un metodo queries.reports.get.
• L'aggiunta di un parametro di query orderBy a queries.reports.list.
• L'aggiornamento del corpo della risposta queries.run da un oggetto vuoto a un'istanza della risorsa Report generata.

Aggiornati i messaggi di errore restituiti dall'API per essere più specifici e fornire soluzioni più prescrittive.

Segui le istruzioni riportate nella guida alla migrazione alla v2 per eseguire la migrazione dalla v1.1 alla v2.

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:

  Metodo v1	Metodo v2
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• Sono stati aggiunti i seguenti metodi:

  Servizio	Metodi
  queries.reports	get

• I seguenti metodi hanno un nuovo corpo della risposta:

  Metodo	Nuovo oggetto del corpo della risposta
  queries.run	Segnala

• Sono stati rimossi i seguenti campi:

  Risorsa	Campo/i
  queries.list Corpo della risposta	kind
  queries.reports.list Corpo della risposta	kind
  Query	kind reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• Il tipo di oggetto dei seguenti campi è stato modificato come segue:

  Risorsa	Campo/i	Tipo di oggetto
  Query	metadata params pianificazione	QueryMetadata Parametri QuerySchedule
  Segnala	chiave metadata params	ReportKey ReportMetadata Parametri
  RunQueryRequest	dataRange	DataRange

• Sono stati aggiunti i seguenti parametri di query del metodo:

  Metodo	Parametro o parametri di query
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	sincrono

• Sono stati rimossi i seguenti parametri di query del metodo:

  Metodo	Parametro o 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

• Sono stati rimossi i seguenti valori di filtro:

  Valore filtro
  FILTER_TRUEVIEW_IAR_REGION

• Sono stati aggiunti i seguenti valori delle metriche:

  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.