Termos de pesquisa são as palavras que as pessoas realmente digitaram, em oposição às palavras-chave que você comprou. A distância entre uma coisa e outra é onde mora a maior parte do gasto desperdiçado, e lê-la é uma chamada que não pode mudar nada.
A chamada
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'
A consulta é em Google Ads Query Language, e tudo o que o Google informa pode ser pedido assim: campanhas, grupos de anúncios, palavras-chave, anúncios, recursos, orçamentos, conversões, públicos, o histórico de alterações. Até 200 linhas por resposta.
Lendo o que volta
- O custo vem em micros: 1.000.000 de micros é uma unidade da moeda da conta. Um termo com 4.310.000 custou 4,31.
- Um termo com gasto e sem conversões em trinta dias é a primeira coisa a olhar, e a resposta habitual é uma palavra-chave negativa e não uma mudança de lance.
- O GET leva a consulta na URL; o POST para o mesmo endereço a leva num corpo, para uma consulta longa demais para caber. Os dois só leem.
Nada nesta receita pode alterar a conta. Um relatório é uma leitura, e a chamada que muda alguma coisa é outra, com uma pessoa do outro lado.
Perguntas frequentes
Preciso saber GAQL?
Para escrever uma consulta à mão, sim, e ela é parecida o bastante com SQL para ser lida sem aprender. Na prática, um agente de IA com esta chave escreve a consulta a partir do que você pediu em palavras, executa e lê as linhas para você.
Por que micros?
É como o Google informa dinheiro, então é como isto responde: um inteiro de milionésimos, que evita o arredondamento que você teria ao passar frações de uma moeda de um lado para outro. Divida por um milhão para obter o valor que uma pessoa diria.
Um relatório pode tocar na conta?
Não. A chamada de relatório recusa tudo o que não seja um SELECT, então não existe consulta que você possa passar por ela que altere uma conta — um erro aqui custa uma resposta confusa e nada mais.