Google Ads Code Api

La version 18 de l'API Google Ads est désormais disponible

Google Ads a publié une mise à jour de l'API Google Ads, version 18. La version 18 comprend des mises à jour concernant la gestion des comptes, les groupes d'annonces, les annonces, les éléments, les campagnes, les hôtels/voyages, les locaux, PMax, les rapports et bien plus encore. Il s'agit d'une mise à jour majeure de l'API Google Ads.

Voici une vidéo de l'équipe de l'API Google Ads sur quelques points forts des nouveautés :

Avant cette version, il y avait la version 17.1 en août, puis avant cela, la version 17.0 en juin 2024, puis avant cela, la version 16.1, puis la version 16 en février 2024. Avant cela, il y avait la version 15 en octobre 2023. Puis avant cela, il y avait la version 14.1 qui est sorti en août. La version 13.1 a précédé cette nouvelle version, sortie en avril 2023. La version 12.0 a été publiée en octobre 2022, la version 11.0 de l'API Google Ads a été publiée en juin et la version 11.1 en août. La version 10.1 a également été publiée le 27 avril 2022 et la version 10.0 le 9 février 2022. Et Google a mis fin à l'API AdWords le 27 avril, qui cessera complètement de fonctionner fin juillet.

Voici le journal complet des modifications :

Gestion des comptes :

  • (Pour les comptes sur liste blanche uniquement) Ajout de DataLinkService.CreateDataLink, qui permet de lier un compte Google Ads aux vidéos de créateur hébergées sur la chaîne YouTube du créateur. L'association de vidéos permet au compte Google Ads de diffuser des annonces de partenariat à l'aide de vidéos de créateurs.

Groupes d'annonces :

  • Ajout d'AdGroup.exclude_demographic_expansion qui vous permet d'exclure les données démographiques de l'expansion lorsqueoptimized_targeting_enabled est vrai, une fonctionnalité qui n'était auparavant prise en charge que pour Demand Gen.

Annonces :

  • Ajout d'AdGroupAd.ad_group_ad_asset_automation_settings, qui permet d'activer ou de désactiver la génération automatique d'éléments pour les annonces.

  • Ajout des valeurs suivantes à AssetAutomationType :

  • GENERATE_VERTICAL_YOUTUBE_VIDEOS

  • GENERATE_SHORTER_YOUTUBE_VIDEOS

  • Ajout d'AdNetworkType.GOOGLE_OWNED_CHANNELS, qui est utilisé par les annonces diffusées sur les chaînes appartenant à Google telles que YouTube, Gmail et le flux Discover.

Actifs:

  • Renommé AssetType.DISCOVERY_CAROUSEL_CARD en 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 de dernier clic d'une campagne.

  • Ajout des statistiques suivantes liées au visionnage de vidéos pour une campagne :

  • metrics.video_view_rate_in_feed

  • metrics.video_view_rate_in_stream

  • metrics.video_view_rate_shorts

  • 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 de false à true.

Critère:

  • Ajout de content_criterion_view qui renvoie des mesures de performances des contenus ciblés, tels que des mots clés, des emplacements et des sujets, pour les campagnes display, de génération de demande et vidéo.

Hôtellerie et voyages :

  • Prise en charge des flux de voyage dans les annonces du Réseau de Recherche

  • Ajout de ClickType.TRAVEL_ASSETS pour permettre la segmentation des métriques des flux de voyage dans les annonces de recherche.

  • Ajout de AssetSetType.TRAVEL_FEED qui peut être utilisé pour activer et désactiver l'utilisation de Travel Feed dans les annonces de recherche.

  • (Pour les comptes sur liste verte uniquement) Ajout d'un itinéraire de voyage en tant que nouvelle règle de valeur de conversion avec les nouveaux champs et valeurs suivants :

  • ConversionValueRule.itinerary_condition avec ValueRuleItineraryCondition, qui permet de spécifier une fenêtre de réservation à l'avance, une longueur d'itinéraire et un jour de début de voyage par semaine

  • ConversionValueRulePrimaryDimensionEnum.ITINERARY

  • ValueRuleSetDimension.ITINERAIRE

  • Ajout des segments suivants pour les rapports sur les campagnes et les groupes d'annonces afin de permettre la segmentation des données de performances en fonction de destinations spécifiques (villes, pays et régions) pour les campagnes d'hôtel et de recherche :

  • segments.travel_destination_city

  • segments.travel_destination_country

  • segments.travel_destination_region

