Пошукові запити — це слова, які люди справді набрали, на відміну від ключових слів, які ви купили. Між ними лежить більша частина марно витрачених грошей, і прочитати цю різницю можна одним викликом, який нічого не здатен змінити.
Виклик
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, тож через нього не можна пропустити жодного запиту, який змінив би акаунт: помилка тут коштує вам лише незрозумілої відповіді й нічого більше.