Notes de version

Cette page fournit les notes de version de l'API Google Bid Manager.

Dernière version de l'API: v2

1er mars 2025

Nouvelles fonctionnalités

Problèmes connus

Abandon du rapport sur la disponibilité de l'inventaire YouTube TrueView et des dimensions associées, comme annoncé précédemment dans le Centre d'aide Display & Video 360.

v2

• Les valeurs d'énumération suivantes sont obsolètes:

  Énumération	Valeur(s)
  ReportType	INVENTORY_AVAILABILITY

• Les filtres suivants sont obsolètes:

  Valeur(s) du filtre

  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

• Les métriques suivantes sont obsolètes:

  Valeur(s) de la métrique
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

20 novembre 2024

Nouvelles fonctionnalités

L'FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID est lancé. Cela permet d'inclure des données à faible niveau de confiance pour les métriques avec les préfixes suivants:

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

L'une des métriques pertinentes doit être incluse lorsque vous utilisez ce filtre.

Au lancement, les requêtes qui n'incluent pas ce filtre reviendront au comportement par défaut précédent, qui consiste à n'inclure que les données à forte probabilité. À partir du 4 février 2025, les requêtes qui n'incluent pas ce filtre incluront par défaut des données moins fiables.

v2

• Les filtres suivants ont été ajoutés:

  Type de filtre	Valeurs disponibles
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: incluez les données à faible niveau de confiance. (Valeur par défaut après le 4 février 2025) 1: n'incluez que les données à forte probabilité. (Valeur par défaut avant le 4 février 2025)

1er octobre 2024

Nouvelles fonctionnalités

Aucune.

Problèmes connus

v2

Arrêt de la dimension de reporting "Modélisation d'inventaire anonyme"

La dimension FILTER_ANONYMOUS_INVENTORY_MODELING est "sunset".

La création ou l'exécution de ressources Query à l'aide de valeurs d'abandon dans params.groupBy renvoie une erreur 400.

Les métriques DST/ROC (coûts d'exploitation liés à la réglementation) et "Coût médias total" ne sont plus compatibles avec les rapports YOUTUBE.

Les valeurs de métrique suivantes ne peuvent plus être utilisées dans les rapports 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 création ou l'exécution de ressources Query avec un params.type de YOUTUBE et une valeur de métrique pertinente dans params.metrics renvoie une erreur 400.

1er mai 2024

Nouvelles fonctionnalités

Aucune.

Problèmes connus

v2

Abandon des rapports sur les chemins complets et l'attribution des chemins

Les rapports sur les chemins complets et l'attribution des chemins sont abandonnés. La récupération ou la création de ces types de ressources Query et Report entraîne une erreur.

Les valeurs ReportType suivantes sont abandonnées:

• FULL_PATH
• PATH_ATTRIBUTION

Le champ pathQueryOptions de l'objet Options est également abandonné.

28 février 2024

Nouvelles fonctionnalités

Aucune.

Problèmes connus

v2

Abandon des valeurs des métriques de conversion multi-appareils

Les métriques de conversion multi-appareils sont abandonnées. Les valeurs de métrique de l'API Bid Manager suivantes sont incluses:

• 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 juillet 2022

Nouvelles fonctionnalités

Publication de l'API Bid Manager v2.

Modifications structurelles apportées à l'API, y compris la mise à jour du point de terminaison du service et le renommage des services et des méthodes.

Mise à jour importante des ressources Query (Requête) et Report (Rapport) en supprimant les champs inutiles, en réorganisant les champs existants et en modifiant les types de champs. Cela inclut la modification des types de champs pour utiliser des objets nommés au lieu d'une définition générale d'objet imbriqué.

Exécution obligatoire de requêtes ad hoc à l'aide de la méthode queries.run au lieu de les exécuter automatiquement après leur création.

Remplacement du paramètre de requête asynchronous queries.run par synchronous.

Récupération simplifiée des rapports grâce aux modifications suivantes:

• Ajout d'une méthode queries.reports.get.
• Ajout d'un paramètre de requête orderBy à queries.reports.list.
• Mise à jour du corps de la réponse queries.run d'un objet vide en instance de la ressource Report générée.

Mise à jour des messages d'erreur renvoyés par l'API pour les rendre plus spécifiques et fournir des solutions plus prescriptives.

Suivez les instructions du guide de migration vers la version 2 pour passer de la version 1.1 à la version 2.

v2

• Le point de terminaison du service a été modifié:

  Point de terminaison de service v1	Point de terminaison de service v2
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• Les services ont été renommés comme suit:

  Service v1	Service v2
  Queries (Requêtes)	requêtes
  Rapports	queries.reports

• Les méthodes ont été rebaptisées comme suit:

  Méthode v1	Méthode 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

• Les méthodes suivantes ont été ajoutées:

  Service	Méthode(s)
  queries.reports	get

• Les méthodes suivantes ont un nouveau corps de réponse:

  Méthode	Nouvel objet corps de la réponse
  queries.run	Rapport

• Les champs suivants ont été supprimés :

  Ressource	Champ(s)
  Corps de la réponse queries.list	kind
  Corps de la réponse queries.reports.list	kind
  Query	kind reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• Le type d'objet des champs suivants a été modifié comme suit:

  Ressource	Champ(s)	Type d'objet
  Query	metadata params planning	QueryMetadata Paramètres QuerySchedule
  Rapport	key metadata params	ReportKey ReportMetadata Paramètres
  RunQueryRequest	dataRange	DataRange

• Les paramètres de requête de méthode suivants ont été ajoutés:

  Méthode	Paramètre(s) de requête
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	synchrone

• Les paramètres de requête de méthode suivants ont été supprimés:

  Méthode	Paramètre(s) de requête
  queries.create	asynchrone
  queries.run	asynchrone

• Les valeurs de filtre suivantes ont été ajoutées:

  Valeur du filtre
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• Les valeurs de filtre suivantes ont été supprimées:

  Valeur du filtre
  FILTER_TRUEVIEW_IAR_REGION

• Les valeurs de métrique suivantes ont été ajoutées:

  Valeur de métrique
  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

Problèmes connus

Aucune.

Versions précédentes

Pour en savoir plus sur les versions précédentes de l'API Bid Manager pour les versions abandonnées, consultez nos notes de version archivées.