Notes de version

v23 (28/01/2026)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées dans la version 23.

Pour obtenir de l'aide, consultez Passer à la dernière version.

Annonces

• Ajout de AD_SHARING_NOT_ALLOWED à AdGroupAdErrorEnum. Cette erreur s'affiche lorsque vous tentez de partager une annonce entre plusieurs groupes d'annonces, ce qui n'est plus autorisé.
• Ajout de nouveaux types de formats à AdFormatType : TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
• Suppression de la compatibilité avec CallAd et CallAdInfo dans la version 23. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/6341403.

Éléments

• Ajout de métriques au rapport asset_group :

  • metrics.engagements
  • metrics.engagement_rate
  • metrics.average_cpe

• Ajout de métriques au rapport asset_group_asset :

  • metrics.average_cpe
  • metrics.average_cpm
  • metrics.trueview_average_cpv
  • metrics.video_trueview_view_rate
  • metrics.video_trueview_views
  • metrics.interaction_event_types

• Ajout du champ en lecture seule orientation aux composants Image et Vidéo dans Asset.

• Ajout de la prise en charge de la récupération de CampaignAsset avec field_type HEADLINE et DESCRIPTION.

• Ajout de HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE et DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO à ServedAssetFieldType pour les composants diffusés en tant que liens annexes.

• Composants Message à un établissement mis à jour :

  • Ajout de la compatibilité avec Facebook Messenger et Zalo en tant que fournisseurs dans BusinessMessageAsset, ajout de FACEBOOK_MESSENGER et ZALO à BusinessMessageProviderEnum.BusinessMessageProvider, et ajout des nouveaux champs facebook_messenger_info et zalo_info à BusinessMessageAsset.
  • Ajout de CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS à AssetErrorEnum.

Facturation

• InvoiceService.ListInvoices peut désormais renvoyer des informations plus précises dans Invoice, y compris la répartition des coûts au niveau de la campagne, les coûts réglementaires détaillés et les informations sur les ajustements, en définissant include_granular_level_invoice_details dans ListInvoicesRequest.
• Ajout de RegulatoryFeeTypeEnum et de UnitOfMeasureEnum.

Campagnes

• Ajout des codes d'erreur CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET et CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
• Ajout de Campaign.start_date_time et Campaign.end_date_time pour remplacer Campaign.start_date et Campaign.end_date, ce qui permet de spécifier des composants temporels pour certains types de campagnes.

Conversions

• Ajout de YOUTUBE_FOLLOW_ON_VIEWS à ConversionActionCategory pour permettre le suivi des utilisateurs qui regardent une annonce, puis une vidéo de la même chaîne.

Génération de la demande

• Ajout du champ DemandGenVideoResponsiveAdInfo.companion_banner.
• Le champ lead_form_only a été supprimé de DemandGenMultiAssetAdInfo.

Avantages

• Ajout de la compatibilité avec les incitations Choisissez votre offre, qui permet aux partenaires de récupérer et d'appliquer de manière programmatique les incitations Google Ads pour leurs clients :

  • Ajout de IncentiveService :
    • La méthode FetchIncentive permet de récupérer les incitations disponibles pour un utilisateur, en fonction de son pays, de sa langue et, éventuellement, de son adresse e-mail. Cela peut renvoyer des options d'incitation personnalisées "Choisissez votre propre" (CYO, Choose Your Own).
    • La méthode ApplyIncentive permet d'appliquer une incitation sélectionnée par l'utilisateur à un compte client Google Ads spécifique.
  • Ajout de la ressource en lecture seule AppliedIncentive, interrogeable via GoogleAdsService.Search et GoogleAdsService.SearchStream. Il fournit des informations sur les avantages utilisés, y compris leur état, l'état de leur traitement, les montants des récompenses et les dates concernées.
  • Ajout de nouveaux codes d'erreur dans IncentiveErrorEnum pour gérer les problèmes liés à la récupération ou à l'application d'incitations.
  • Ajout de INVALID_EMAIL_ADDRESS à AuthenticationErrorEnum.

• Pour faciliter la gestion programmatique plus précise des échecs, nous ajouterons des codes d'erreur supplémentaires à IncentivesService dans les prochaines versions. Nous vous recommandons de surveiller les prochaines annonces et notes de version pour ces nouveaux codes d'erreur afin de vous assurer que vos applications peuvent gérer ces nouveaux modes d'échec.

Planification

• Ajout de LIFE_EVENT_USER_INTEREST à AudienceInsightsDimensionEnum. Cette nouvelle dimension permet aux utilisateurs de créer des audiences à l'aide des événements de la vie pour les méthodes suivantes :

  • AudienceInsightsService.GenerateAudienceCompositionInsights
  • AudienceInsightsService.GenerateSuggestedTargetingInsights
  • AudienceInsightsService.GenerateInsightsFinderReport
  • ContentCreatorInsightsService.GenerateCreatorInsights

  Les événements de la vie ne sont pas compatibles avec les autres méthodes AudienceInsightsService, telles que AudienceInsightsService.GenerateAudienceOverlap et AudienceInsightsService.GenerateTargetingSuggestionMetrics.

