Notes de version

v22 (15/10/2025)

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

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

É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 nombre limité de participants à la bêta fermée.
  • GenerateText : Génère du texte en fonction des entrées telles que l'URL finale, les requêtes en texte 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 texte libre, 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 : utilisez-la avec la stratégie standard Maximiser les conversions.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS : utilisez-la 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'une nouvelle AssetAutomationType :
  • GENERATE_DESIGN_VERSIONS_FOR_IMAGES : disponible pour DemandGenMultiAssetAds. Si cette option est activée, elle ajoute des éléments de conception et intègre des composants Texte dans des composants Image pour créer de nouveaux composants Image avec des formats différents. Les nouvelles DemandGenMultiAssetAds sont activées par défaut.
• Ajout d'une nouvelle AssetAutomationType :
  • GENERATE_VIDEOS_FROM_OTHER_ASSETS : disponible pour DemandGenMultiAssetAds. Si cette option est activée, elle génère des vidéos à l'aide 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 nouvelles DemandGenMultiAssetAds sont activées par défaut.
• Le champ BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros a été renommé minimum_budget_amount_micros.

Général

• Nous avons ajouté 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 notification).
• 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 d'extension d'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 FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION dans AssetAutomationSetting.AssetAutomationType
• 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 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é une diffusion 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. Nous avons également ajouté les métadonnées des propriétés vidéo et les 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 avec 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 du ciblage manuel, comme l'expansion sans mots clés pour les campagnes AI Max sur 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 la 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
• Ajout de métriques sur la durée de visionnage des annonces vidéo :
  • video_watch_time_duration_millis : durée totale de visionnage.
  • average_video_watch_time_duration_millis : durée de visionnage moyenne 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. Il permet également 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 de la liste des marques définis dans les requêtes des versions précédentes 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 de la liste des 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é AI Max pour les campagnes sur le Réseau de Recherche. Consultez notre article de blog Améliorez 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 au niveau de la campagne.

• Nous avons ajouté la possibilité d'appliquer des paramètres de ciblage au niveau du groupe d'annonces dans AI Max pour les campagnes sur 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. Correction d'un problème où 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. Ce nouveau motif d'état ne sera renvoyé 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 entraînera 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. Le champ reste immuable une fois défini.

• 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 de conversions avancées pour les prospects.

Génération de la demande

• Ajout d'un code d'erreur : CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. À l'avenir, cette erreur sera renvoyée 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 des contenus publicitaires à 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é, géographique ou par groupe de zones géographiques au niveau de la campagne ou du groupe d'annonces. Les appels d'API permettant de créer ou de 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 indiqué elles-mêmes si elles contiennent des annonces à 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. La méthode permet de rechercher des types d'intérêt spécifiques des utilisateurs et d'interroger les noms et les 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 propriétaires disponibles pour l'ID client à l'origine de la requête.

• 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 ne sera disponible que pour les AudienceInsightsDimension suivants : AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.

• Mise à jour du type d'entrée d'audience sur 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 dans 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 en une seule requête.

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

• 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 : segmentable par ad_network_type.

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

• Ajout d'un 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 des 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

• Nous avons ajouté un type de clic VEHICLE_ASSETS dans la segmentation click_view pour suivre et comptabiliser 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. Le champ target_roas devra également être défini pour les stratégies d'enchères MaximizeConversionValue. 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 sur la diversité agrégés sont désormais disponibles pour les métriques suivantes pour 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

• YouTubeVideoListAsset ajouté. 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é effectuées dans les versions v19.2 et v21.

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

• Campaign.contains_eu_political_advertising ajouté. Ce champ indique si votre campagne contient des contenus publicitaires à 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é, géographique ou par groupe de zones géographiques au niveau de la campagne ou du groupe d'annonces. Les appels d'API permettant de créer ou de 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 expériences 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 des annonces à 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

