Les termes de recherche sont les mots que les gens ont réellement tapés, par opposition aux mots clés que vous avez achetés. L'écart entre les deux est l'endroit où se loge l'essentiel des dépenses gaspillées, et le lire tient en un appel qui ne peut rien changer.
L'appel
curl -sG https://top-rated.team/google-ads/v1/accounts/1234567890/report \ -H "X-API-KEY: $MAKEHYBRID_KEY" \ --data-urlencode 'query=SELECT search_term_view.search_term, metrics.impressions, metrics.clicks, metrics.cost_micros, metrics.conversions FROM search_term_view WHERE segments.date DURING LAST_30_DAYS ORDER BY metrics.cost_micros DESC' \ --data-urlencode 'max_rows=200'
La requête est en Google Ads Query Language, et tout ce que Google rapporte peut être demandé ainsi : campagnes, groupes d'annonces, mots clés, annonces, assets, budgets, conversions, audiences, l'historique des modifications. Jusqu'à 200 lignes par réponse.
Lire ce qui revient
- Le coût est en micros : 1 000 000 de micros font une unité de la devise du compte. Un terme à 4 310 000 a coûté 4,31.
- Un terme avec des dépenses et sans conversion en trente jours est la première chose à regarder, et la réponse habituelle est un mot clé négatif plutôt qu'un changement d'enchère.
- Le GET prend la requête dans l'URL ; un POST à la même adresse la prend dans un corps, pour une requête trop longue pour tenir. Les deux ne font que lire.
Rien dans cette recette ne peut modifier le compte. Un rapport est une lecture, et l'appel qui change quelque chose est un autre, avec une personne au bout.
Questions fréquentes
Faut-il connaître GAQL ?
Pour écrire une requête à la main, oui, et il ressemble assez à SQL pour se lire sans l'apprendre. En pratique, un agent IA sur cette clé écrit la requête à partir de ce que vous avez demandé avec des mots, l'exécute et vous lit les lignes.
Pourquoi des micros ?
C'est ainsi que Google rapporte l'argent, donc c'est ainsi que cela répond : un entier de millionièmes, ce qui évite les arrondis qu'on aurait en faisant circuler des fractions d'une devise. Divisez par un million pour obtenir le montant qu'une personne énoncerait.
Un rapport peut-il toucher au compte ?
Non. L'appel de rapport refuse tout ce qui n'est pas un SELECT, donc aucune requête passée par lui ne peut altérer un compte — une erreur ici vous coûte une réponse déroutante et rien d'autre.