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:

    EnumValori
    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 filtroValori 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:

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

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.