Suchbegriffe sind die Wörter, die Menschen tatsächlich getippt haben, im Gegensatz zu den Keywords, die Sie gekauft haben. In der Lücke zwischen beiden liegt der größte Teil der verschwendeten Ausgaben, und sie zu lesen ist ein Aufruf, der nichts verändern kann.
Der Aufruf
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'
Die Abfrage ist in der Google Ads Query Language, und alles, was Google berichtet, lässt sich auf diese Weise erfragen: Kampagnen, Anzeigengruppen, Keywords, Anzeigen, Assets, Budgets, Conversions, Zielgruppen, den Änderungsverlauf. Bis zu 200 Zeilen pro Antwort.
Lesen, was zurückkommt
- Die Kosten stehen in micros: 1.000.000 micros sind eine Einheit der Währung des Kontos. Ein Begriff mit 4.310.000 hat 4,31 gekostet.
- Ein Begriff mit Ausgaben und ohne Conversions in dreißig Tagen ist das Erste, was man sich ansieht, und die übliche Antwort ist ein ausschließendes Keyword, keine Gebotsänderung.
- Das GET nimmt die Abfrage in der URL; POST an dieselbe Adresse nimmt sie in einem Body, für eine Abfrage, die zu lang ist, um hineinzupassen. Beide lesen nur.
Nichts in diesem Rezept kann das Konto verändern. Ein Bericht ist ein Lesen, und der Aufruf, der etwas ändert, ist ein anderer, mit einem Menschen am Ende.
Häufige Fragen
Muss ich GAQL können?
Um eine Abfrage von Hand zu schreiben, ja, und sie ist SQL nah genug, um sie zu lesen, ohne sie zu lernen. In der Praxis schreibt ein KI-Agent an diesem Schlüssel die Abfrage aus dem, was Sie in Worten verlangt haben, führt sie aus und liest Ihnen die Zeilen vor.
Warum micros?
So berichtet Google Geld, also antwortet es hier auch so: als ganze Zahl in Millionsteln, was die Rundungsfehler vermeidet, die Sie beim Herumreichen von Bruchteilen einer Währung bekämen. Teilen Sie durch eine Million, um den Betrag zu erhalten, den ein Mensch nennen würde.
Kann ein Bericht das Konto anfassen?
Nein. Der Berichtsaufruf lehnt alles ab, was kein SELECT ist, es gibt also keine Abfrage, die Sie hindurchschicken könnten und die ein Konto verändert — ein Fehler kostet Sie hier eine verwirrende Antwort und sonst nichts.