Services locaux :

  • PhoneCallDetails.call_recording_url sera vide, au lieu de fournir une URL non valide si l'enregistrement de l'appel n'existe pas pour la conversation principale des services locaux donnée.

  • Ajout de CategoryBid.target_cpa_bid_micro qui permet de définir le CPA cible pour une catégorie via Campaign.local_services_campaign_settings.

Performances maximales :

  • PSupport pour les directives de la marque

  • Ajout de Campaign.brand_guidelines_enabled qui indique si les directives de marque sont activées pour une campagne Performance Max donnée. Si cette option est activée, les ressources dont field_type est défini sur BUSINESS_NAME, LOGO, LANDSCAPE_LOGO doivent être liées en tant que ressources CampaignAsset au lieu de ressources AssetGroupAsset.

  • Ajout des erreurs CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED et CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, qui indiquent que les campagnes Performance Max avec les directives de marque activées ne disposent pas des ressources CampaignAsset requises liées à la campagne.

  • Lorsque les directives de marque sont activées, au moins un élément avec field_type défini sur BUSINESS_NAME et au moins un avec LOGO doivent être liés à la campagne en tant que ressources CampaignAsset. Les campagnes Performance Max pour les ventes en ligne avec un flux de produits doivent répondre à cette exigence uniquement lorsque des éléments sont associés aux groupes d'éléments de la campagne.

  • Ajout des valeurs suivantes à AssetLinkError :

  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, qui est généré lorsque vous tentez de lier des éléments de marque à des campagnes en tant que ressources CampaignAsset au lieu de ressources AssetGroupAsset dans les campagnes Performance Max pour lesquelles les consignes de marque ne sont pas activées.

  • Erreur BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, qui est générée lorsque vous tentez d'associer des éléments de marque à des campagnes en tant que ressources AssetGroupAsset au lieu de ressources CampaignAsset dans les campagnes Performance Max avec les directives de marque activées.

  • Ajout de performance_max_placement_view qui renvoie les impressions des emplacements sur lesquels les annonces Performance Max ont été diffusées.

  • Ajout de AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planification:

  • (Pour les comptes sur liste blanche uniquement) Ajout d'un nouveau service avec la méthode ContentCreatorInsightsService.GenerateCreatorInsights, qui permet aux utilisateurs d'explorer des informations sur les principaux créateurs YouTube. Cela permet aux clients de rechercher des créateurs en fonction d'une combinaison de ciblage d'audience et de ciblage de contenu ou d'informations sur les créateurs à partir d'une liste d'identifiants de chaîne YouTube.

  • Mises à jour de AudienceInsightsService.GenerateSuggestedTargetingInsights :

  • Audience, baseline_audience et data_month déplacés vers audience_definition.

  • Ajout de audience_description pour générer des suggestions de ciblage à partir d’une description textuelle libre à l’aide de Gen AI.

  • Ajout de AudienceInsightsService.GenerateTargetingSuggestionMetrics qui renvoie des mesures de portée potentielle pour des combinaisons de ciblage d'audience données.

Recommandations :

  • RecommendationService.GenerateRecommendations peut désormais être utilisé pour générer des recommandations sur les suggestions de budget optimisé lors de la construction de la campagne, en incluant le type de recommandation CAMPAIGN_BUDGET dans GenerateRecommendationsRequest.recommendation_types.[]. Cela fonctionne pour les campagnes Performance Max et sur le Réseau de Recherche.

Rapports :

  • Remplacement des champs summary_row_setting et return_total_results_count de SearchGoogleAdsRequest par le champ search_settings, dont le type est SearchSettings par les champs suivants :

  • omettre_results

  • return_summary_row

  • return_total_results_count

  • Ajout des nouvelles métriques suivantes sur les clics invalides généraux, tels que ceux générés par des robots ou des robots d'exploration, ceux ayant des modèles irréguliers. Ils peuvent être interrogés avec le rapport de campagne.

  • metrics.general_invalid_clicks

  • metrics.general_invalid_click_rate

  • Ajout des valeurs suivantes à QuotaError :

  • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION

  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

C'est tout, les amis.

Discussion sur le forum à X.

L'équipe IBS Paris
L'équipe IBS Paris

IBS Paris, fondée en 2011, est pionnière dans l'intégration de l'innovation et du digital au cœur de son enseignement en école de commerce. Elle cultive une communauté étudiante engagée, favorisant l'excellence et le travail d'équipe. Ce creuset d’ambition prépare ses étudiants à devenir des leaders éclairés dans le monde du commerce global.