Annonce de la version 24 de l'API Google Ads

Mercredi 22 avril 2026

Nous annonçons aujourd'hui la sortie de la version 24 de l'API Google Ads. Pour utiliser les nouvelles fonctionnalités de la v24, vous devez mettre à niveau vos bibliothèques clientes et votre code client. Toutes les bibliothèques clientes et tous les exemples de code mis à jour ont été publiés.

Rejoignez-nous pour une présentation en direct de cette version lors de notre événement "Google Ads API Release Highlights" sur Discord, de notre YouTube Live Ads Developers ou de notre événement LinkedIn Live demain (23 avril à 10h ET). Cette session sera également enregistrée et publiée sur YouTube pour les personnes qui ne peuvent pas assister aux événements en direct. Si vous avez des questions ou si vous souhaitez discuter de ce post, contactez-nous sur le canal #ads-api sur Discord.

Nouvelles fonctionnalités

Compatibilité avec les conversions avec les données du panier : les conversions avec les données du panier constituent une extension du suivi des conversions sur votre site Web ou application. Elles vous permettent de savoir quels sont les produits vendus lors de chaque transaction. Vous pouvez ainsi accéder à des ventes avancées, des rapports sur les bénéfices et des insights pour votre compte et vos campagnes Google Ads (par exemple, le nombre de commandes, la taille moyenne du panier, les revenus et la marge brute).

La version 24 de l'API Google Ads ajoute la prise en charge de cette fonctionnalité comme suit :

  • Ajout d'une nouvelle ressource CartDataSalesView qui permet de segmenter les métriques de conversion non seulement par clic sur un produit, mais aussi par produit vendu, avec des segments tels que product_sold_brand. Ils permettent aux annonceurs de consulter des statistiques sur les produits que les clients ont réellement achetés après avoir cliqué sur des annonces, même si l'annonce concernait un autre produit.
  • Ajout de plusieurs métriques non enchérissables "toutes", qui incluent également les conversions pour lesquelles vos campagnes ne sont pas activement optimisées (par exemple, all_cost_of_goods_sold_micros). Les nouvelles métriques sont ajoutées à toutes les ressources compatibles avec les métriques d'enchères correspondantes.
  • Ajout du segment conversion_attribution_event_type à la ressource ShoppingPerformanceView, ce qui permet de le sélectionner avec les données du panier et d'autres métriques de conversion. Ce segment indique si la conversion est attribuée à un clic ou à une vue. Il est nécessaire pour identifier les statistiques sur les données du panier générées par les conversions après affichage.

Fonctionnalités mises à jour

La version v24 introduit des mises à jour des fonctionnalités existantes qui nécessitent des modifications du code lors de la mise à niveau. Nous abordons ici les plus importants. Consultez les notes de version pour obtenir la liste complète des modifications.

Paramètres d'exclusion de contenu vidéo dans les campagnes : nous avons simplifié la définition des paramètres d'exclusion de contenu vidéo pour des campagnes individuelles. Ce paramètre est disponible au niveau du client et s'applique à toutes les campagnes. Ces paramètres d'exclusion de contenu sont destinés à vous offrir plus de contrôle. Ils vous permettent d'exclure des types de contenu qui, bien que conformes à nos règles, ne correspondent peut-être pas à votre marque ou à votre activité. Pour en savoir plus sur les paramètres d'exclusion de contenu vidéo, consultez https://support.google.com/google-ads/answer/7515513.

Modifications apportées à AudienceInsightsService : dans le cadre d'une refactorisation du code, nous avons déplacé le champ de requête InsightsAudience.topic_audience_combinations vers l'espace de noms common. Vous devrez peut-être mettre à jour vos directives d'importation dans certains langages de programmation.

Modifications apportées à ReachPlanService : dans le cadre d'une refactorisation du code, nous avons déplacé le champ youtube_select_lineups du service ReachPlanService.ListPlannableProducts. Les lineups sont désormais disponibles dans le champ youtube_select_lineup_targeting. Les lineups YouTube Select sont des produits proposés par réservation aux clients éligibles. Ils permettent de cibler le top 1 % des chaînes les plus populaires sur YouTube et les audiences les plus passionnées d'un marché donné. En savoir plus

Modifications apportées à ContentCreatorInsightsService : dans le cadre d'une refactorisation du code, nous avons supprimé le champ is_brand_connect_creator des services ContentCreatorInsightsService.GenerateCreatorInsights et ContentCreatorInsightsService.GenerateTrendingInsights.
Les utilisateurs doivent plutôt rechercher un créateur pour que l'option CREATOR_PARTNERSHIPS soit disponible dans partnership_opportunities. Dans Google Ads, l'outil YouTube Creator Partnerships vous permet de trouver des créateurs YouTube avec lesquels collaborer pour des contenus sponsorisés et de gérer efficacement vos partenariats avec des créateurs. En savoir plus

Modifications apportées à KeywordPlanIdeaService : nous avons unifié notre infrastructure de prévision pour offrir une expérience plus fluide et plus fiable. La version 24 de l'API Google Ads introduit une méthode GenerateKeywordForecastMetrics mise à jour qui simplifie le processus de planification en se concentrant sur les métriques qui ont l'impact le plus direct sur vos performances. Nous publierons un article de blog plus détaillé sur ce changement dans les prochains jours.

Modifications apportées à la ressource campaign_budget : nous avons supprimé le segment ad_sub_network_type de la ressource campaign_budget, car il n'est pas compatible avec cette vue.

Modifications apportées aux vues des composants : nous avons supprimé le segment click_type des vues ad_group_asset, campaign_asset et customer_asset. Cette modification s'aligne sur un changement récent apporté au produit, qui a supprimé ce segment de Google Ads pour éviter toute déclaration trompeuse ou déceptive concernant les données. Vous pouvez utiliser la segmentation click_type de la ressource ad_group_ad pour obtenir des informations sur les performances de l'annonce et le composant avec lequel elle a été diffusée.

Les modifications apportées à l'annonce vidéo responsive VideoResponsiveAdInfo sont désormais modifiables. Dans le cadre de ce changement, nous avons marqué videos, business_name et logo_images comme champs obligatoires dans les objets DemandGenVideoResponsiveAdInfo et VideoResponsiveAdInfo.

Modifications apportées à ShareablePreviewService : mise à jour de ShareablePreviewService.GenerateShareablePreviews pour ne plus utiliser l'échec partiel. Les requêtes génèrent une erreur si elles échouent pour un ID. En savoir plus

Les ressources suivantes peuvent vous aider à démarrer :

Pour toute demande d'assistance technique, contactez https://support.google.com/google-ads/contact/google_ads_api.

Portrait de l'auteur - , équipe API Google Ads

Libellés : google-ads-api, release