Attribution з першого кліку
Зберігаються campaign, funnel, source, medium, utm-мітки, IP, user agent і час переходу. Це основа для чесної статистики по рекламі.
Citadel — traffic routing платформа
Citadel закриває операційний шар між рекламою, landing page і buyer endpoint: click tracking, attribution, intake, дедуплікація, caps, доставка лідів, callback-статуси, quality control і live statistics в одному місці.
Click tracker
Кожен перехід отримує унікальний click_id. Далі цей click_id проходить через landing, форму, lead intake, buyer delivery і callback. Так видно, яке джерело реально дало валідний лід, а не просто дешевий клік.
Зберігаються campaign, funnel, source, medium, utm-мітки, IP, user agent і час переходу. Це основа для чесної статистики по рекламі.
Користувач переходить на landing із click_id у URL. Форма повертає його назад у CRM разом із заявкою.
CRM прив'язує заявку до кліку, funnel, campaign і buyer-а, щоб не було хаосу між рекламним трафіком і фактичними продажами.
Callback від buyer-а повертає статус ліда в систему. Команда бачить valid, invalid, rejected, duplicate, ftd і revenue.
Production flow
CRM створює click_id, записує attribution і перенаправляє користувача на потрібний funnel.
GET /track/click/?campaign=1&funnel=5
Landing отримує click_id, показує форму і не втрачає прив'язку до джерела трафіку.
Funnel.url?click_id=clk_...
Intake endpoint приймає заявку, consent, contact fields і payload з рекламної воронки.
POST /api/leads/intake/
Система перевіряє caps, active status, duplicate rules і доставляє лід на endpoint замовника.
POST Buyer.endpoint_url
Buyer повертає фінальний або проміжний статус: valid, invalid, rejected, duplicate, ftd.
POST /api/leads/<id>/status/
Quality control
Для кого система
Бачить не тільки spend і кліки, а якість лідів по джерелах, funnel-ах, GEO і buyer status.
Контролює routing, caps, duplicate rules, delivery помилки і швидко знаходить проблемні ланки.
Кожен buyer має endpoint, API key, payout, cap, status і callback contract.
Порядок підключення
Endpoint URL, API key, payout, daily cap, total cap, active status і callback permissions.
Vertical, GEO, buyer binding, cost model, payout logic і campaign intake token.
Landing URL, language, source mapping, campaign binding і active status.
Запуск реклами через tracker link, щоб click_id створювався до відкриття landing page.
POST на intake endpoint із click_id, phone, name, consent і додатковими form fields.
Buyer повертає статуси назад у CRM, щоб статистика показувала реальну якість трафіку.
API contracts
GET /track/click/?campaign=1&funnel=5&source=fb&utm_campaign=de_solar
POST /api/leads/intake/
X-Intake-Token: <campaign_token>
{
"click_id": "clk_92F7A1",
"phone": "+491701234567",
"name": "Lead Name",
"consent": true
}
POST Buyer.endpoint_url
Authorization: Bearer <buyer_key>
Content-Type: application/json
{
"lead_id": 123,
"phone": "+491701234567",
"source": "fb",
"campaign": "DE Solar"
}
POST /api/leads/123/status/
X-Buyer-Key: <buyer_key>
{
"status": "valid",
"payout": 45,
"external_id": "buyer_8891"
}
Operational clarity