Налаштування інтеграції

Параметри підключення до Google Ads API, CRM-систем та політики конфіденційності

Google Ads API

Ідентифікатори акаунта та дія конверсії для офлайн-імпорту

Google Ads Customer ID (CID) *

10-значний номер клієнтського акаунта Google Ads

Валюта конверсій за замовчуванням

ID дії конверсії для лідів (Lead Action ID)

Етап воронки «Lead»: передається при підтвердженні замовлення для раннього навчання Smart Bidding

ID дії конверсії для покупок (Purchase Action ID) *

Етап воронки «Purchase»: передається при успішній оплаті / отриманні із точною сумою замовлення

MCC Login Customer ID (Опціонально)

Використовується, якщо доступ налаштовано через керуючий акаунт MCC

Режим симуляції (Dry Run)

Перевіряє коректність завантаження конверсій без списання та фактичного збереження в Google Ads

Consent Mode v2 (Обов'язковий прапорець)

Автоматично встановлює ad_user_data: GRANTED згідно з інваріантами системи

Google Ads API OAuth 2.0 Облікові дані

Облікові дані для автоматичного оновлення access-токенів та вивантаження офлайн-конверсій

OAuth Client ID

OAuth Client Secret

OAuth Refresh Token

Developer Token

CRM Інтеграція та Мапінг Статусів

Налаштування підключення та вибір статусів для відправки в Google Ads

Webhook URL для KeyCRM

Вставте цю адресу в кабінеті KeyCRM у розділі «Вебхуки»

API Ключ KeyCRM

Секрети маскуються на бекенді та зберігаються безпечно

Webhook Secret KeyCRM

Опціональний секрет для верифікації сигнатури вебхука

Таблиця відповідності статусів замовлень (status_mapping)

Увімкніть статуси, за якими замовлення має негайно відправлятися як конверсія в Google Ads

3 активно

Статус у CRM	Офлайн-імпорт	Дія системи	Дії
Оплачено		Генерує конверсію в Google Ads
Доставлено		Генерує конверсію в Google Ads
Виконано		Генерує конверсію в Google Ads
Новий		Ігнорується (не відправляти)
В обробці		Ігнорується (не відправляти)
Відправлено		Ігнорується (не відправляти)
Скасовано		Ігнорується (не відправляти)

Сповіщення про інциденти (Alerting)

Миттєве сповіщення в Telegram та Webhook при збоях Google Ads API або CRM

Увімкнути службу сповіщень

Автоматично надсилати сповіщення про інциденти та збої імпорту

Telegram Bot Token

Отримайте у @BotFather при створенні бота для сповіщень

Telegram Chat ID

ID особистого чату або групи з ботом (наприклад, з @userinfobot)

Webhook Alert URL (Опціонально)

Зовнішній webhook для отримання JSON-сповіщень про інциденти

Типи подій для сповіщення:

Збої та помилки завантаження (alert_on_error)

Сповіщати, коли замовлення не вдалося вивантажити в Google Ads або відхилено API

Помилки авторизації Google Ads (alert_on_auth_failure)

Сповіщати при закінченні терміну дії або недійсності OAuth Refresh Token

Правила дедуплікації та PII

Дедуплікація: Завжди використовує первинний order_id (Transaction ID). Повторні конверсії відхиляються.
PII нормалізація: Номери телефонів приводяться до формату E.164 (+380XXXXXXXXX), email переводиться в нижній регістр та хешується SHA-256.
Секрети: Токени доступу зберігаються виключно в файлі конфігурації .env і не передаються у відкритому вигляді в браузер.