• La réponse ReachPlanService.GenerateConversionRates inclut désormais des surfaces, ce qui permet de proposer différentes suggestions de taux de conversion en fonction des contrôles de surface (par exemple, Gmail, Shorts). Cette fonctionnalité n'est disponible que pour les campagnes de génération de la demande.

• Ajout de LanguageDistribution à YouTubeChannelInsights, qui fournit la répartition des langues dans le contenu des chaînes YouTube.

• Ajout de BenchmarksService pour comparer les données publicitaires YouTube aux benchmarks du secteur.

• Ajout de AudienceInsightsService.GenerateAudienceDefinition pour traduire une description en texte libre d'une audience cible en attributs d'audience correspondants à l'aide de l'IA générative.

• Ajout de YouTubeChannelInsights.relevance_score, qui évalue la pertinence d'un créateur pour un thème en fonction du nombre de vues.

• Ajout de TrendInsightMetrics.trend_change_percent, qui représente la variation en pourcentage de la valeur d'une tendance au cours de la période de comparaison.

Recommandations

• Ajout du champ is_new_customer à GenerateRecommendationsRequest. Lorsqu'il est défini sur true pour les recommandations de type CAMPAIGN_BUDGET, il génère des recommandations à l'aide d'un modèle pour les nouveaux clients. Cette option n'est recommandée que pour les clients qui n'ont aucune campagne.

Rapports

• Métriques et segmentation

  • AdGroupAdAssetView et AdGroupAdAssetCombinationView sont désormais compatibles avec les métriques d'impression, de performances et de conversion pour RESPONSIVE_DISPLAY_AD.
  • Ajout du segment ad_sub_network_type pour une répartition plus précise des performances au sein d'un réseau publicitaire. Dans un premier temps, cette fonctionnalité est disponible pour les campagnes de génération de la demande sur YouTube (InStream, In-Feed, Shorts). Ce segment doit être sélectionné avec ad_network_type.
  • Répartition des types de réseaux publicitaires activés pour les campagnes Performance Max.
  • UserLocationView et GeographicView sont désormais compatibles avec les métriques segmentées par date de conversion :
    • conversions_by_conversion_date,
    • all_conversions_by_conversion_date
    • conversions_value_by_conversion_date
    • all_conversions_value_by_conversion_date
    • value_per_conversions_by_conversion_date
    • value_per_all_conversions_by_conversion_date
    • cross_device_conversions_by_conversion_date
    • cross_device_conversions_value_by_conversion_date.

• Nouveaux segments pour les annonces verticales

  • vertical_ads_event_participant_display_names
  • vertical_ads_hotel_class
  • vertical_ads_listing
  • vertical_ads_listing_brand
  • vertical_ads_listing_city
  • vertical_ads_listing_country
  • vertical_ads_listing_region
  • vertical_ads_partner_account
  • vertical_ads_vertical

• Nouvelles vues :

  • Ajout de PerStoreView pour interroger les détails de l'adresse du magasin.
  • Ajout de MatchedLocationInterestView pour les campagnes AI Max, qui fournit des métriques de performances ventilées par zones géographiques dans lesquelles les utilisateurs ont manifesté de l'intérêt.

• Performance Max :

  • Répartition des types de réseaux publicitaires activés pour les campagnes Performance Max.

• Suppressions :

  • Suppression des métriques de libellé de performances agrégées des composants. L'énumération des libellés de performances n'est plus renvoyée pour le Réseau de Recherche et Display.

Shopping

• ShoppingPerformanceView prend désormais en charge les métriques suivantes segmentées par date de conversion : conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date et value_per_all_conversions_by_conversion_date.
• ShoppingPerformanceView est désormais compatible avec les métriques concurrentielles suivantes : search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share et search_rank_lost_absolute_top_impression_share.
• Ajout de product_image_uri à ShoppingProduct.

Annonces verticales

• Ajout de vertical_ads_format_setting à AdGroup pour les campagnes sur le Réseau de Recherche utilisant des flux de voyage, ce qui permet de contrôler les formats d'annonces pouvant être diffusés.
• Ajout du type de critère vertical_ads_item_group_rule_list à AdGroupCriterion. Ajout de vertical_ads_item_group_rule à SharedCriterion. Ces critères permettent de cibler des groupes d'articles dans les campagnes sur le Réseau de Recherche avec des flux de voyage.
• Vous pouvez désormais associer un flux de données d'annonces verticales à une campagne sur le Réseau de Recherche qui utilise AI Max. Vous pourrez ainsi diffuser des annonces de promotion d'établissements et de voyage avec lien de réservation en plus de vos annonces textuelles. Au niveau du groupe d'annonces, vous pouvez contrôler les formats à afficher avec vertical_ads_format_setting et définir un ensemble de règles de groupe d'articles pour cibler un sous-ensemble de vos entités à partir du flux de données des annonces verticales. De plus, les rapports peuvent désormais être segmentés à la fois par AdFormatType et par dimensions du flux de données des annonces verticales.

Vidéo

• Ajout du champ AdVideoAssetInfo.ad_video_asset_feature_control.
• Ajout du code d'erreur CampaignCriterionError.INVALID_VIDEO_LINEUP_ID.
• Ajout de métriques d'audibilité pour les annonces audio sur YouTube, indiquant si une annonce était audible et sur combien d'impressions l'audibilité a pu être mesurée.

