Citadel Tracker · Routing · Callbacks
Production-ready traffic control layer

Citadel — traffic routing платформа

Smart tracker, який бачить шлях ліда від кліку до buyer callback.

Citadel закриває операційний шар між рекламою, landing page і buyer endpoint: click tracking, attribution, intake, дедуплікація, caps, доставка лідів, callback-статуси, quality control і live statistics в одному місці.

5-step
click → lead → buyer
Real-time
status callbacks
Caps
daily / total limits

Click tracker

Трекер не просто рахує кліки. Він створює повний слід кожної заявки.

Кожен перехід отримує унікальний click_id. Далі цей click_id проходить через landing, форму, lead intake, buyer delivery і callback. Так видно, яке джерело реально дало валідний лід, а не просто дешевий клік.

02

Redirect без втрати даних

Користувач переходить на landing із click_id у URL. Форма повертає його назад у CRM разом із заявкою.

03

Lead matching

CRM прив'язує заявку до кліку, funnel, campaign і buyer-а, щоб не було хаосу між рекламним трафіком і фактичними продажами.

04

Conversion feedback loop

Callback від buyer-а повертає статус ліда в систему. Команда бачить valid, invalid, rejected, duplicate, ftd і revenue.


Production flow

Воронка приймає заявку. CRM вирішує, що з нею робити далі.

01

Track click

CRM створює click_id, записує attribution і перенаправляє користувача на потрібний funnel.

GET /track/click/?campaign=1&funnel=5
02

Open funnel

Landing отримує click_id, показує форму і не втрачає прив'язку до джерела трафіку.

Funnel.url?click_id=clk_...
03

Receive lead

Intake endpoint приймає заявку, consent, contact fields і payload з рекламної воронки.

POST /api/leads/intake/
04

Route to buyer

Система перевіряє caps, active status, duplicate rules і доставляє лід на endpoint замовника.

POST Buyer.endpoint_url
05

Callback status

Buyer повертає фінальний або проміжний статус: valid, invalid, rejected, duplicate, ftd.

POST /api/leads/<id>/status/

Quality control

Захист від сміттєвих заявок, дублювання і перепродажу понад ліміт.

Що контролює CRM

  • дедуплікацію по телефону, click_id або campaign rules;
  • daily cap і total cap для кожного buyer-а;
  • активність campaign, funnel і buyer endpoint;
  • delivery logs: status code, response body, latency;
  • consent fields для прозорого intake;
  • callback history для операційної статистики.
Accepted leads 84% після rules + caps
Avg delivery 320ms endpoint response
Duplicates Blocked до buyer delivery
Callbacks Tracked valid / rejected / ftd

Для кого система

Citadel підходить для performance-команд, affiliate operations і buyer management.

Media buying team

Бачить не тільки spend і кліки, а якість лідів по джерелах, funnel-ах, GEO і buyer status.

Affiliate operations

Контролює routing, caps, duplicate rules, delivery помилки і швидко знаходить проблемні ланки.

Buyer management

Кожен buyer має endpoint, API key, payout, cap, status і callback contract.


Порядок підключення

Що створити в адмінці перед запуском трафіку

1 Buyer

Endpoint URL, API key, payout, daily cap, total cap, active status і callback permissions.

2 Campaign

Vertical, GEO, buyer binding, cost model, payout logic і campaign intake token.

3 Funnel

Landing URL, language, source mapping, campaign binding і active status.

4 Tracking URL

Запуск реклами через tracker link, щоб click_id створювався до відкриття landing page.

5 Form submit

POST на intake endpoint із click_id, phone, name, consent і додатковими form fields.

6 Buyer callback

Buyer повертає статуси назад у CRM, щоб статистика показувала реальну якість трафіку.


API contracts

Мінімум для інтеграції tracker → intake → buyer → callback

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

Коли трафік росте, Excel уже не рятує. CRM має бачити кожен клік, кожен лід і кожен callback.