• Il est désormais possible 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 modifier le champ google_ads_conversion_customer d'un client existant pour activer le suivi des conversions multicomptes ou remplacer son compte parent de suivi des conversions par un autre compte administrateur.

  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 correspondance des adresses IP pour les utilisateurs finaux 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 des importations de 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 prise en charge de ShoppingSetting lors de la création de campagnes avec GenerateRecommendationsRequest.
• Ajout du champ merchant_center_account_id à GenerateRecommendationsRequest pour indiquer quand les recommandations doivent être générées pour le commerce, 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). Les objets remplacés associés à YOUTUBE_DYNAMIC_LINEUP, tels que DynamicLineupAttributeMetadata et AudienceInsightsDynamicLineup, ont été supprimés pour s'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 nouvelles dimensions 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 accepté que lorsque vous utilisez le champ 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 propriétaires d'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 AdFormatType.PAUSEannonces 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.

v19.2 (06/08/2025)

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

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

• Campaign.contains_eu_political_advertising ajouté. Ce champ indique si votre campagne contient des contenus publicitaires à 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é, géographique ou par groupe de zones géographiques au niveau de la campagne ou du groupe d'annonces. Les appels d'API permettant de créer ou de 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. Attendez l'annonce de ce changement.

• Les tests et les expériences 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 des annonces à caractère politique ciblant l'Union européenne.

v19.1 (16/04/2025)

Les fonctionnalités et modifications suivantes ont été ajoutées dans la version 19.1.

Éléments

• Ajout d'un champ asset_coverage pour AssetGroup qui renvoie des informations sur les lacunes dans votre groupe de composants.
  • Contient un sous-champ ad_strength_action_items qui renvoie une liste d'actions qu'un annonceur peut effectuer pour améliorer l'efficacité d'un groupe de composants.

Campagnes

• Vous pouvez désormais évaluer les prospects ou nous faire part de vos commentaires dans les campagnes Local Services. Dans le cadre de ce changement, la version 19.1
  • Ajout d'un service nommé LocalServicesLeadService. Vous pouvez utiliser la méthode ProvideLeadFeedback pour importer des notes et des commentaires sur les prospects.
  • Ajout d'un champ lead_feedback_submitted à LocalServicesLead pour déterminer si des commentaires ont été envoyés à un prospect.
• Ajout d'une colonne de métriques biddable_cohort_app_post_install_conversions pour les campagnes pour applications.

Génération de la demande

• Des méthodes supplémentaires ont été introduites dans les services de planification pour prendre en charge la génération de la demande.

• Ajout de la compatibilité avec les paramètres des canaux au niveau du groupe d'annonces pour les campagnes de génération de la demande. Vous pouvez sélectionner un regroupement général prédéfini de chaînes ou un sous-ensemble de chaînes à l'aide du champ demand_gen_ad_group_settings. Les canaux suivants sont acceptés dans la version actuelle :

  • YouTube InStream
  • In-Feed YouTube
  • YouTube Shorts
  • Discover
  • Gmail
  • Écran

• Exposition d'un nouveau type d'élément pour TALL_PORTRAIT_MARKETING_IMAGE. Ce type de composant est lié au champ tall_portrait_marketing_images du format d'annonce multimédia de génération de la demande.

Historique des modifications

• Ajout de la compatibilité avec trois autres types de ressources dans ChangeStatusResourceType :
  • CAMPAIGN_BUDGET
  • ASSET_SET
  • CAMPAIGN_ASSET_SET
• Vous pouvez récupérer ces trois types plus précis dans le rapport change_status.

Conversions

• Vous pouvez désormais définir le champ google_ads_conversion_customer lors de la création d'un client à l'aide de l'API Google Ads. Auparavant, il s'agissait d'un champ en lecture seule.

  REMARQUE : Cette fonctionnalité est disponible sur une liste d'autorisation fermée. Pour ce faire, contactez votre responsable de compte.

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

• Vous pouvez désormais spécifier le type de client associé à la conversion lorsque vous importez des conversions hors connexion.

• Un nouveau champ session_attributes a été introduit pour ClickConversion.

