Et ARBEN KQIKU
Google a annoncé la date d'arrêt de l'API AdWords : quiconque l'utilise pour récupérer des données doit désormais basculer vers la nouvelle API Google Ads.
Google a récemment annoncé l'arrêt de l'API AdWords le 27 avril 2022. Passé cette date, les annonceurs qui utilisent l'API pour récupérer les données de leurs campagnes Google Ads ne recevront plus les analyses de performance essentielles, ni les moyens de scaler des opérations comme la gestion des enchères. C'est un vrai problème pour tous ceux dont les scripts automatisés reposent sur l'ancienne API. Dans ce guide, on explique comment migrer vers la nouvelle API et comment profiter de ses nouvelles fonctions.
Qu'est-ce qui change ?
L'ancienne API laissait les annonceurs choisir entre différents types de rapports selon leurs besoins. Ils pouvaient par exemple créer des rapports de performance de campagne pour mesurer les résultats à l'échelle de la campagne, ou des rapports de performance de groupe d'annonces pour mesurer au niveau du groupe d'annonces. La nouvelle API Google Ads, elle, expose des ressources que l'on interroge, plutôt que des rapports de performance. Autrement dit, pour accéder aux données liées aux campagnes, on interroge la ressource campaigns au lieu du rapport de performance de campagne.
Comment fonctionne la nouvelle API ?
L'API AdWords d'origine utilise son propre langage de requête, l'AdWords Query Language (AWQL). La nouvelle API, elle, repose sur une interface programmatique moderne basée sur le Google Ads Query Language (GAQL). Ce langage sert à envoyer des requêtes via l'API Google Ads pour interroger des ressources et leurs attributs, segments et métriques associés, à l'aide du Google Ads Service. En pratique, cela veut dire que les scripts automatisés doivent être réécrits avec le nouveau langage de requête pour fonctionner avec la nouvelle API.
Comment construire des requêtes pour la nouvelle API
Construire ces requêtes demande une vraie expertise. Heureusement, des ressources existent pour aider les développeurs, à commencer par la documentation officielle de l'API Google Ads. Il y a aussi un nouvel outil Query Builder pour construire rapidement de nouvelles requêtes. Voici comment mettre en place une requête à partir de zéro avec cet outil :
- Choisissez le nom d'une ressource à interroger, par exemple campaign. Le Query Builder affiche alors la liste de tous les champs, segments et métriques associés à cette ressource.
- On peut ensuite naviguer entre les différents onglets en haut du formulaire : select, where, order by, limit et parameters.
- Dépliez l'onglet voulu pour révéler une liste de cases à cocher : champs de la ressource, segments et métriques. Cocher une case construit votre requête GAQL. En expérimentant un peu, vous comprendrez mieux comment segmenter, filtrer les ressources superflues et trier vos résultats avec les onglets select, where, order by et limit. Votre résultat final devrait ressembler à ceci :
Vous pouvez aussi utiliser le Query Builder pour vérifier rapidement la syntaxe et la structure, mais il faudra passer par l'outil Query Validator pour vous assurer que la requête est valide. Imaginons que l'on veuille valider la requête de la capture ci-dessus. Copiez-la simplement, ouvrez le Query Validator et collez-la dans le champ. Le validateur vous signale les éventuels problèmes.
Faut-il réécrire toutes les anciennes requêtes AWQL ?
Bonne nouvelle : vous n'avez pas besoin de réécrire de zéro toutes vos anciennes requêtes AWQL. Comme les conventions de nommage diffèrent nettement entre les deux API, l'approche de loin la plus rapide et la plus efficace consiste à utiliser l'outil de migration. Vous y saisissez la requête AWQL d'origine, qui est automatiquement convertie en une nouvelle requête GAQL. Si la conversion réussit, le résultat s'affiche en vert.
Voici un exemple concret d'utilisation de l'outil de migration. Ici, on va se servir d'un script Google Ads pour sélectionner les noms de campagnes contenant un label de campagne précis, puis comparer le résultat entre l'ancienne et la nouvelle API.
- Sélectionnez l'identifiant de votre compte Google Ads.
2. Sélectionnez une requête écrite dans l'ancien langage AWQL d'AdWords
Avec l'ancienne API AdWords, le code devrait ressembler à ceci :
Avec la nouvelle API Google Ads, le code devrait ressembler à ceci :
3. Rassemblez toutes les lignes de cette requête. Dans l'exemple ci-dessous, on utilise AdsApp.report() et report.rows() pour obtenir le résultat voulu avec l'ancienne API.
Avec la nouvelle API Google Ads, le code est plus concis et devrait ressembler à ceci :
4. Créez un conteneur et poussez-y toutes les lignes. Avec l'ancienne API AdWords, le résultat devrait ressembler à ceci :
À ce stade, il reste encore des lignes : on crée donc une nouvelle variable, row, dont on récupère le nom de campagne pour le pousser dans le conteneur allCampaigns. Le procédé diffère légèrement avec l'API Google Ads, car les ressources sont leurs propres objets. Par exemple, campaign.name devient deux entités distinctes : d'abord campaign, puis name.
Vous pouvez reporter les données récupérées par chaque API dans deux colonnes distinctes d'un Google Sheets ou d'un fichier Excel, puis comparer les résultats. Si la conversion s'est bien passée, les résultats doivent être identiques d'une API à l'autre.
Que se passe-t-il si vous ne migrez pas vers la nouvelle API ?
Quiconque utilise l'ancienne API AdWords pour récupérer des données doit migrer vers l'API Google Ads avant la date d'arrêt. À partir du 27 avril 2022, toutes les requêtes vers l'ancienne API échoueront, et les annonceurs ne pourront plus récupérer les insights indispensables sur la performance de leurs campagnes Google Ads. C'est un défi de taille pour ceux qui s'appuient massivement sur des scripts automatisés pour scaler des opérations comme le reporting de performance, la gestion des enchères et les tests A/B.
Cela dit, Google a rendu la migration des requêtes plutôt simple. C'est aussi l'occasion pour les annonceurs de profiter des atouts propres à cette montée de version : la possibilité d'étendre et de scaler leurs capacités de reporting grâce à un langage de requête plus intuitif. L'API Google Ads suit par ailleurs un rythme de publication régulier, avec de nouvelles fonctionnalités et des correctifs déployés fréquemment pour rester alignée sur les derniers standards de Google.
Vous avez encore du mal à prendre en main la nouvelle API ? comtogether peut vous aider à migrer vos scripts pour ne jamais manquer un insight décisif. Parlons-en dès aujourd'hui.