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/i 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 valori enum sono stati ritirati:

  Enum	Valori
  ReportType	INVENTORY_AVAILABILITY

• 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 a bassa affidabilità 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, che prevede l'inclusione solo dei dati con confidenza elevata. 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'attendibilità inferiore. (Valore predefinito 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 è 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 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 campi 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 queries.run asynchronous è 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	Metodo/i
  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 programmazione	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	synchronous

• 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 del filtro:

  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.