Postback API позволяет рекламным системам и партнёрам передавать события, связанные с пользовательским трафиком: регистрации, депозиты, редепозиты и любые кастомные события. Этот механизм обеспечивает точную атрибуцию действий пользователей, корректное формирование статистики и своевременную реакцию системы на ключевые события.

С помощью данного API вы можете передавать данные как по уникальному clickid, так и по связке user_id и spot, что делает интеграцию гибкой и универсальной. Поддержка кастомных событий позволяет расширять аналитику под специфику продукта, автоматизировать триггеры и обновлять дополнительные параметры игрока.

В этой статье описаны параметры запроса, структура ответов, поддерживаемые события, примеры использования и возможные ошибки, чтобы вы могли быстро и безошибочно интегрировать Postback API в свой трекинг-процесс.

🌐URL запроса

https://thedinator.com/api/v1/api_send_postback/

Метод: GET

✅Обязательные параметры

Для идентификации события необходимо передать один из двух вариантов:

1. clickid - уникальный click ID пользователя

Тип: string

2. user_id + spot - используется, если отсутствует clickid

Тип: string

👉Достаточно одного варианта: clickid или user_id + spot

3. goal - тип события  (reg, dep,redep, rebill, кастомный токен)

Тип: string

🧩Необязательные параметры

📌Требования к sum / sumrd

• значение должно быть числом
• не допускается использование {}
• при ошибке формата → 400 Bad Request

🎯Поддерживаемые стандартные цели

🛠️Кастомные цели

Вы можете передать любое событие, если оно есть в списке целей вашего аккаунта.

Примеры:

goal=level10

goal=tutorial_complete

goal=kyc_submit

Кастомные события:

• записываются в статистику📊
• могут триггерить системные уведомления пользователю🔔
• могут обновлять дополнительные поля в профиле игрока👤

🔍Примеры запросов

Регистрация

GET /postback/?clickid=ABC123&goal=reg

Первый депозит

GET /postback/?clickid=ABC123&goal=dep&sum=100

Повторный депозит

GET /postback/?clickid=ABC123&goal=redep&sum=50

Кастомное событие

GET /postback/?clickid=ABC123&goal=level10&sum=1

Без clickid (по user_id + spot)

GET /postback/?user_id=7788&spot=87fa11c2-ff00-44a1&goal=reg

⚠️Ошибки API

Пример ошибки:
{"error": "Subscriber not exists with this clickid"}

✅Успешный ответ

При успешной обработке любого события:
{"success": true}