v22 (15/10/2025)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées dans la version 22.

Éléments

• Ajout de LANDING_PAGE_PREVIEW en tant que nouveau type de champ de composant Image.
• Introduction de AssetGenerationService (bêta) :
  • Ce service permet de générer des composants Texte et Image à l'aide de l'IA générative. Ce service n'est initialement disponible que pour un ensemble limité de participants à la bêta fermée.
  • GenerateText : génère du texte en fonction des entrées, comme l'URL finale, les requêtes en mode forme libre, les mots clés et le contexte de la campagne existante.
  • GenerateImages : génère des images en fonction d'entrées telles que l'URL finale, des requêtes en langage naturel, le contexte de la campagne existante ou en recontextualisant des images de produits existantes.
  • Les erreurs survenant lors de la génération de composants sont renvoyées avec des codes compris entre AssetGenerationErrorEnum.

Campagnes

• Ajout de nouveaux objectifs d'enchères pour les campagnes pour applications axées sur les installations (CAi) afin d'optimiser les enchères sans spécifier de cible. Cela peut être utile pour une mise à l'échelle rapide ou lorsqu'il est difficile de déterminer la bonne cible. Dans AppCampaignBiddingStrategyGoalType : * OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA : à utiliser avec la stratégie standard Maximiser les conversions.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : à utiliser avec la stratégie standard Maximiser la valeur de conversion.
• Ajout de la compatibilité avec le type de stratégie d'enchères "Part de voix fixe".
• Ajout de Campaign.feed_types, qui indique les types de flux associés à une campagne. Pour les campagnes Performance Max, cela peut indiquer le secteur d'activité, par exemple MERCHANT_CENTER_FEED pour le commerce.
• Vous pouvez associer des ensembles partagés NEGATIVE_KEYWORDS aux campagnes MULTI_CHANNEL (pour les campagnes pour applications) et LOCAL.

Génération de la demande

• Ajout de la stratégie d'enchères au CPC cible pour les campagnes de génération de la demande. Cette stratégie définit des enchères pour maximiser les clics au coût par clic (CPC) cible configuré.
  • Définissez le CPC cible au niveau de la campagne à l'aide de Campaign.target_cpc.
  • Remplacez-le au niveau du groupe d'annonces à l'aide de AdGroup.target_cpc_micros.
• Ajout d'un nouveau AssetAutomationType : * GENERATE_DESIGN_VERSIONS_FOR_IMAGES : disponible pour DemandGenMultiAssetAds. Si cette option est activée, des éléments de conception sont ajoutés et des composants Texte sont intégrés dans des composants Image pour créer de nouveaux composants Image avec différents formats. Les nouveaux DemandGenMultiAssetAds sont activés par défaut.
• Ajout d'un nouveau AssetAutomationType : * GENERATE_VIDEOS_FROM_OTHER_ASSETS : disponible pour DemandGenMultiAssetAds. Si cette option est activée, elle génère des vidéos à partir d'autres composants tels que des images et du texte. Ces vidéos peuvent ensuite être utilisées pour créer de nouveaux DemandGenVideoResponsiveAds. Les nouveaux DemandGenMultiAssetAds sont activés par défaut.
• Le champ BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros a été renommé minimum_budget_amount_micros.

Général

• Ajout d'une limite de 10 000 opérations par requête AddBatchJobOperations.
• Mise à jour du traitement du champ page_size dans ListBatchJobResultsRequest :
  • Si page_size n'est pas défini ou est défini sur 0, la valeur par défaut est désormais de 1 000 (auparavant,INVALID_PAGE_SIZE était renvoyé).
  • Si page_size dépasse 1 000, l'API renvoie désormais une erreur INVALID_PAGE_SIZE (auparavant, la valeur était plafonnée à 1 000 sans message).
• Ajout d'un nouveau code d'erreur : QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED pour indiquer quand la limite du taux d'activation du profil de paiement a été dépassée.

Performance Max

• Ajout de nouvelles valeurs AssetAutomationType pour les campagnes Performance Max :
  • GENERATE_IMAGE_ENHANCEMENT : permet la création automatique d'images améliorées, comme le recadrage automatique. Cette option est activée par défaut.
  • GENERATE_IMAGE_EXTRACTION : permet de récupérer automatiquement des images à partir des URL finales. Par défaut, ce paramètre est défini sur le paramètre "Extension Image dynamique" au niveau du compte.
• Suppression de AssetPerformanceLabel pour les campagnes Performance Max.
• La fonctionnalité de Campaign.url_expansion_opt_out supprimée est désormais gérée en définissant AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION dans AssetAutomationSetting.
• Ajout de nouveaux segments pour les campagnes Performance Max. Chacun de ces segments n'est disponible que pour les campagnes Performance Max. Aucune donnée ne sera renvoyée si un autre type de campagne est sélectionné.
  • ad_using_product_data : indique si une annonce utilise des données produit provenant d'un flux Google Merchant Center.
  • ad_using_video : indique si une annonce utilise un composant vidéo.

Planification

• Dans UserListCrmDataSourceType, la valeur THIRD_PARTY_PARTNER_DATA a été ajoutée.
  • Ajout de nouveaux codes d'erreur liés aux audiences partenaires :
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• Ajout de is_active_live_stream_creator à YouTubeMetrics. Cette valeur est renvoyée par ContentCreatorInsightsService.GenerateCreatorInsights et indique si un créateur a publié un stream en direct au cours des 90 derniers jours.

