Поисковые запросы — это слова, которые люди действительно набрали, в отличие от ключевых слов, которые вы купили. Между ними лежит большая часть впустую потраченных денег, и прочитать эту разницу можно одним вызовом, который ничего не способен изменить.
Вызов
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'
Запрос написан на языке запросов Google Ads (GAQL), и так можно спросить всё, что Google готов отчитать: кампании, группы объявлений, ключевые слова, объявления, ресурсы, бюджеты, конверсии, аудитории, историю изменений. До 200 строк в ответе.
Как читать ответ
- Стоимость указана в micros: 1 000 000 micros — это одна единица валюты аккаунта. Запрос, стоивший 4 310 000, обошёлся в 4,31.
- Запрос с расходами и без конверсий за тридцать дней — первое, на что стоит посмотреть, и обычный ответ — минус-слово, а не изменение ставки.
- GET принимает запрос в URL; POST на тот же адрес принимает его в теле, если запрос слишком длинный. Оба только читают.
Ничто в этом рецепте не может изменить аккаунт. Отчёт — это чтение, а вызов, который что-то меняет, — другой, и на его конце стоит человек.
Вопросы, которые задают
Нужно ли знать GAQL?
Чтобы писать запрос вручную — да, он достаточно похож на SQL, чтобы читать его, не изучая. На практике ИИ-агент с этим ключом пишет запрос по тому, что вы попросили словами, выполняет его и зачитывает вам строки.
Почему micros?
Так Google отчитывается о деньгах, так отвечаем и мы: целое число миллионных долей, которое избавляет от округлений, возникающих, когда передаёшь доли валюты. Разделите на миллион — получится сумма, которую назвал бы человек.
Может ли отчёт затронуть аккаунт?
Нет. Вызов отчёта отклоняет всё, что не SELECT, так что через него нельзя пропустить ни одного запроса, который изменил бы аккаунт: ошибка здесь стоит вам лишь непонятного ответа и ничего больше.