Google a récemment annoncé la sortie de la version 17 (v17) de l’API Google Ads, un outil essentiel pour les développeurs qui souhaitent gérer leurs campagnes publicitaires de manière programmatique sur la plateforme Google Ads. Cette nouvelle version introduit plusieurs changements significatifs visant à améliorer l’efficacité, à enrichir les capacités de reporting et à simplifier la gestion des campagnes.
Améliorations des Politiques d’Utilisation des Ressources
En préparation d’un changement imminent de la politique d’utilisation des ressources prévu pour le 17 juin 2024, la version 17 de l’API Google Ads introduit deux nouveaux codes d’erreur pour le QuotaError. Ces codes permettent d’identifier les cas de consommation excessive des ressources au fil du temps par des modèles de requêtes spécifiques utilisés dans les services GoogleAdsService.Search et GoogleAdsService.SearchStream.
Standardisation de la Taille des Pages
Le champ page_size, utilisé pour contrôler le nombre de résultats retournés dans une seule requête, est désormais fixé à 10 000. Toute tentative de spécifier une taille de page personnalisée dans les appels GoogleAdsService.Search entraînera une RequestError. Cette standardisation vise à uniformiser la gestion des volumes de données retournées par les requêtes.
Rapports Améliorés pour les Campagnes Performance Max et Search
La v17 introduit deux nouvelles vues de reporting : campaign_aggregate_asset_view et channel_aggregate_asset_view. Ces vues permettent un reporting plus complet sur les métriques associées aux campagnes Performance Max et Search, offrant aux développeurs des insights plus approfondis sur la performance de leurs campagnes.
Améliorations du Traitement par Lots
Le support pour MutateOperation.asset_group_operation dans le BatchJobService est désormais disponible. Cela permet aux développeurs de tirer parti du traitement par lots pour créer et gérer des campagnes Performance Max entières. Un nouveau code d’erreur, BatchJobError.REQUEST_TOO_LARGE, a été ajouté pour identifier les requêtes dépassant la taille maximale autorisée (10 484 504 octets) dans AddBatchJobOperationsRequest. Les développeurs rencontrant cette erreur devraient diviser leurs opérations en lots plus petits pour une soumission réussie.
Améliorations de la Gestion des Campagnes
Un nouveau champ, Campaign.keyword_match_type, permet aux développeurs de définir un type de correspondance de mots-clés uniforme pour tous les mots-clés au sein d’une campagne. De plus, la méthode AdService.getAd a été supprimée pour maintenir la cohérence avec les autres services de l’API Google Ads. Les développeurs sont encouragés à se référer à la documentation « Retrieving objects » pour des méthodes alternatives de récupération des ressources.
Les champs primary_status et primary_status_reasons ont été ajoutés à AdGroupCriterion. Ces champs fournissent des informations sur l’état actuel de diffusion d’un critère de groupe d’annonces et, le cas échéant, les raisons de son statut inactif.
Nouveau Rapport sur les Produits Shopping
La v17 introduit le rapport shopping_product, qui correspond à la page « Produits » dans l’interface utilisateur de Google Ads. Ce rapport offre aux développeurs un accès détaillé aux données produits associées à leurs campagnes Google Ads.
Améliorations de la Validation des Actifs Image
Des validations plus strictes ont été mises en œuvre pour ImageAdInfo.image_asset en ce qui concerne les dimensions et les formats d’image. Cela aligne les normes de validation des images avec les standards existants à travers l’API Google Ads.
Améliorations du Reporting des Valeurs de Conversion de SkAdNetwork
Un nouveau segment, sk_ad_network_redistributed_fine_conversion_value, a été ajouté pour redistribuer les valeurs nulles en se basant sur un modèle d’apprentissage automatique analysant les données postback récentes de SkAdNetwork. Cette amélioration fournit aux développeurs des rapports de valeur de conversion plus précis et complets pour les campagnes SkAdNetwork.
Renommage de Discovery en Demand Gen
Le terme « Discovery » a été remplacé par « Demand Gen » dans tous les champs, énumérations et erreurs concernés au sein de l’API Google Ads. Ce changement vise à clarifier et à moderniser la terminologie employée dans les rapports et les analyses.
Amélioration du Ciblage des Liens Produit
Lors de la requête product_link, les développeurs peuvent désormais sélectionner des champs relatifs à un seul produit lié à la fois. Ne pas respecter cette contrainte entraînera une QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE.
Gestion des Types de Clients Figurant sur les Listes d’Audience
Une nouvelle méthode, UserListCustomerTypeService.MutateUserListCustomerTypes, a été introduite pour configurer les types de clients d’audience. Cette méthode remplace l’utilisation précédente du paramètre CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.
Expiration des Artifacts de Vérification des Services Locaux
Deux nouveaux champs expiration_date_time ont été ajoutés à local_services_verification_artifact. Cela permet aux annonceurs de suivre et de surveiller facilement les dates d’expiration de leurs artifacts de vérification.
