Google Ads API — як ми його використовуємо
Soft Plus — студія веброзробки та реклами з Києва. Ми ведемо рекламні акаунти Google Ads для своїх клієнтів і зробили власний інструмент, який захищає ці акаунти від недійсних кліків і збирає щомісячні звіти. Ця сторінка пояснює, що саме той інструмент робить із Google Ads API.
Оновлено: 04.08.2026 · контакт розробника: info@soft-plus.dev1. Наша бізнес-модель
Soft Plus робить сайти та інтернет-магазини для малого й середнього бізнесу, а далі підтримує їх у роботі: хостинг, супровід, SEO та платна реклама. Наші клієнти — сервісні компанії й магазини в Україні та ЄС: аварійне відкриття замків, прийом брухту з регіональними філіями, стоматологія, ремонт пральних машин, магазин акумуляторів, маркетплейс сонячного обладнання.
Обмін цінністю простий. Клієнт платить нам фіксовану суму за створення сайту й щомісячну — за ведення реклами (налаштування від €118, ведення від €250 на місяць — наші публічні ціни). Натомість отримує кампанії, які ми налаштовуємо, контролюємо й оптимізуємо, і щомісячний звіт, де витрати зіставлені з реальними заявками. Рекламний бюджет клієнт сплачує напряму зі свого власного акаунта Google Ads. Ми не перепродаємо рекламний бюджет, не беремо з нього відсотка й не отримуємо комісії з продажів, зроблених через рекламу.
Кожен акаунт лишається власністю клієнта. Ми працюємо через свій менеджерський акаунт (MCC 237-063-0515), до якого клієнтські акаунти прив'язані з прямого дозволу клієнта й від'єднуються після завершення співпраці.
2. Інструмент: ClickGuard
ClickGuard — наше власне програмне забезпечення, написане й розміщене нами, яким користується лише наша команда і лише для акаунтів, які ми ведемо. Він виконує дві роботи:
- Захист від недійсних кліків. First-party скрипт на сайті самого клієнта фіксує реальні візити. ClickGuard зіставляє їх із кліками, які Google порахував оплаченими, оцінює джерела трафіку (повторні IP, діапазони дата-центрів і проксі, один відбиток браузера з багатьох адрес, сесії без жодної взаємодії, географія поза таргетингом кампанії) і додає адреси, з яких явно йде автоматичний трафік, до списку виключених IP кампанії.
- Звітність. Він забирає покази, кліки, витрати й конверсії по кожному акаунту й перетворює їх на щомісячний звіт, зрозумілий клієнту: ціна заявки, які ключові слова дали дзвінки, скільки бюджету пішло на трафік, який навіть не дійшов до сайту.
Це внутрішня панель, а не продукт на продаж. Публічної реєстрації немає, окремого прайсу на неї немає, стороннього доступу до неї немає.
3. Які сервіси API ми викликаємо
Інтеграція тонка — два сервіси, кілька запитів на читання й одна операція запису:
| Сервіс / ресурс | Операція | Для чого |
|---|---|---|
GoogleAdsService · campaign | SearchStream (читання) | Отримати увімкнені пошукові кампанії акаунта, щоб виключення застосовувалися саме до потрібних кампаній. |
GoogleAdsService · customer | SearchStream (читання) | Покази, кліки, витрати й конверсії за період — цифри у щомісячному звіті клієнта. |
GoogleAdsService · keyword_view | SearchStream (читання) | Статистика за ключовими словами за 30 днів: які запити дають заявки, а які лише палять бюджет. |
GoogleAdsService · campaign_criterion | SearchStream (читання) | Прочитати наявні налаштування: поточні виключення IP (щоб не додати дубль), гео-таргетинг і розклад показів (щоб трафік поза цільовим регіоном або поза робочим часом розпізнавався як аномальний). |
GoogleAdsService · geo_target_constant | SearchStream (читання) | Перетворити отримані ID гео-таргетів на зрозумілі назви місць для звіту. |
CampaignCriterionService | Mutate (запис) | Єдиний запис, який ми робимо: створення негативного критерію кампанії типу IP_BLOCK, щоб виключити адреси — джерела недійсного трафіку. Більше нічого не створюється, не змінюється й не видаляється: ні бюджети, ні ставки, ні оголошення, ні ключові слова. |
Авторизація — OAuth 2.0 з refresh-токеном, виданим власником кожного акаунта. Запити йдуть через наш менеджерський акаунт. Наразі працюємо на версії API v23.
4. Навіщо нам доступ до API
Обидві роботи вище неможливо робити руками на нашому обсязі, а одну з них узагалі неможливо зробити в інтерфейсі.
- Обсяг виключень. В одному аудиті клієнтського акаунта (сервіс ремонту пральних машин, липень 2026) Google нарахував 788 кліків і 49 214 грн за тридцять днів, тоді як до сайту дійшло лише 145 унікальних значень
gclid— 18%. Той аудит завершився додаванням 473 IP-адрес до списків виключень. Вносити 473 адреси через інтерфейс, кампанія за кампанією, і повторювати це щоразу, коли адреси змінюються, людина не встигає; API перетворює це на заплановану задачу. - Зіставлення оплачених кліків із реальними візитами. Це порівняння існує лише тоді, коли дані про кліки й дані нашого лічильника лежать поруч. Статистику кліків дає API — іншого способу завести її в систему немає.
- Звітність по кількох акаунтах. Ми забираємо щоденну статистику по акаунтах, які ведемо. Вивантажувати звіти руками з кожного акаунта щодня — це години, які довелося б виставляти клієнту в рахунок, і все одно з відставанням на добу.
Для клієнта це означає, що його рекламний бюджет купує візити людей, а не ботів, а звіт показує, що саме дали витрачені гроші. Для нас — різницю між веденням акаунтів і ручним переписуванням цифр між екранами.
5. Хто користується інструментом
Панеллю користується команда Soft Plus — ті, хто веде кампанії. Вхід із двофакторним підтвердженням. Клієнти в неї не заходять і не керують нею: вони отримують звіти, які вона формує, і сповіщення щодо власного акаунта — поштою й у Telegram. Ми не пропонуємо цей інструмент рекламодавцям поза колом своїх клієнтів і не беремо за нього окрему плату: він входить у послугу ведення реклами, за яку клієнт уже платить.
6. Поводження з даними
- Дані, отримані з акаунта, використовуються лише для цього акаунта — для його захисту та його звітів. Вони не об'єднуються, не перепродаються й не використовуються для іншого рекламодавця.
- Дані зберігаються на нашому сервері, доступ мають лише ті члени команди, яким він потрібен, передача — через HTTPS, облікові дані лежать поза кореневою текою сайту.
- Ми звертаємося до акаунта лише поки він прив'язаний до нашого менеджерського акаунта з дозволу клієнта. Після завершення співпраці зв'язок знімається, а збережені дані видаляються.
- Доступ використовуємо відповідно до Умов Google Ads API та політик Google, а контактну адресу розробника тримаємо актуальною, щоб листи від служби відповідності доходили до людини.
7. Чого ми не робимо
- Ми не афіліат і не займаємося партнерським маркетингом: не отримуємо комісії з продажів, згенерованих рекламою, і не рекламуємо чужі пропозиції за частку доходу.
- Не перепродаємо, не субліцензуємо й не відкриваємо стороннім доступ до Google Ads API чи до отриманих даних.
- Не створюємо акаунти Google Ads за когось і не ведемо акаунтів, на які не маємо прямого договору.
- Не збираємо й не поширюємо дані Google понад те, що потрібно для звітів власнику акаунта.
- Не продаємо ClickGuard як продукт — самообслуговуваної версії не існує.
8. Контакт
Soft Plus · Київ, Україна · контакт розробника info@soft-plus.dev · менеджерський акаунт 237-063-0515. Питання щодо цієї інтеграції або запит на демонстрацію панелі — на цю адресу.