Ця сторінка — технічна документація для будь-якого бізнесу, який використовує ADS Beast для реклами. Вона пояснює, як ваш сайт/CRM має передавати дані про лідів і їхні статуси, щоб ADS Beast могла автоматично оптимізувати рекламні кампанії на реєстрації, оплати та інші цільові події.
ADS Beast оптимізує не тільки кількість лідів, а й їхню якість. Для цього CRM або сайт клієнта має повертати статус кожного ліда:
registered, qualified, demo_booked, proposal_sent, paid, activated, won.spam, invalid_phone, no_budget, duplicate, unreachable, unqualified, claimed_no_request.На основі цих статусів система:
Коли користувач клікає оголошення, ADS Beast додає до URL рекламні параметри. Ви маєте зберегти їх у сесії / cookie / профілі користувача і передати в CRM разом із лідом:
| Поле | Опис | Приклад |
|---|---|---|
utm_source | Джерело трафіку | adsbeast |
utm_medium | Тип трафіку | paid, cpc |
utm_campaign | Назва кампанії | manaro_meta_ua |
utm_content | Креатив / аудиторія | feed_beauty |
utm_term | Ключове слово (Google) | crm+для+салона |
fbclid | Meta click ID | IwAR2ABCD... |
gclid | Google click ID | CjwKCAjw... |
gbraid, wbraid | Google iOS / web-to-app ID | — |
ttclid | TikTok click ID | — |
click_id | Універсальний click ID | — |
campaign_name | Назва кампанії з ADS Beast | Manaro CRM — Lead Gen UA |
platform_campaign_id | ID кампанії в рекламному кабінеті | 1234567890 |
Один endpoint для будь-якого сайту або CRM. Надсилайте рядок щоразу, коли змінюється статус ліда чи користувача.
POST https://adsbeast.pro/api/integrations/quality-outcomes/{org_slug}/sync
Content-Type: application/json
X-API-Key: absk_...
{
"client_id": 123,
"rows": [
{
"external_lead_id": "your_user_12345",
"contact_email": "user@example.com",
"outcome": "paid",
"value": 49.99,
"currency": "EUR",
"plan": "pro",
"occurred_at": "2026-10-03T09:15:00Z",
"utm_source": "google",
"utm_medium": "cpc",
"utm_campaign": "your_campaign",
"gclid": "...",
"fbclid": "..."
}
]
}
read:leads, write:leads або write:quality-outcomes; повний ключ показується один раз — збережіть його одразу. org_slug і client_id повідомляє адміністратор.write:leads або write:quality-outcomes. Ключ, прив’язаний до клієнта, бачить і змінює лише його дані.outcome і хоча б один ідентифікатор: external_lead_id, contact_email, contact_phone, crm_lead_id або platform_lead_id.external_lead_id оновлює запис, а не створює дубль.paid: value (сума, ≥ 0; синоніми amount, revenue, price), currency (ISO 4217) і plan (тариф, синонім tariff). Кожна оплата з новим occurred_at зберігається окремо в історії платежів; повтор того самого платежу дубля не створює. Помилки в цих полях повертаються у warnings."dry_run": true — перевірка без запису.received, imported, created, updated, skipped. Рядок із нерозпізнаним статусом пропускається (skipped) і не записується.Публічний контракт з усіма полями, статусами та синонімами (ключ не потрібен):
GET https://adsbeast.pro/api/integrations/quality-outcomes/{org_slug}/contract
outcome)| Статус | Коли використовувати | Тип |
|---|---|---|
registered | Користувач зареєструвався / створив акаунт | Позитивний |
activated | Пройшов onboarding, почав користуватися продуктом | Позитивний |
demo_booked | Заброньовано демо / консультацію | Позитивний |
qualified | Менеджер підтвердив, що лід цільовий | Позитивний |
proposal_sent | Відправлено комерційну пропозицію | Позитивний |
paid | Отримано оплату | Позитивний |
won | Угода виграна / підписано договір | Позитивний |
unqualified | Лід нецільовий за критеріями | Негативний |
no_budget | У ліда немає бюджету | Негативний |
duplicate | Дублікат існуючого ліда | Негативний |
unreachable | Не вдалося зв’язатися | Негативний |
invalid_phone | Невірний телефон / фейкові дані | Негативний |
claimed_no_request | Людина каже, що заявку не залишала | Негативний |
spam | Спам / бот | Негативний |
Синоніми приймаються автоматично (наприклад, signup → registered, payment → paid) — повний список у контракті.
Для keepincrm, hubspot, amocrm і pipedrive ADS Beast уміє сам забирати статуси з CRM. Такий зв’язок налаштовує менеджер у кабінеті ADS Beast; адреси /api/crm-feedback/… закриті для ключів інтеграції (відповідь 403). Для будь-якої іншої CRM використовуйте метод із розділу 3.
GET https://adsbeast.pro/api/leads-pipeline/export?client_id=123&format=json X-API-Key: absk_...
Потрібне право read:leads. Відповідь посторінкова: count, leads, has_more, next_offset — поки has_more дорівнює true, запитуйте &offset=<next_offset>. Короткий список: GET /api/leads-pipeline/?client_id=123&limit=200 (зі слешем перед ?).
gclid / fbclid вже зараз: Google приймає їх до 90 днів, Meta — до 7.yoursaas.com/?utm_source=google&utm_campaign=saas_trial_ua&gclid=ABC.outcome: registered.activated з тим самим external_lead_id.paid.X-API-Key: absk_... або Authorization: Bearer absk_..., формат absk_<8>_<32>. Ключі створюються і відкликаються в панелі ADS Beast на сторінці API-ключі. Не зберігайте ключ у публічному frontend-коді.401 — ключ відсутній, пошкоджений (у тексті відповіді — що саме), відкликаний або прострочений; 403 — немає потрібного права або адреса закрита для ключів; 404 — чужий client_id; 422 — помилка в тілі запиту; 429 — перевищено ліміт запитів ключа.| Подія | Обов’язкові поля | Рекомендовані |
|---|---|---|
| Реєстрація | external_lead_id або contact_email, outcome=registered | UTM, click ID, occurred_at |
| Активація | той самий ідентифікатор, outcome=activated | occurred_at |
| Оплата | той самий ідентифікатор, outcome=paid | occurred_at, click ID |
| Відсіювання | ідентифікатор, outcome=unqualified / spam / duplicate | outcome_reason |
Для налаштування індивідуальної інтеграції звертайтесь до адміністратора ADS Beast.
https://adsbeast.pro/apiclient_id. Ніколи не використовуйте один API-ключ для кількох непов’язаних інтеграцій.