Документация
Справочник по работе с платформой для рекламодателей
1. Как работает трекинг
Пользователь переходит по трекинговой ссылке вебмастера — мы фиксируем клик и сохраняем click_id. Когда пользователь совершает целевое действие на вашем сайте, вы отправляете нам постбек с этим click_id, и мы создаём лид.
2. Настройка постбека
Постбек — это HTTP-запрос от вашего сервера на наш URL в момент, когда пользователь совершил целевое действие. Получите ваш постбек-URL в разделе "Постбеки".
1Сохраните click_id из параметров трекинговой ссылки при визите пользователя.
2Скопируйте ваш уникальный токен (postback_key) из настроек безопасности профиля.
3После выполнения целевого действия отправьте POST запрос на ваш постбек-URL.
4Передайте все обязательные параметры. Если тариф оффера процентный — добавьте order_amount. Система проверит токен и создаст лид.
| Параметр | Обязателен | Описание | Тип (JavaScript) | Пример |
|---|---|---|---|---|
| secure | Да | Ваш уникальный секретный токен рекламодателя (postback_key) | string | abcd-1234-efgh |
| lead_id | Да | Уникальный UUID лида (генерируется на вашей стороне) | string | 550e8400-e29b-41d4-a716-446655440000 |
| click_id | Да | Идентификатор клика из трекинговой ссылки | string | abc123xyz |
| status | Да | Статус конверсии: hold, approved или rejected | string | approved |
| currency | Да | Валюта в формате ISO-4217 | string | USD |
| timestamp | Да | Дата и время конверсии в формате Y-m-d H:i:s | string | 2024-01-15 12:30:00 |
| order_amount | Нет | Сумма заказа (обязательна если тариф оффера процентный, мин. 0.01) | number | 1500.00 |
| message | Нет | Произвольная заметка или пометка (макс. 255 символов) | string | Duplicate check |
Пример
POST https://api.julo.ru/api/leads/postback
Content-Type: application/x-www-form-urlencoded
secure=YOUR_SECRET_TOKEN&lead_id=UUID&click_id=CLICK_ID&status=approved¤cy=USD×tamp=2024-01-01+12:00:003. Управление лидами
Все входящие лиды отображаются в разделе "Лиды" вашего кабинета. Вы можете изменить статус лида на approved или rejected вручную, либо автоматически через повторный постбек.