• Ajout d'un nouveau message PlannableUserListMetadata contenant UserListCrmDataSourceType dans PlannableUserList. Ce message est renvoyé par ReachPlanService.ListPlannableUserLists pour indiquer si une source de données de liste d'utilisateurs CRM est FIRST_PARTY ou THIRD_PARTY_PARTNER_DATA.

• Dans ReachPlanService, le champ trueview_views a été ajouté. Il remplace le champ views.

• Dans TrendInsight, ajout de la prise en charge de related_videos et related_creators. Ajout des métadonnées des propriétés vidéo et des dates de publication dans YouTubeVideoAttributeMetadata.video_properties et YouTubeVideoAttributeMetadata.publish_date.

  • AudienceInsightsService.GenerateInsightsFinderReport est désormais compatible avec parental_status et income_ranges, ainsi qu'avec des combinaisons AND/OR plus complexes de thèmes et d'audiences.

Rapports

• Ajout de deux nouveaux types de clics : CLICK_TO_MESSAGE_THIRD_PARTY_CLICK et CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
  • AssetGroupAsset peut désormais être segmenté par device, conversion_action, conversion_action_name et conversion_action_category.
    • AdGroupAdAssetView et AdGroupAdAssetCombinationView sont désormais entièrement compatibles avec les métriques de performances et de conversions pour RESPONSIVE_SEARCH_AD. Auparavant, seules les impressions étaient renvoyées pour ce type d'annonce dans ces vues.
• Pour faciliter l'exploration des stratégies d'enchères intelligentes, les métriques suivantes peuvent désormais être segmentées par champs de date (date, month, quarter, week, year) :
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• Ajout d'une nouvelle ressource : TargetingExpansionView, qui fournit des métriques sur les expansions par rapport au ciblage manuel, comme l'expansion sans mot clé pour les campagnes AI Max pour le Réseau de Recherche.

• Ajout de nouveaux segments pour les campagnes PMax. Consultez les nouveautés de Performance Max.

  ### Shopping

• Correction de la portée des métriques au niveau de la campagne et du groupe d'annonces dans la ressource ShoppingProduct.

Objectifs unifiés

• Ajout de la prise en charge des objectifs de fidélisation des clients pour optimiser le réengagement des clients existants.
  • Configurez le ciblage à l'aide de CampaignRetentionGoalSettings.target_option : * TARGET_SPECIFIC : n'utilise que les utilisateurs des listes d'utilisateurs associées à la campagne. (Actuellement disponible uniquement sur liste d'autorisation).
    • TARGET_ALL (par défaut) : cible tous les utilisateurs pour le réengagement.

Vidéo

• Plusieurs métriques liées aux vues de vidéos ont été renommées :
  • average_cpv devient trueview_average_cpv
  • video_view_rate devient video_trueview_view_rate
  • video_views devient video_trueview_views
  • video_view_rate_in_feed devient video_trueview_view_rate_in_feed
  • video_view_rate_in_stream devient video_trueview_view_rate_in_stream
  • video_view_rate_shorts devient video_trueview_view_rate_shorts
• Métriques ajoutées pour la durée de visionnage des annonces vidéo :
  • video_watch_time_duration_millis : durée de visionnage totale.
  • average_video_watch_time_duration_millis : durée moyenne de visionnage par impression.

v21 (06/08/2025)

Pour obtenir de l'aide, consultez Passer à la dernière version.

AI Max pour les campagnes sur le Réseau de Recherche

• Vous pouvez désormais utiliser le champ ai_max_setting.enable_ai_max de Campaign pour activer AI Max pour les campagnes sur le Réseau de Recherche. AI Max pour les campagnes sur le Réseau de Recherche élargit la couverture d'une campagne sur le Réseau de Recherche grâce à la correspondance des termes de recherche et permet de contrôler si les paramètres de ciblage et de création sont appliqués lorsqu'ils sont définis. L'automatisation des composants texte et les contrôles des listes de marques définis dans les demandes de version précédente seront toujours respectés jusqu'à ce qu'AI Max pour les campagnes sur le Réseau de Recherche soit explicitement activé et désactivé. Campaign.ai_max_setting.bundling_required peut être utilisé pour déterminer si AI Max pour les campagnes sur le Réseau de Recherche doit être activé pour respecter ou modifier l'automatisation des composants texte et les contrôles des listes de marques. AdGroup.ai_max_ad_group_setting.disable_search_term_matching peut être utilisé pour désactiver la correspondance des termes de recherche lorsqu'une campagne parente a activé IA Max pour les campagnes sur le Réseau de Recherche. Consultez notre article de blog Améliorer vos performances grâce à AI Max pour les campagnes sur le Réseau de Recherche.

• Ajout de CampaignError.AI_MAX_MUST_BE_ENABLED, qui est généré pour les campagnes sur le Réseau de Recherche lorsque vous activez FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION sans activer AI Max pour les campagnes sur le Réseau de Recherche dans la campagne.