Annonces Local Services

• Ajout d'un nouveau RPC ProvideLeadFeedback à LocalServicesLeadService pour fournir des commentaires sur la qualité de LocalServicesLead.
• Ajout d'un nouveau champ lead_feedback_submitted à la ressource LocalServicesLead qui confirme si des commentaires ont été fournis pour une ressource spécifique.

Services de planification

• Ajout de la prise en charge des prévisions mensuelles de fréquence cible dans ReachPlanService.GenerateReachForecast.
  • Les développeurs peuvent définir TargetFrequencyTimeUnit.MONTHLY dans TargetFrequencySettings lorsqu'ils utilisent le code produit planifiable TARGET_FREQUENCY pour générer une prévision mensuelle de couverture avec fréquence cible.
• Ajout d'une nouvelle méthode ReachPlanService.GenerateConversionRates, qui permet aux annonceurs de demander des taux de conversion suggérés pour les produits planifiables compatibles.
• Prévisions de génération de la demande dans ReachPlanService.GenerateReachForecast :
  • Les développeurs peuvent désormais demander des prévisions de couverture pour les campagnes de génération de la demande. Les développeurs peuvent utiliser le nouveau code produit planifiable DEMAND_GEN_MAX_CONVERSIONS pour générer des prévisions de couverture de génération de la demande.
  • Ajout d'un champ conversion_rate qui permet aux développeurs demandant des prévisions de couverture pour les campagnes de génération de la demande de fournir un taux de conversion. Vous pouvez récupérer les taux de conversion suggérés à l'aide de la nouvelle méthode ReachPlanService.GenerateConversionRates. Ce champ est obligatoire pour les demandes de prévision de génération de la demande. Il n'est pas compatible avec les autres produits planifiables.
  • Ajout d'un champ conversions aux prévisions renvoyées. Ce champ contient le nombre de conversions à un point donné de la courbe de couverture. Les conversions ne sont acceptées que pour le produit planifiable DEMAND_GEN_MAX_CONVERSIONS.

Recommandations

• Le nouveau champ ad_strength est disponible pour ImprovePerformanceMaxAdStrengthRecommendation, qui renvoie le score actuel d'efficacité de l'annonce du groupe de composants associé à la recommandation.

  Shopping

• Vous pouvez désormais remplacer les exclusions de marques pour les annonces Shopping dans les campagnes Performance Max. Cette option est disponible via un nouveau champ pmax_campaign_settings au niveau de la campagne et ne fonctionne que pour les campagnes PMax pour le secteur du commerce. Une nouvelle erreur CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED sera générée si vous tentez de définir ce champ pour un type de campagne incompatible.

Vidéos

• Ajout de la compatibilité en lecture seule pour les annonces audio. Pour en savoir plus sur cette fonctionnalité, consultez le Centre d'aide Google Ads. Cette modification expose les éléments suivants :
  • Un nouveau AdvertisingChannelSubType nommé YOUTUBE_AUDIO.
  • Un nouveau AdGroupType nommé YOUTUBE_AUDIO.
  • Une nouvelle énumération de format d'annonce nommée YOUTUBE_AUDIO_AD et ses champs YouTubeAudioAdInfo correspondants.
• Ajout de métriques et de segments aux métriques sur la couverture des requêtes avec ajustement démographique. Dans le cadre de ces changements,
  • Deux nouvelles colonnes de métriques nommées coviewed_impressions et primary_impressions ont été ajoutées.
  • Deux nouveaux segments ont été ajoutés : adjusted_age_range et adjusted_gender.
  • Si l'un des deux nouveaux segments est sélectionné en même temps qu'un champ de métrique de couverture (coviewed_impressions, primary_impressions, unique_users ou average_impression_frequency_per_user), l'autre segment doit également être sélectionné pour récupérer des statistiques valides pour ces colonnes.
  • Cette fonctionnalité n'est actuellement disponible que pour les clients inclus dans la liste d'autorisation.

