Note di rilascio

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 a queries.reports.list.
• L'aggiornamento del corpo della risposta queries.run da un oggetto vuoto a un'istanza della risorsa Report 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:

  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 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 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 nel seguente modo:

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

• 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.