Zoektermen zijn de woorden die mensen echt hebben getypt, in tegenstelling tot de zoekwoorden die je hebt gekocht. In het gat tussen die twee zit het grootste deel van de verspilde uitgaven, en het lezen ervan is één aanroep die niets kan veranderen.
De aanroep
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'
De query is in de Google Ads Query Language, en alles wat Google rapporteert kan zo worden opgevraagd: campagnes, advertentiegroepen, zoekwoorden, advertenties, assets, budgetten, conversies, doelgroepen, de wijzigingsgeschiedenis. Tot 200 rijen per antwoord.
Lezen wat terugkomt
- Kosten staan in micros: 1.000.000 micros is één eenheid van de valuta van het account. Een term met 4.310.000 kostte 4,31.
- Een term met uitgaven en zonder conversies in dertig dagen is het eerste om naar te kijken, en het gebruikelijke antwoord is een uitsluitend zoekwoord in plaats van een biedingswijziging.
- De GET neemt de query in de URL; POST naar hetzelfde adres neemt haar in een body, voor een query die te lang is om erin te passen. Beide lezen alleen.
Niets in dit recept kan het account veranderen. Een rapport is een lezing, en de aanroep die iets verandert is een andere, met een mens aan het eind.
Veelgestelde vragen
Moet ik GAQL kennen?
Om een query met de hand te schrijven wel, en hij lijkt genoeg op SQL om te lezen zonder hem te leren. In de praktijk schrijft een AI-agent op deze sleutel de query uit wat je in woorden vroeg, voert hem uit en leest je de rijen voor.
Waarom micros?
Zo rapporteert Google geld, dus zo antwoordt dit ook: een geheel getal in miljoenste delen, wat de afrondingsfouten voorkomt die je zou krijgen als je breuken van een valuta rondgeeft. Deel door een miljoen voor het bedrag dat een mens zou noemen.
Kan een rapport het account aanraken?
Nee. De rapportaanroep weigert alles wat geen SELECT is, dus er is geen query die je erdoorheen kunt sturen die een account verandert — een vergissing kost je hier een verwarrend antwoord en verder niets.