Как настроить постбек: макросы, проверка и ошибки
Обновлено: 21.10.2026
Постбек — серверный запрос от партнёрки к трекеру в момент конверсии: он передаёт click_id и статус события. Чтобы его настроить, возьмите postback-ссылку в трекере, вставьте её в кабинет партнёрки, подставьте макросы и проверьте тестовой конверсией.
Что такое постбек и зачем он нужен
Постбек (postback, S2S-вызов) — запрос, который сервер партнёрской сети отправляет на URL трекера при событии: лид, регистрация, депозит, апрув. Трекер получает click_id, находит исходный клик и записывает конверсию с нужным источником, кампанией и креативом.
В отличие от пикселя, постбек не зависит от браузера: ему не мешают cookie, блокировщики рекламы и закрытая вкладка. Механику подробно разбирает статья «Что такое постбек и S2S».
Как работает связка трекер → партнёрка → трекер
Данные проходят три шага:
- Пользователь кликает по рекламе, трекер создаёт уникальный
click_id. - Трекер перенаправляет на оффер и передаёт
click_idв параметре ссылки (sub-метка, напримерsub1илиclickid). - При конверсии партнёрка вызывает postback-ссылку и возвращает тот же
click_id.
Если click_id потерялся на втором шаге, конверсия не привяжется к клику. Поэтому диагностику начинайте с проверки передачи метки.
Как настроить постбек: пошаговая инструкция
Если трекер ещё не поднят, сначала пройдите настройку трекера с нуля.
Шаг 1. Получить postback-ссылку в трекере
Ссылка обычно лежит в настройках кампании, оффера или партнёрской сети. Для популярных сетей в трекерах часто есть готовые шаблоны. Если шаблона нет, возьмите универсальную ссылку: домен трекера, путь постбека и параметры click_id, status, payout.
Шаг 2. Передать click_id в партнёрку
В ссылке оффера укажите параметр, который партнёрка вернёт обратно, и подставьте в него токен трекера. Токен — макрос трекера, вместо которого при клике подставляется реальное значение. Какой параметр возвращается, смотрите в документации партнёрки.
Шаг 3. Вставить постбек в партнёрскую сеть
В кабинете найдите раздел «Postback», «S2S» или «Уведомления». Вставьте ссылку из трекера и выберите события, по которым она будет вызываться. Для нескольких офферов и событий нужны отдельные постбеки или один общий с макросом статуса.
Шаг 4. Подставить макросы
Названия макросов различаются между трекерами и сетями. Таблица показывает логику; точные имена сверяйте с документацией обеих сторон.
| Данные | Макрос трекера (пример логики) | Макрос партнёрки (пример логики) |
|---|---|---|
| Идентификатор клика | параметр clickid / subid | {sub1} / {clickid} |
| Статус | параметр status | {status} |
| Выплата | параметр payout | {payout} |
| Валюта | параметр currency | {currency} |
| Транзакция | параметр txid | {transaction_id} |
Шаг 5. Настроить статусы и события
Сопоставьте статусы партнёрки со статусами трекера: лид, продажа, отклонён, холд. Если трекер не знает присланный статус, конверсия запишется неверно или не запишется вовсе.
Какие макросы передавать
Обязательный минимум:
click_id— связывает конверсию с кликом;- статус — что именно произошло;
- выплата — сумма, которую платит партнёрка;
- валюта — чтобы отчёт не смешивал разные валюты.
Дополнительно полезны тип события, ID оффера и номер транзакции. Транзакция нужна для дедупликации: если партнёрка пришлёт один постбек дважды, трекер не засчитает конверсию повторно.
Как проверить постбек
- Сделайте тестовый клик по своей кампании и убедитесь, что
click_idдошёл до партнёрки. - Запросите у партнёрки тестовую конверсию или создайте её сами на недорогом событии, если сеть это разрешает.
- Откройте лог постбеков в трекере: запрос должен появиться со статусом «принят».
- Проверьте лог в кабинете партнёрки: там видно, какой URL отправлен и какой код ответа получен.
- Вызовите ссылку вручную в браузере или через
curlс тестовымclick_id. Код 200 означает, что запрос принят, а коды 4xx и 5xx — ошибку в адресе или на стороне сервера.
Чек-лист «конверсия дошла»: click_id не пустой, статус распознан, выплата и валюта совпадают, дубля нет. Дополнительно пригодится чек-лист перед запуском.
Типичные ошибки при настройке
| Симптом | Причина | Решение |
|---|---|---|
| Конверсия есть в партнёрке, в трекере нет | click_id пустой или не передан | Проверить параметр в ссылке оффера и токен |
Приходит {clickid} как текст | Макрос не подставился | Сверить имя макроса с документацией |
| Постбек не принимается | Лишние пробелы, неверная кодировка | Пересобрать URL, закодировать спецсимволы |
| Запрос уходит в никуда | Указан не тот домен трекера | Проверить домен и протокол (http/https) |
| Конверсия не засчитана | Нужный статус не включён | Включить событие в партнёрке и сопоставить статус |
| Двойные конверсии | Нет дедупликации | Передавать ID транзакции |
| Расхождение в отчётах | Разная валюта | Передавать валюту явно |
Вопрос–ответ
Чем постбек отличается от пикселя? Пиксель срабатывает в браузере пользователя и зависит от cookie и блокировщиков. Постбек идёт между серверами, поэтому надёжнее и точнее.
Какие макросы обязательны?
Минимум — click_id и статус. Выплату и валюту добавляйте почти всегда, иначе отчёты по доходу будут неполными.
Почему конверсия не фиксируется?
Чаще всего потерян click_id, не подставился макрос или не включён нужный статус. Начните с логов трекера и партнёрки.
Можно ли настроить постбеки на несколько событий? Да: создайте отдельный постбек на каждое событие или используйте один с макросом статуса. Выбор зависит от возможностей партнёрки.
Как защитить постбек от подделки? Используйте неочевидный путь или секретный параметр, если трекер это поддерживает, и ограничение по IP партнёрки, когда сеть публикует адреса серверов. Конкретные возможности смотрите в документации трекера.
Где сравнить трекеры перед настройкой? Ориентир — раздел «Сравнения» и подборка «Как выбрать трекер под Q4».
Частые вопросы
Чем постбек отличается от пикселя?
Пиксель срабатывает в браузере пользователя и зависит от cookie и блокировщиков. Постбек идёт между серверами, поэтому надёжнее и точнее.
Какие макросы обязательны?
Минимум — click_id и статус. Выплату и валюту добавляйте почти всегда, иначе отчёты по доходу будут неполными.
Почему конверсия не фиксируется?
Чаще всего потерян click_id, не подставился макрос или не включён нужный статус. Начните с логов трекера и партнёрки.
Можно ли настроить постбеки на несколько событий?
Да: создайте отдельный постбек на каждое событие или используйте один с макросом статуса. Выбор зависит от возможностей партнёрки.
Как защитить постбек от подделки?
Используйте неочевидный путь или секретный параметр, если трекер это поддерживает, и ограничение по IP партнёрки, когда сеть публикует адреса серверов. Конкретные возможности смотрите в документации трекера.
Где сравнить трекеры перед настройкой?
Ориентир — раздел «Сравнения» и подборка «Как выбрать трекер под Q4».
Проверено: 08.10.2026. Цены и тарифы — ориентир на дату проверки, точное всегда на сайте сервиса. Нашли неточность? Напишите на redakciya@treker-arbitrazh.com.