v19 (26/02/2025)

Les fonctionnalités et modifications suivantes ont été ajoutées dans la version 19.

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

Gestion du compte

• Les valeurs suivantes ont été ajoutées à CustomerError pour tenir compte des modifications à venir :
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Annonces

• Ajouté DemandGenMultiAssetAdInfo.tall_portrait_marketing_images pour prendre en charge les composants Image au format portrait avec un format 9:16 dans les annonces de génération de la demande.

Éléments

• (Pour les comptes autorisés uniquement) Ajout de la compatibilité avec les composants Message via Asset.business_message_asset, BusinessMessageAsset et les énumérations et erreurs suivantes.
  • Énumérations :
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • Erreurs :
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• Ajout de AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW pour permettre la génération automatique d'un aperçu de la page de destination.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS est désormais activé par défaut pour les annonces responsives vidéo de génération de la demande.
• (Pour les comptes figurant sur la liste d'autorisation uniquement ; la liste d'autorisation est actuellement fermée) Ajout de Asset.app_deep_link_asset et AppDeepLinkAsset.

Conversions

• Objectifs de conversion
  • LifecycleGoalValueSettings.high_lifetime_value n'est plus en version bêta et est désormais mutable.
  • Ajout de CustomerLifecycleGoal.owner_customer pour afficher le nom de ressource du client propriétaire de l'objectif de cycle de vie client.
• Abandon de ConversionActionType.SALESFORCE.

Flux

• Suppression de toutes les entités liées aux flux, telles que Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view, etc. Les utilisateurs doivent désormais utiliser assets pour atteindre le même objectif.

Hôtels et voyages

• min_days et max_days de ValueRuleItineraryAdvanceBookingWindow ont été définis sur optional pour permettre de spécifier 0 comme valeur. Cela permet de cibler les recherches de voyages effectuées le jour même.

Performance Max

• (Pour les comptes autorisés uniquement) Consignes relatives à la marque
  • Campaign.brand_guidelines_enabled Ne peut être modifié que lors de la création d'une campagne Performance Max.
  • Ce type de campagne est incompatible avec Performance Max pour les objectifs de voyage.
  • Pour activer les consignes relatives à la marque pour les campagnes Performance Max existantes, utilisez un CampaignService.EnablePMaxBrandGuidelines récemment ajouté. Il n'est pas possible de désactiver les consignes relatives à la marque.
  • Ajout de Campaign.brand_guidelines et BrandGuidelines pour permettre de définir les couleurs et la famille de polices de la marque.
  • Nouvelles valeurs d'erreur :
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
  • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• Ajout de AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS pour permettre la génération automatique de composants vidéo améliorés pour les campagnes Performance Max.

Planification

• (Comptes autorisés uniquement) Ajout de ContentCreatorInsightsService.GenerateTrendingInsights qui permet aux utilisateurs de voir les thèmes de contenu tendance sur YouTube pour des définitions d'audience données.
• Ajout de GenerateCreatorInsightsRequest.country_locations[] pour spécifier les pays dans lesquels rechercher les critères donnés
• Ajout de GenerateCreatorInsightsRequest.search_brand pour spécifier une marque à rechercher pour les créateurs
• Ajout de nouveaux champs à YouTubeChannelInsights pour fournir des informations supplémentaires sur le canal pour les requêtes search_channels :
  • channel_url
  • channel_description
  • top_videos
• Ajout de champs de métadonnées à AudienceInsightsAttributeMetadata :
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

Vidéos

• Suite à la publication de DataLinkService.CreateDataLink, nous avons ajouté les méthodes suivantes pour permettre la modification des liens de données précédemment créés :
  • RemoveDataLink pour supprimer les associations de données dans un compte Google Ads
  • UpdateDataLink pour accepter, refuser et révoquer les associations de données dans un compte Google Ads
• Suppression de la compatibilité avec VIDEO_OUTSTREAM des énumérations suivantes :
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

Notes de version archivées

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