Постбеки потока
Секция Postback — входящий URL приёма и исходящие постбеки по каждому статусу с методом, телом и заголовками.
Постбеки — это серверный обмен конверсиями по HTTP. Настраиваются на каждом потоке в секции Postback (отдельной страницы постбеков нет). Есть два направления: входящий (трекер → darkcore) и исходящий (darkcore → трекер).
Пошаговый пример для конкретного трекера — Интеграция с Keitaro. Здесь — справка по полям.
Входящий постбек
Секция показывает готовый URL приёма для копирования в трекер:
https://edge.darkcorepwa.com/p?click_id={click_id}&status={status}&payout={payout}Endpoint принимает click_id, status, payout и необязательный transaction_id через GET или POST. Для POST поддерживаются form-urlencoded и JSON; query-параметры имеют приоритет над телом. Под URL — таблица принятых статусов: для каждого активного типа конверсии показаны его алиасы (значение &status=). Полный перечень параметров и правил — Параметры постбека.
Валюты нет — весь payout считается долларами США. Если оффер в EUR/GBP, конвертируйте сумму перед отправкой.
Исходящий постбек
Для каждого статуса (install + каждый активный тип конверсии) настраивается отдельный egress. Пустой URL = постбек выключен для этого статуса.
| Поле | Тип | За что отвечает | По умолчанию |
|---|---|---|---|
| URL | текст | Куда пересылать конверсию этого статуса | пусто |
| Кнопка макросов | вставка | Добавляет токен ({click_id} и т. д.) в позицию курсора | — |
| HTTP-метод | select | GET / POST / PUT | GET |
| Тип содержимого | select | Форма / JSON / Текст (только для POST/PUT) | Форма |
| Шаблон тела | textarea | Тело запроса с макросами (только для POST/PUT) | — |
| Собственные заголовки | пары ключ/значение | Произвольные HTTP-заголовки (напр. ключ API) | пусто |
Расширенные настройки (метод, тип, тело, заголовки) раскрываются под URL кнопкой.
Тип содержимого и экранирование
| Тип | Content-Type | Экранирование макросов в теле |
|---|---|---|
| Форма | application/x-www-form-urlencoded | URL-encode |
| JSON | application/json | JSON-safe |
| Текст | text/plain | без экранирования |
Пример маршрутизации по статусам:
https://kclick.example.com/postback?subid={click_id}&status=leadURL: https://kclick.example.com/postback
Body: subid={click_id}&status=sale&payout={payout}¤cy={currency}
Header: X-Api-Key: secret123В шаблонах доступен полный набор макросов.
Исходящие постбеки повторяются до 4 раз с нарастающей задержкой; ошибки 4xx считаются финальными. Если трекер фильтрует запросы по User-Agent — добавьте наш агент darkcorepwa-postback/1.0 в разрешённые.
Проверка доставки
Откройте Логи трекера и выберите Исходящие S2S. Отфильтруйте записи по периоду, статусу, потоку или click ID.
В деталях видны URL, статус доставки, HTTP-код, количество попыток и текст ошибки.
Как статусы становятся типами конверсий
Значение status из входящего постбека сопоставляется с типом конверсии по ключу или алиасам. Например, reg, registration, lead → registration. Если приходит deposit без предшествующей регистрации, darkcore автоматически достраивает событие регистрации, чтобы воронка и пиксели не ломались.