• Ajout de la possibilité d'appliquer des paramètres de ciblage au niveau du groupe d'annonces dans les campagnes AI Max pour le Réseau de Recherche. Vous pouvez désormais ajouter les critères suivants aux groupes d'annonces :

  • Listes de marques
  • Zones
  • Pages Web (règles d'URL)

• Ajout de ai_max_search_term_ad_combination_view pour générer des rapports sur les performances des combinaisons de termes de recherche, de titres et de pages de destination. Cette vue indique les requêtes de recherche qui ont déclenché la diffusion de vos annonces et les performances de ces combinaisons spécifiques. Une prochaine version inclura une vue supplémentaire qui comprendra également les données Performance Max. Si vous souhaitez éviter de migrer votre implémentation pour obtenir des données Performance Max, envisagez d'attendre cette version.

• Ajout de AI_MAX en tant que nouvelle valeur pour le segment search_term_match_type.

Éléments

• Ajout des champs terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info et promotion_qr_code_info dans PromotionAsset. Les champs de code-barres et de QR code se trouvent dans le promotion_trigger. Consultez l'article du centre d'aide À propos des composants Promotion.

• Ajout de FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION à AssetAutomationTypeEnum. Ce paramètre vous permet de contrôler la génération automatique de composants texte et de pages de destination à partir de l'URL finale dans les campagnes sur le Réseau de Recherche.

• Ajout d'un nouveau service AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset pour supprimer les composants créés automatiquement à partir de Campaign. Ce service permet uniquement de supprimer le composant d'extension d'URL finale.

• Ajout de DESCRIPTION_PREFIX à l'énumération ServedAssetFieldType. Cela corrige un problème où le served_asset_field_type dans ad_group_ad_asset_combination_view était UNKNOWN pour les composants servant de préfixe de description.

Campagnes

• Ajout d'une nouvelle valeur d'énumération MISSING_LOCATION_TARGETING à CampaignPrimaryStatusReason. Cette nouvelle raison de l'état ne sera renvoyée que pour les campagnes limitées géographiquement qui ne spécifient pas de ciblage géographique. Pour les campagnes avec restriction géographique, toute tentative d'ajout d'un ciblage géographique en dehors de la zone autorisée générera l'erreur de critère LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.

• Ajout de la compatibilité avec les partenaires d'intégration tiers aux niveaux VideoCustomer.third_party_integration_partners et Campaign.third_party_integration_partners. Consultez l'article du centre d'aide Effectuer le suivi des conversions d'application avec une solution d'analyse d'applications tierce.

• Vous pouvez désormais définir le champ advertising_partner_ids pour un Campaign existant. Auparavant, ce champ ne pouvait être défini que pour une nouvelle campagne lors de sa création. Une fois défini, le champ reste immuable.

• En utilisant une liste partagée de type TYPE_PLACEMENT_LIST définie au niveau du compte administrateur, les annonceurs peuvent désormais utiliser des critères CustomerNegativeCriterion pour exclure une liste d'emplacements dans des comptes client d'annonceurs individuels.

• Ajout de DESCRIPTION_PREFIX à l'énumération ServedAssetFieldType. Cela corrige un problème où le served_asset_field_type dans ad_group_ad_asset_combination_view était UNKNOWN pour les composants servant de préfixe de description.

• Ajout de la prise en charge du champ target_roas_tolerance_percent_millis dans les stratégies d'enchères MaximizeConversionValue et TargetRoas. TargetRoas.target_roas_tolerance_percent_millis n'est disponible que pour les stratégies de portefeuille, qui ne sont disponibles que pour les campagnes sur le Réseau de Recherche.

• Modification d'un code d'erreur ProductGroup. Pour les requêtes avec échec partiel activé, LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION sera renvoyé à la place de INVALID_LISTING_GROUP_HIERARCHY.

• Ajout d'une nouvelle ressource LocationInterestView qui récapitule les performances des critères d'intérêt géographique des groupes d'annonces.

Conversions

• Ajout de ENGAGED_VIEW en tant que nouvelle valeur pour le segment conversion_attribution_event_type.

• Les clients n'auront plus accès au mode debug_enabled dans ConversionUploadService. Si ce champ est défini sur TRUE, il était auparavant utilisé pour distinguer l'erreur CLICK_NOT_FOUND de SUCCESS pour les importations des conversions avancées pour les prospects.

Génération de la demande

• Ajout du code d'erreur CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. À l'avenir, cette erreur s'affichera lorsque vous tenterez de définir un montant de budget très faible pour une campagne de génération de la demande. Vous trouverez des informations sur le budget minimal requis dans le nouveau champ de détails des erreurs budgetDailyMinimumErrorDetails.

Modifications apportées à la publicité à caractère politique dans l'UE

Ces modifications apportées aux annonces politiques dans l'UE ont également été effectuées dans les versions v19.2 et v20.1.

• Ajout de Campaign.contains_eu_political_advertising. Ce champ indique si votre campagne contient du contenu publicitaire à caractère politique ciblant l'Union européenne. Si ce champ est défini sur CONTAINS_EU_POLITICAL_ADVERTISING, la campagne ne sera plus diffusée dans l'UE à partir du 22 septembre 2025. Les appels d'API visant à créer une campagne échoueront avec une erreur FieldError.REQUIRED si ce champ n'est pas défini.

  Pour toutes les campagnes existantes, vous devez définir le champ contains_eu_political_advertising avant de tenter de modifier le ciblage par proximité, par zone géographique ou par groupe de zones géographiques au niveau de la campagne ou du groupe d'annonces. Les appels d'API visant à créer ou à mettre à jour ces critères de campagne ou de groupe d'annonces pour les campagnes existantes échoueront et renverront une erreur CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si la campagne n'a pas fait l'objet d'une auto-déclaration.

  Pour les versions 19.x et 20.x, l'obligation de définir ce champ n'est pas encore appliquée, mais le sera à l'avenir. Ce changement sera annoncé à l'avance.

• Les tests et les campagnes tests généreront une erreur ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si les campagnes du test n'ont pas déclaré elles-mêmes si elles contiennent de la publicité à caractère politique ciblant l'Union européenne.

Performance Max

• Pour les nouvelles campagnes PMax, la valeur par défaut de Campaign.brand_guidelines_enabled est désormais true.

• Ajout du rapport campaign_search_term_view. Cette vue propose des métriques sur les termes de recherche agrégées au niveau de la campagne. Cette vue est également compatible avec les campagnes Performance Max pour les termes de recherche.

• Ajout de PERFORMANCE_MAX en tant que nouvelle valeur pour le segment search_term_match_type.

Planification

• Ajout d'une nouvelle méthode ReachPlanService.ListPlannableUserInterests, qui permet aux annonceurs de découvrir les centres d'intérêt des utilisateurs (affinités et marchés cibles) compatibles avec ReachPlanService.GenerateReachForecast. Cette méthode permet de rechercher des types d'intérêt spécifiques aux utilisateurs, ainsi que d'interroger des noms et des chemins d'accès.

• Ajout de AdditionalApplicationInfo à ReachPlanService.ListPlannableUserLists en tant que champ de saisie facultatif.

• Ajout de la compatibilité avec AudienceInsightsService.ListAudienceInsightsAttributes pour récupérer les listes d'utilisateurs first party disponibles pour l'ID client qui effectue la demande.

• Ajout de la compatibilité avec les listes d'utilisateurs propriétaires à AudienceInsightsService.GenerateAudienceCompositionInsights pour récupérer des insights sur les audiences ciblant une liste d'utilisateurs. Toute requête ciblant une liste d'utilisateurs ne renverra que l'index d'audience et n'est disponible que pour les AudienceInsightsDimension suivants : AGE_RANGE, GENDER, AFFINITY_USER_INTEREST et IN_MARKET_USER_INTEREST.

• Le type d'entrée d'audience a été remplacé par InsightsAudience pour AudienceInsightsService.GenerateTargetingSuggestionMetrics. La nouvelle entrée d'audience permet une combinaison AND-of-ORs des centres d'intérêt des utilisateurs, ce qui permet d'obtenir des métriques de couverture potentielle pour des définitions d'audience plus personnalisées.

• Ajout de la part d'audience à TrendInsightMetrics pour obtenir la part d'une audience pour une tendance.

• Ajout de catégories associées à KnowledgeGraphAttributeMetadata pour permettre aux utilisateurs de filtrer les attributs du Knowledge Graph par catégorie.

Rapports

• De nouvelles métriques sont désormais disponibles pour AssetGroupAsset, ChannelAggregateAssetView et CampaignAggregateAssetView. De plus, pour ChannelAggregateAssetView et CampaignAggregateAssetView, impressions, qui était auparavant défini sur zéro pour les campagnes Performance Max, indiquera désormais sa valeur réelle.

• La ressource AssetSet est désormais sélectionnable avec ChangeStatus. Les utilisateurs peuvent ainsi obtenir plus d'informations sur la ressource de type AssetSet ou CampaignAssetSet en une seule requête.

• La ressource CampaignAssetSet est désormais sélectionnable avec ChangeStatus. Les utilisateurs peuvent ainsi obtenir plus d'informations sur la ressource de type AssetSet ou CampaignAssetSet dans une seule requête.

• Ajout d'un nouveau segment search_term_targeting_status qui peut être sélectionné dans la vue des termes de recherche des campagnes.

• Ajout d'un nouveau final_url_expansion_asset_view.

• Ajout de la prise en charge des métriques value_adjustment et all_value_adjustment dans le rapport AssetGroup.

• AssetGroupAsset peut être segmenté par ad_network_type.

• Ajout d'un nouveau segment landing_page_source pouvant être utilisé avec la ressource landing_page_view.

• Ajout d'un nouveau segment search_term_match_source qui peut être sélectionné dans les vues "Termes de recherche" et "Termes de recherche de la campagne".

• Ajout d'un segment match_type pouvant être sélectionné dans la vue "Mots clés".

• Ajout de la prise en charge des métriques pour les clusters d'intention de requête uniques avec :

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• Ajout d'un nouveau type de clic VEHICLE_ASSETS dans la segmentation click_view pour suivre et générer des rapports sur les clics associés aux formats d'annonces spécifiques aux composants de véhicules.

Exploration avec stratégies d'enchères intelligentes pour les stratégies d'enchères au ROAS cible sur le Réseau de Recherche

• Vous pouvez désormais activer l'exploration avec stratégies d'enchères intelligentes dans les campagnes sur le Réseau de Recherche en définissant le champ target_roas_tolerance_percent_millis dans les stratégies d'enchères MaximizeConversionValue et TargetRoas sur n'importe quelle valeur divisible par 1 000 comprise entre 10 000 (10 %) et 30 000 (30 %), inclus. Les stratégies d'enchères MaximizeConversionValue devront également définir le champ target_roas. TargetRoas.target_roas_tolerance_percent_millis n'est disponible que pour les stratégies de portefeuille. Consultez notre article de blog sur l'exploration des enchères intelligentes et notre article du Centre d'aide.

• Les rapports agrégés sur la diversité sont désormais disponibles pour les métriques suivantes concernant les clusters d'intention de requête unique. Une vue segmentée par période est disponible dans l'UI Google Ads.

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

Vidéo

• Ajout de YouTubeVideoListAsset. Ajout de Asset#youtube_video_list_asset, qui peut être utilisé pour créer un lien entre un type campaign et un type YouTubeVideoListAsset. Consultez l'article du centre d'aide Utiliser les vidéos associées.

• Ajout de nouveaux champs de métadonnées à YouTubeChannelInsights et YouTubeVideoAttributeMetadata.

• Nouveaux types de clics exposés : VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK et PRODUCT_ASSETS.

• Ajout du champ allow_non_skippable_in_stream à VideoAdInventoryControl pour permettre aux annonces vidéo responsives d'être diffusées en tant qu'annonces InStream non désactivables. Cette option est disponible pour les campagnes qui permettent de combiner le format non désactivable avec d'autres formats.

• Ajout des champs Campaign.VideoCampaignSettings.video_ad_sequence et AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting (en lecture seule). Consultez l'article du centre d'aide À propos du séquencement d'annonces vidéo.

• Ajout de nouveaux champs de métadonnées à YouTubeChannelInsights et YouTubeVideoAttributeMetadata.

• Ajout du type de critère VIDEO_LINEUP et du champ video_lineup à CampaignCriterion et AdGroupCriterion. Cette fonctionnalité n'est disponible que pour les comptes figurant sur la liste d'autorisation. Pour en savoir plus, contactez votre représentant Google chargé du développement commercial.

• Ajout d'un rapport sur l'adéquation du contenu au niveau détaillé et groupé. Consultez l'article du centre d'aide À propos du rapport "Adéquation du contenu".

v20.1 (06/08/2025)

Ces modifications apportées aux annonces politiques dans l'UE ont également été incluses dans les versions v19.2 et v21.

Modifications apportées à la publicité à caractère politique dans l'UE

• Ajout de Campaign.contains_eu_political_advertising. Ce champ indique si votre campagne contient du contenu publicitaire à caractère politique ciblant l'Union européenne. Si ce champ est défini sur CONTAINS_EU_POLITICAL_ADVERTISING, la campagne ne sera plus diffusée dans l'UE à partir du 22 septembre 2025.

  Pour toutes les campagnes existantes, vous devez définir le champ contains_eu_political_advertising avant de tenter de modifier le ciblage par proximité, par zone géographique ou par groupe de zones géographiques au niveau de la campagne ou du groupe d'annonces. Les appels d'API visant à créer ou à mettre à jour ces critères de campagne ou de groupe d'annonces pour les campagnes existantes échoueront et renverront une erreur CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si la campagne n'a pas fait l'objet d'une auto-déclaration.

  Pour les versions 19.x et 20.x, l'obligation de définir ce champ n'est pas encore appliquée, mais le sera à l'avenir. Ce changement sera annoncé à l'avance.

• Les tests et les campagnes tests généreront une erreur ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION si les campagnes du test n'ont pas déclaré elles-mêmes si elles contiennent de la publicité à caractère politique ciblant l'Union européenne.

Version 20 (04/06/2025)

Les nouvelles fonctionnalités et mises à jour suivantes ont été ajoutées dans la version 20.

Pour obtenir de l'aide, consultez Passer à la dernière version.

Éléments

Ajout de plusieurs colonnes de métriques et de segments pour le rapport asset_group.

Colonnes de métriques

• new_customer_lifetime_value
• all_new_customer_lifetime_value
• conversions_by_conversion_date
• all_conversions_by_conversion_date
• conversions_value_by_conversion_date
• all_conversions_value_by_conversion_date
• value_per_conversions_by_conversion_date
• value_per_all_conversions_by_conversion_date

Colonnes de segment

• ad_network_type
• conversion_action
• conversion_action_name
• conversion_action_category
• external_conversion_source
• conversion_attribution_event_type
• conversion_adjustment
• conversion_lag_bucket
• conversion_or_adjustment_lag_bucket
• new_versus_returning_customers
• device
• slot

Campagnes

• Ajout de la possibilité d'ajouter et de modifier des mots clés à exclure au niveau de la campagne pour les campagnes Performance Max.

Conversions

• Vous pouvez désormais mettre à jour le champ google_ads_conversion_customer d'un client existant pour activer le suivi des conversions multicomptes ou modifier son compte administrateur parent de suivi des conversions.

  Remarque : Cette fonctionnalité est disponible sur une liste d'autorisation fermée. Pour l'utiliser, contactez votre responsable de compte.

• Ajout du champ ClickConversion.user_ip_address. Google Ads n'accepte pas la mise en correspondance des adresses IP pour les utilisateurs finaux situés dans l'Espace économique européen (EEE), au Royaume-Uni (UK) ou en Suisse (CH). Veuillez ajouter une logique pour exclure de manière conditionnelle le partage des adresses IP des utilisateurs de ces régions. Assurez-vous de fournir aux utilisateurs des informations claires et complètes sur les données que vous collectez sur vos sites, applications et autres propriétés, et d'obtenir leur consentement lorsque la loi ou les règles Google applicables l'exigent. Pour en savoir plus, consultez la page À propos de l'importation des conversions hors connexion.

Génération de la demande

• Nous avons ajouté de nouvelles valeurs au segment ad_network_type qui permettent de segmenter les campagnes de génération de la demande par canal :
  • MAPS
  • GMAIL
  • DISCOVER
• Ajout de métriques pour les conversions comparables par plate-forme :
  • platform_comparable_conversions_from_interactions_rate
  • platform_comparable_conversions
  • platform_comparable_conversions_value
  • platform_comparable_conversions_value_per_cost
  • platform_comparable_conversions_by_conversion_date
  • platform_comparable_conversions_value_by_conversion_date
  • platform_comparable_conversions_from_interactions_value_per_interaction
    • cost_per_platform_comparable_conversion
  • value_per_platform_comparable_conversion
  • value_per_platform_comparable_conversions_by_conversion_date
  • cost_converted_currency_per_platform_comparable_conversion

Recommandations

• Ajout de la compatibilité avec ShoppingSetting lors de la création de campagnes lorsque vous utilisez GenerateRecommendationsRequest.
  • Ajout du champ merchant_center_account_id à GenerateRecommendationsRequest pour indiquer quand les recommandations doivent être générées pour les campagnes retail, plutôt que pour les campagnes Performance Max standards.

Planification

• Ajout de AudienceInsightsDimension.YOUTUBE_LINEUP pour remplacer AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP dans AudienceInsightsService et ContentCreatorInsightsService. Cette nouvelle dimension vous permet de récupérer des insights et des métadonnées pour les lineups YouTube Select (YTS). Nous avons remplacé les objets associés à YOUTUBE_DYNAMIC_LINEUP, tels que DynamicLineupAttributeMetadata et AudienceInsightsDynamicLineup, pour les aligner sur la suppression plus large des lineups dynamiques dans Google Ads. Cette fonctionnalité n'est disponible que pour les comptes figurant sur une liste d'autorisation.
• Ajout de AdditionalApplicationInfo et ApplicationInstance dans AudienceInsightsService, ContentCreatorInsightsService et ReachPlanService. Cette fonctionnalité n'est disponible que pour les comptes figurant sur une liste d'autorisation.
• Mise à jour de AudienceInsightsService et ContentCreatorInsightsService pour fournir des insights plus détaillés. Vous pouvez désormais segmenter les données des créateurs de contenu par appareil à l'aide des nouveaux AudienceInsightsDimension.DEVICE et AudienceInsightsAttribute.device dans les deux services. Cette fonctionnalité n'est disponible que pour les comptes figurant sur une liste d'autorisation.
• Ajout de métriques vidéo agrégées supplémentaires à GenerateCreatorInsightsResponse pour une analyse plus complète des créateurs de contenu : engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count et is_brand_connect_creator. Cette fonctionnalité n'est disponible que pour les comptes figurant sur une liste d'autorisation.
• Ajout de sub_country_locations à GenerateCreatorInsightsRequest pour ContentCreatorInsightsService. Cela permet de spécifier des zones géographiques au niveau des sous-pays pour affiner les recherches d'insights sur les créateurs. Le champ sub_country_locations n'est compatible qu'avec l'élément search_attributes dans le champ criteria. Si des sub_country_locations sont fournis avec d'autres types de critères, la demande ne sera pas valide. Cela permet un ciblage et une analyse géographique plus précis pour les insights sur les créateurs de contenu. Cette fonctionnalité n'est disponible que pour les comptes figurant sur une liste d'autorisation.
• Ajout de ReachPlanService.ListPlannableUserLists, qui renvoie les listes d'utilisateurs first party appartenant à un client, et ajout de UserListInfo aux options de ciblage d'audience dans GenerateReachForecastRequest. Cela vous permet de récupérer des listes d'utilisateurs planifiables pour un client donné, puis de générer des prévisions de couverture pour les campagnes ciblant ces audiences spécifiques. Ces améliorations permettent de mieux planifier la couverture personnalisée en intégrant directement vos données d'audience first party dans les prévisions. Les prévisions de couverture ne sont disponibles que pour les comptes ajoutés à la liste d'autorisation.

Vidéos

• Ajout des annonces AdFormatType.PAUSE diffusées sur les vidéos YouTube naturelles sur les écrans de télévision, qui sont incluses dans les rapports. Ces annonces s'affichent directement à côté de l'image vidéo statique sur l'écran de pause. Cela n'inclut pas les annonces vidéo de génération de la demande diffusées dans le panneau d'annonces en dessous ou au-dessus d'une vidéo naturelle mise en pause, qui sont comptabilisées dans AdFormatType.INFEED.

Notes de version archivées

Consultez Versions abandonnées pour accéder aux notes de version archivées.