Постбеки потоку
Секція 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 автоматично добудовує подію реєстрації, щоб воронка й пікселі не ламалися.