I termini di ricerca sono le parole che le persone hanno digitato davvero, in contrapposizione alle parole chiave che hai comprato. Lo scarto tra le due cose è dove vive la maggior parte della spesa sprecata, e leggerlo è una chiamata che non può cambiare nulla.
La chiamata
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 query è in Google Ads Query Language, e tutto ciò che Google riporta si può chiedere così: campagne, gruppi di annunci, parole chiave, annunci, asset, budget, conversioni, segmenti di pubblico, la cronologia delle modifiche. Fino a 200 righe per risposta.
Leggere ciò che torna
- Il costo è in micros: 1.000.000 di micros è un'unità della valuta dell'account. Un termine a 4.310.000 è costato 4,31.
- Un termine con spesa e senza conversioni in trenta giorni è la prima cosa da guardare, e la risposta abituale è una parola chiave esclusa e non una modifica dell'offerta.
- Il GET prende la query nell'URL; il POST allo stesso indirizzo la prende in un corpo, per una query troppo lunga per starci. Entrambi si limitano a leggere.
Nulla in questa ricetta può alterare l'account. Un report è una lettura, e la chiamata che cambia qualcosa è un'altra, con una persona dall'altra parte.
Domande frequenti
Devo conoscere GAQL?
Per scrivere una query a mano, sì, ed è abbastanza simile a SQL da poterla leggere senza impararla. In pratica un agente IA su questa chiave scrive la query da ciò che hai chiesto a parole, la esegue e ti legge le righe.
Perché i micros?
È come Google riporta il denaro, quindi è come risponde questa API: un intero di milionesimi, che evita gli arrotondamenti che avresti passando in giro frazioni di una valuta. Dividi per un milione per ottenere l'importo che direbbe una persona.
Un report può toccare l'account?
No. La chiamata di report rifiuta tutto ciò che non è un SELECT, quindi non esiste query che tu possa far passare di lì che alteri un account — un errore qui ti costa una risposta confusa e nient'altro.