Version 19 (26/02/2025)
Les fonctionnalités et modifications suivantes ont été ajoutées dans la version 19.
Gestion du compte
- Ajout des valeurs suivantes à
CustomerErrorpour tenir compte des modifications à venir :CREATION_DENIED_FOR_POLICY_VIOLATIONCREATION_DENIED_INELIGIBLE_MCC
Annonces
- Ajout de
DemandGenMultiAssetAdInfo.tall_portrait_marketing_imagespour prendre en charge les composants Image en mode portrait au format 9:16 dans les annonces de génération de la demande.
Éléments
- (Pour les comptes de la liste d'autorisation uniquement) Prise en charge des composants de message via
Asset.business_message_asset,BusinessMessageAssetet les énumérations et erreurs suivantes.- Énumérations :
- Ajout de
AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEWpour générer automatiquement un aperçu de la page de destination. AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOSest désormais activé par défaut pour les annonces vidéo responsives 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_assetetAppDeepLinkAsset.
Conversions
- Objectifs de conversion
LifecycleGoalValueSettings.high_lifetime_valuen'est plus en version bêta et est désormais modifiable.- Ajout de
CustomerLifecycleGoal.owner_customerpour afficher le nom de la ressource du client propriétaire de l'objectif de cycle de vie du 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 des composants pour atteindre le même objectif. Consultez les notes de migration pour obtenir la liste de toutes les entités supprimées.
Hôtels et voyages
min_daysetmax_daysdeValueRuleItineraryAdvanceBookingWindowont été définis comme champoptionalpour permettre de spécifier 0 comme valeur. Cela permet de cibler les recherches de voyages effectuées aujourd'hui.
Performance Max
- (Pour les comptes de la liste d'autorisation uniquement) Consignes relatives à la marque
Campaign.brand_guidelines_enabledest désormais modifiable uniquement lors de la création d'une campagne Performance Max.- Cette fonctionnalité est incompatible avec Performance Max pour les objectifs de voyage.
- Pour activer les consignes relatives à la marque pour les campagnes Performance Max existantes, utilisez la nouvelle
CampaignService.EnablePMaxBrandGuidelines. Vous ne pouvez pas désactiver les consignes relatives à la marque. - Ajout de
Campaign.brand_guidelineset deBrandGuidelinespour définir les couleurs et la famille de polices de la marque. - Nouvelles valeurs d'erreur :
BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILUREBrandGuidelinesMigrationErrorBRAND_GUIDELINES_ALREADY_ENABLEDCANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGNBRAND_GUIDELINES_LOGO_LIMIT_EXCEEDEDCANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDEDAUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTEDTOO_MANY_ENABLE_OPERATIONS
CampaignErrorBRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGNBRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIREDBRAND_GUIDELINES_COLOR_INVALID_FORMATBRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILYBRAND_GUIDELINES_UNSUPPORTED_CHANNELCANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALSCUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
- Ajout de
AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOSpour générer automatiquement des composants vidéo améliorés pour les campagnes Performance Max.
Planification
- (Pour les comptes de la liste d'autorisation uniquement) Ajout de
ContentCreatorInsightsService.GenerateTrendingInsights, qui permet aux utilisateurs de voir les sujets 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_brandpour spécifier une marque à rechercher pour les créateurs - Ajout de nouveaux champs à
YouTubeChannelInsightspour fournir des informations supplémentaires sur les canaux pour les requêtessearch_channels:channel_urlchannel_descriptiontop_videos
- Ajout de nouveaux champs de métadonnées à
AudienceInsightsAttributeMetadata:youtube_video_metadatauser_interest_attribute_metadataknowledge_graph_attribute_metadata
Vidéos
- Après la sortie de
DataLinkService.CreateDataLink, nous avons ajouté les méthodes suivantes pour permettre de modifier les liens de données créés précédemment :RemoveDataLinkpour supprimer des associations de données dans un compte Google AdsUpdateDataLinkpour accepter, refuser et révoquer des associations de données dans un compte Google Ads
- Suppression de la compatibilité avec
VIDEO_OUTSTREAMdes énumérations suivantes :
Version 18 (16/10/2024)
Les nouvelles fonctionnalités et améliorations suivantes ont été ajoutées dans la version 18.
Gestion du compte
- (Pour les comptes de la liste d'autorisation uniquement) Ajout de
DataLinkService.CreateDataLink, qui permet d'associer un compte Google Ads aux vidéos de créateurs hébergées sur leur chaîne YouTube. L'association de vidéos permet au compte Google Ads de diffuser des annonces en partenariat à l'aide de vidéos de créateurs.
Groupes d'annonces
- Ajout de
AdGroup.exclude_demographic_expansion, qui vous permet d'empêcher l'expansion des données démographiques lorsqueoptimized_targeting_enabledesttrue. Cette fonctionnalité n'était auparavant compatible qu'avec les campagnes de génération de la demande.
Annonces
- Ajout de
AdGroupAd.ad_group_ad_asset_automation_settings, qui permet d'activer ou de désactiver la génération automatique d'assets pour les annonces. - Ajout des valeurs suivantes à
AssetAutomationType:GENERATE_VERTICAL_YOUTUBE_VIDEOSGENERATE_SHORTER_YOUTUBE_VIDEOS
- Ajout de
AdNetworkType.GOOGLE_OWNED_CHANNELS, qui est utilisé par les annonces diffusées sur les canaux appartenant à Google, tels que YouTube, Gmail et le flux Discover.
Éléments
AssetType.DISCOVERY_CAROUSEL_CARDa été renomméAssetType.DEMAND_GEN_CAROUSEL_CARD.
Campagnes
- Ajout de
metrics.store_visits_last_click_model_attributed_conversions, qui renvoie le nombre de visites en magasin attribuées par le modèle d'attribution au dernier clic d'une campagne. - Ajout des métriques suivantes liées aux vues de vidéos pour une campagne :
- Ajout de
metrics.results_conversions_purchase, qui renvoie les achats de conversion pour les résultats des objectifs unifiés d'une campagne. - Modification de la valeur par défaut de
DemandGenCampaignSettings.upgraded_targeting, defalseàtrue.
Critère
- Ajout de
content_criterion_view, qui renvoie les métriques de performances des contenus ciblés, tels que les mots clés, les emplacements et les thèmes, pour les campagnes display, de génération de la demande et vidéo.
Hôtels et voyages
- Prise en charge des flux de voyage dans les annonces sur le Réseau de Recherche
- Ajout de
ClickType.TRAVEL_ASSETSpour permettre la segmentation des métriques des flux de voyage dans les annonces sur le Réseau de Recherche. - Ajout de
AssetSetType.TRAVEL_FEED, qui permet d'activer et de désactiver l'utilisation du flux de voyage dans les annonces sur le Réseau de Recherche.
- Ajout de
- (Pour les comptes de la liste d'autorisation uniquement) Ajout de l'itinéraire de voyage en tant que nouvelle règle de valeur de conversion avec les nouveaux champs et valeurs suivants :
ConversionValueRule.itinerary_conditionavecValueRuleItineraryCondition, qui permet de spécifier une période de réservation à l'avance, une durée de séjour et un jour de début du voyageConversionValueRulePrimaryDimensionEnum.ITINERARYValueRuleSetDimension.ITINERARY
- Ajout des segments suivants pour les rapports
campaignetad_groupafin de pouvoir segmenter les données de performances en fonction de destinations spécifiques (villes, pays et régions) pour les campagnes d'hôtel et sur le Réseau de Recherche :
Local Services
PhoneCallDetails.call_recording_urlsera vide au lieu de fournir une URL non valide si l'enregistrement d'appel n'existe pas pour la conversation avec le prospect de services locaux donné.- Ajout de
CategoryBid.target_cpa_bid_micro, qui permet de définir le CPA cible d'une catégorie viaCampaign.local_services_campaign_settings.
Performance Max
- Respect des consignes relatives à la marque
- Ajout de
Campaign.brand_guidelines_enabled, qui indique si les consignes relatives à la marque sont activées pour une campagne Performance Max donnée. Si cette option est activée, les composants dont la valeurfield_typeest définie surBUSINESS_NAME,LOGOouLANDSCAPE_LOGOdoivent être associés en tant que ressourcesCampaignAssetau lieu de ressourcesAssetGroupAsset. - Ajout d'erreurs
CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKEDetCampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, qui indiquent que les campagnes Performance Max dont les consignes relatives à la marque sont activées ne sont pas associées aux ressourcesCampaignAssetrequises. - Lorsque les consignes relatives à la marque sont activées, au moins un composant avec
field_typedéfini surBUSINESS_NAMEet au moins un avecLOGOdoivent être associés à la campagne en tant que ressourcesCampaignAsset. Les campagnes Performance Max pour les ventes en ligne avec un flux de produits ne doivent répondre à cette exigence que lorsqu'il existe des composants associés aux groupes de composants de la campagne. - Ajout des valeurs suivantes à
AssetLinkError:BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, qui est généré lorsque vous essayez d'associer des composants de marque à des campagnes en tant que ressourcesCampaignAssetau lieu de ressourcesAssetGroupAssetdans des campagnes Performance Max pour lesquelles les consignes relatives aux marques ne sont pas activées.- Erreur
BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, qui s'affiche lorsque vous essayez d'associer des composants de marque à des campagnes en tant que ressourcesAssetGroupAssetau lieu de ressourcesCampaignAssetdans les campagnes Performance Max avec les consignes relatives à la marque activées.
- Ajout de
- Ajout de
performance_max_placement_view, qui renvoie les impressions des emplacements où les annonces Performance Max ont été diffusées. AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATIONa été ajouté
Planification
- (Pour les comptes de la liste d'autorisation uniquement) Ajout d'un nouveau service avec la méthode
ContentCreatorInsightsService.GenerateCreatorInsights, qui permet aux utilisateurs d'explorer des insights sur les meilleurs créateurs YouTube. Les clients peuvent ainsi rechercher des créateurs en fonction d'une combinaison de ciblage par audience et de ciblage par contenu, ou obtenir des insights sur les créateurs à partir d'une liste d'ID de chaîne YouTube. - Mises à jour de
AudienceInsightsService.GenerateSuggestedTargetingInsights:audience,baseline_audienceetdata_monthont été déplacés versaudience_definition.- Ajout de
audience_descriptionpour générer des suggestions de ciblage à partir d'une description textuelle libre à l'aide de l'IA générative.
- Ajout de
AudienceInsightsService.GenerateTargetingSuggestionMetrics, qui renvoie les métriques de couverture potentielle pour des combinaisons de ciblage d'audience données.
Recommandations
- Vous pouvez désormais utiliser
RecommendationService.GenerateRecommendationspour générer des recommandations sur les suggestions de budget optimisé lors de la création de la campagne. Pour ce faire, incluez le type de recommandationCAMPAIGN_BUDGETdansGenerateRecommendationsRequest.recommendation_types[]. Cela fonctionne pour les campagnes Performance Max et sur le Réseau de Recherche.
Rapports
- Remplacement des champs
summary_row_settingetreturn_total_results_countdeSearchGoogleAdsRequestpar le champsearch_settings, dont le type estSearchSettings, avec les champs suivants :omit_resultsreturn_summary_rowreturn_total_results_count
- Ajout des métriques suivantes sur les clics incorrects généraux, tels que ceux générés par des robots d'exploration ou des crawlers, et ceux présentant des schémas irréguliers. Vous pouvez les interroger à l'aide du rapport
campaign. - Ajout des valeurs suivantes à
QuotaError:EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTIONEXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
Version 17.1.0 (07/08/2024)
Les nouvelles fonctionnalités et améliorations suivantes ont été ajoutées dans la version v17_1.
Éléments
AdGroupAdService.RemoveAutomaticallyCreatedAssets()vous permet de supprimer des composants créés automatiquement spécifiés associés aux annonces responsives sur le Réseau de Recherche.
Audiences
- Nouvelles valeurs d'énumération dans
UserListCustomerTypeCategory:LOYALTY_TIER_1_MEMBERSLOYALTY_TIER_2_MEMBERSLOYALTY_TIER_3_MEMBERSLOYALTY_TIER_4_MEMBERSLOYALTY_TIER_5_MEMBERSLOYALTY_TIER_6_MEMBERSLOYALTY_TIER_7_MEMBERS
Campagnes
ShareablePreviewService.GenerateShareablePreviews()génère les URL (shareable_preview_urldans la réponse) des aperçus d'annonces partageables pour les groupes d'assets activés et mis en veille.- Le champ
expiration_date_timeindique la date d'expiration des URL dans la réponse. - Si une erreur se produit, la méthode renvoie
partial_failure_errorau lieu des URL.
- Le champ
Historique des modifications
- Nouveau type de ressource de modification d'état:
ASSET_GROUP.
Conversions
- Nouveau champ de segment pour la version SKAdNetwork:
segments.sk_ad_network_version offline_conversion_upload_conversion_action_summary, qui affiche les diagnostics d'importation des conversions au niveau de l'action de conversion.- Les métriques suivantes sont ajoutées aux rapports de diagnostic hors connexion pour indiquer le nombre de conversions importées qui sont toujours en cours de traitement :
Planification
AudienceInsights.GenerateAudienceOverlapInsights(), qui accepte un attribut principal et un ensemble d'attributs d'audience, et renvoie les estimations de la chevauchement de la couverture YouTube potentielle entre l'attribut principal et les attributs d'audience.
Rapports
- Prise en charge de la segmentation de
per_store_viewen fonction desegments.date
Vidéos
- Possibilité de récupérer des informations sur les stratégies d'enchères standards suivantes pour les campagnes vidéo à l'aide de rapports tels que
ad_groupetcampaign:Campaign.fixed_cpm(CPM fixe)Campaign.target_cpv(CPV cible)
Campaign.video_campaign_settings, qui vous permet de déterminer sur quels inventaires les annonces vidéo peuvent être diffusées à l'aide des champs de rapport suivants :segments.ad_format_type, qui vous permet de segmenter les rapports suivants en fonction du type de format d'annonce vidéo :
Version 17 (05/06/2024)
Les fonctionnalités et modifications suivantes ont été ajoutées dans la version 17.
Annonces
- Suppression de
AdService.getAd. Cela permet d'alignerAdServicesur les autres services de l'API Google Ads. Consultez la section Récupérer des objets pour découvrir la méthode recommandée pour extraire des annonces et d'autres types de ressources. - Ajout de validations pour
ImageAdInfo.image_assetconcernant les dimensions et le format. Les erreurs suivantes peuvent se produire si l'image n'est pas valide :
Éléments
- Ajout d'une nouvelle énumération:
ClickType.AD_IMAGE - Ajout des rapports suivants avec de nouvelles métriques pour les campagnes Performance Max et sur le Réseau de Recherche :
Audiences
Jobs par lots
- Ajout de
BatchJobError.REQUEST_TOO_LARGE, qui sera généré lorsque leAddBatchJobOperationsRequestenvoyé est supérieur à 1 048 4504 octets. - Ajout de la possibilité de définir
MutateOperation.asset_group_operationlors de l'utilisation deBatchJobService. Vous pouvez ainsi utiliser le traitement par lot pour créer et gérer des campagnes Performance Max entières. Consultez notre nouveau guide dédié.
Campagnes
- Modification du nom de "Discovery" en "Génération de la demande" dans tous les champs, énumérations et erreurs de toutes les ressources de l'API Google Ads, telles que les campagnes, les annonces et les composants. Par exemple,
AdvertisingChannelType.DISCOVERYest désormaisAdvertisingChannelType.DEMAND_GEN. - Ajout de
Campaign.keyword_match_typepour vous permettre de définir le type de correspondance des mots clés pour tous les mots clés d'une campagne.
Conversions
- Pour les conversions SKAdNetwork :
segments.sk_ad_network_conversion_valuea été renommésegments.sk_ad_network_fine_conversion_value.- Ajout de
segments.sk_ad_network_redistributed_fine_conversion_value.
- Les métriques suivantes sont désormais renvoyées avec la réponse, même si elles sont nulles. Elles sont ainsi cohérentes avec les autres métriques.
Critères
- Ajouté aux champs suivants dans
AdGroupCriterionpour indiquer si le critère de groupe d'annonces est diffusé ou les raisons pour lesquelles il ne l'est pas :primary_statusprimary_status_reasons
- Ajout de la prise en charge de
metrics.search_impression_sharepourgender_view - Ajout de la prise en charge de
metrics.phone_callspourkeyword_view
Local Services
- Ajout de
LocalServicesLeadService.AppendLeadConversation(), qui permet d'ajouter un nouveauLocalServicesLeadConversationàLocalServicesLead, qui envoie les messages aux utilisateurs via les canaux appropriés, comme les SMS, en fonction de la façon dont le prospect a été créé.- La taille de
AppendLeadConversationRequest.conversationsest limitée à 1 000. - Seul
LocalServicesLeadaveclead_typedéfini surLeadType.MESSAGEpeut être spécifié dansConversation.local_services_lead.
- La taille de
- Ajout de nouvelles valeurs d'énumération à
ConversationType:WHATSAPPpour représenter une conversation lancée via WhatsApp.ADS_APIpour représenter une conversation lancée à l'aide de la nouvelle méthodeLocalServicesLeadService.AppendLeadConversation().
- Ajout des champs suivants à
local_services_verification_artifact:local_services_verification_artifact.insurance_verification_artifact.expiration_date_timelocal_services_verification_artifact.license_verification_artifact.expiration_date_time
Rapports
- Vous ne pouvez désormais sélectionner que les champs liés à un produit associé lorsque vous interrogez
product_link. La sélection de plusieurs champs de plusieurs produits associés génère une exceptionQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Par exemple, vous ne pouvez pas sélectionnerproduct_link.advertising_partner.customeretproduct_link.data_partner.data_partner_iddans la même requête. - Transmettre un
page_sizeàGoogleAdsService.Searchgénère une erreurRequestError.PAGE_SIZE_NOT_SUPPORTED.
Shopping
- Ajout d'un nouveau rapport
shopping_product, qui correspond à la page Produits de l'UI Google Ads. Il permet de renvoyer des données sur l'état actuel des produits à partir de comptes Google Merchant Center associés à un compte Google Ads.- Vous pouvez filtrer les métriques du rapport
shopping_productà l'aide desegments.datelorsque vous utilisezGoogleAdsService.SearchouGoogleAdsService.SearchStream. La segmentation par date n'est pas autorisée et renvoie une erreurShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.
- Vous pouvez filtrer les métriques du rapport
Objectifs unifiés
- Ajout de
UserListCustomerTypeService.MutateUserListCustomerTypes()pour configurer les types de clients d'audience. - Suppression de
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. Pour configurer les paramètres d'audience des objectifs de cycle de vie client, utilisez plutôtUserListCustomerTypeService.MutateUserListCustomerTypes().- Associez ou dissociez une liste d'utilisateurs en définissant
UserListCustomerType.customer_type_categorysurUserListCustomerTypeCategory.PURCHASERSpour l'inclure ou l'exclure d'une définition de client existante pour les objectifs de cycle de vie des clients, respectivement. Pour en savoir plus, consultez Segmenter vos audiences.
- Associez ou dissociez une liste d'utilisateurs en définissant
Vidéos
- Ajout des valeurs suivantes à
ContentLabelType. Vous pouvez exclure cesContentLabelTypesau niveau du client :BRAND_SUITABILITY_CONTENT_FOR_FAMILIESBRAND_SUITABILITY_GAMES_FIGHTINGBRAND_SUITABILITY_GAMES_MATUREBRAND_SUITABILITY_HEALTH_SENSITIVEBRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINEDBRAND_SUITABILITY_NEWS_RECENTBRAND_SUITABILITY_NEWS_SENSITIVEBRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATUREDBRAND_SUITABILITY_POLITICSBRAND_SUITABILITY_RELIGION
- Ajout de
AdVideoAsset.ad_video_asset_infopour prendre en charge les préférences d'inventaire pour les composants vidéo lors de la création deDemandGenVideoResponsiveAdInfo. - (Comptes de la liste d'autorisation uniquement)
Campaign.video_brand_safety_suitabilityest devenu modifiable.
Notes de version archivées
Pour consulter les notes de version archivées, consultez la section Versions obsolètes.