ADS Beast — універсальна інтеграція якості лідів

Ця сторінка — технічна документація для будь-якого бізнесу, який використовує ADS Beast для реклами. Вона пояснює, як ваш сайт/CRM має передавати дані про лідів і їхні статуси, щоб ADS Beast могла автоматично оптимізувати рекламні кампанії на реєстрації, оплати та інші цільові події.

1. Що таке «якість ліда» в ADS Beast

ADS Beast оптимізує не тільки кількість лідів, а й їхню якість. Для цього CRM або сайт клієнта має повертати статус кожного ліда:

• Позитивні статуси — лід якісний: registered, qualified, demo_booked, proposal_sent, paid, activated, won.
• Негативні статуси — лід неякісний: spam, invalid_phone, no_budget, duplicate, unreachable, unqualified, churned.

На основі цих статусів система:

• Рахує реальний CPA/CAC по кожній кампанії, оголошенню та аудиторії.
• Визначає, які джерела дають оплати, а які — лише порожні реєстрації.
• Відправляє offline conversions назад у Meta та Google для оптимізації алгоритмів.
• Автоматично знижує ставки на негативні аудиторії та масштабує позитивні.

2. Що зберігати при першому переході на сайт

Коли користувач клікає оголошення, ADS Beast додає до URL рекламні параметри. Ви маєте зберегти їх у сесії / cookie / профілі користувача і передати в CRM разом із лідом:

3. Спосіб 1. Універсальний webhook конверсії (простий)

Найшвидший спосіб для будь-якого сайту або CRM — викликати webhook при кожній важливій події.

POST https://adsbeast.pro/api/outreach/webhooks/conversion
Content-Type: application/json

Тіло запиту:

{
  "email": "user@example.com",
  "campaign_id": 1,
  "action": "paid",
  "metadata": {
    "user_id": "your_user_12345",
    "registered_at": "2026-10-01T14:30:00Z",
    "paid_at": "2026-10-03T09:15:00Z",
    "amount": 49.99,
    "currency": "USD",
    "plan": "pro",
    "country": "UA",
    "city": "Kyiv",
    "utm_source": "adsbeast",
    "utm_campaign": "manaro_meta_ua",
    "fbclid": "...",
    "gclid": "..."
  }
}

Доступні значення action

4. Спосіб 2. Повноцінна CRM feedback інтеграція (рекомендовано)

Для регулярного синхрону великих обсягів використовуйте CRM feedback API. Воно працює з API-ключем і дозволяє:

• Імпортувати статуси всіх лідів із CRM в ADS Beast.
• Автоматично відправляти offline conversions у Meta і Google.
• Налаштовувати власну мапу статусів.

Підтримувані CRM-провайдери

Як налаштувати

1. Створіть API-ключ у ADS Beast: Settings → API Keys → Create. Рекомендовані scopes: read:leads, write:leads, read:webhooks, write:webhooks.
2. Перевірте доступні провайдери:

   GET https://adsbeast.pro/api/crm-feedback/{client_id}/providers
   X-API-Key: absk_...

3. Збережіть binding (приклад для KeepInCRM):

   PUT https://adsbeast.pro/api/crm-feedback/{client_id}/binding?dry_run=false
   X-API-Key: absk_...
   Content-Type: application/json
   
   {
     "provider": "keepincrm",
     "enabled": true,
     "feedback_loop_enabled": true,
     "import_outcomes": true,
     "upload_platforms": ["meta", "google"],
     "positive_statuses": ["qualified", "proposal_sent", "won", "paid"],
     "negative_statuses": ["spam", "invalid_phone", "no_budget", "duplicate", "unreachable", "unqualified"],
     "creds": { "api_key": "your_crm_api_key" }
   }

4. Запустіть синхронізацію:

   POST https://adsbeast.pro/api/crm-feedback/{client_id}/sync-now?since=7d&import_outcomes=true
   X-API-Key: absk_...

5. Як ADS Beast використовує ці дані для оптимізації

6. Повний цикл на прикладі SaaS

1. Користувач бачить рекламу Meta → переходить на yoursaas.com/signup?utm_source=adsbeast&utm_campaign=saas_trial_ua&fbclid=ABC.
2. Ви зберігаєте fbclid та UTM у cookie/localStorage і передаєте в CRM при реєстрації.
3. Користувач реєструється → ви викликаєте webhook action=registered.
4. Через 2 дні він підтверджує email і заходить у продукт → action=activated.
5. Через 7 днів оформлює підписку → action=paid з amount і plan.
6. ADS Beast бачить: реєстрація дешевша з кампанії A, але оплати вищі з кампанії B. Бюджет переноситься на B.

7. Повний цикл на прикладі e-commerce

1. Користувач клікає Google Shopping оголошення → gclid=XYZ.
2. Ви зберігаєте gclid і прив’язуєте до замовлення.
3. Замовлення створено → action=qualified (цільовий лід).
4. Замовлення оплачено → action=paid із сумою.
5. Замовлення повернено → action=churned (негативний сигнал).

8. Безпека та API-ключі

• Webhook /api/outreach/webhooks/conversion зараз відкритий (без auth). Рекомендуємо передавати мінімум даних і перевіряти email на стороні CRM.
• CRM feedback API вимагає API-ключ ADS Beast (X-API-Key: absk_... або Authorization: Bearer absk_...).
• Ключі видаються в адмін-панелі ADS Beast і можуть бути відкликані.
• Не зберігайте ключі в публічному коді frontend.

9. Обов’язкові поля для якісної оптимізації

10. Питання та підтримка

Якщо ваша CRM не зі списку підтримуваних — використовуйте webhook із розділу 3. Для налаштування індивідуальної інтеграції звертайтесь до адміністратора ADS Beast.

• Product domain: https://adsbeast.pro
• API base URL: https://adsbeast.pro/api