Постбэки

Постбэк — серверный запрос от Tracehub в рекламный кабинет, сообщающий, что по клику этой сети произошла конверсия: установка, покупка, регистрация. Без постбэков кабинет не знает результата и не может оптимизировать закупку.

Принцип работы

1. Пользователь кликает по объявлению — кабинет подставляет свой идентификатор клика в трекинг-ссылку (см. страницу Трекинг-ссылки и макросы).
2. Пользователь ставит приложение, SDK отправляет установку.
3. Tracehub сопоставляет установку с кликом — это атрибуция.
4. Tracehub отправляет постбэк в кабинет той сети, которой принадлежит клик.

Ключевой момент четвёртого шага: постбэк уходит ровно в тот рекламный кабинет, который получил атрибуцию. Если у приложения подключено несколько кабинетов, остальные постбэк не получают — иначе одна установка оплачивалась бы несколько раз.

Настройка

Что	Где	Зачем
Подключённый источник	Источники → Каталог → «Подключить»	Адрес постбэка и макросы — из пресета сети
Трекинг-ссылка с идентификатором клика	Кампания → Источники	Без идентификатора клика постбэк уйдёт пустым
Набор событий и их сетевые имена	Карточка источника → Постбэки	Какие события отдавать кабинету и под какими именами
Сужение набора для кампании	Кампания → Настройки → «События постбэков»	Если конкретная кампания должна отдавать меньше событий

Набор событий

Установка по умолчанию отправляется всегда: в мастере подключения этот постбэк закреплён, а выбор кампании его не отсекает. Выключить install-постбэк можно только на карточке источника — у собственных каналов он закреплён и там. Набор in-app событий настраивается в два уровня: общий — на источнике, при необходимости уже — на кампании.

События на источнике

Первый набор вы выбираете на шаге «События» мастера подключения. Дальше он живёт на карточке источника во вкладке Постбэки, блок «События для отправки» — парами «событие приложения → событие сети». Сетевое имя — то, под которым конверсия придёт в кабинет и по которому сеть оптимизируется.

У каждой сети своя модель имён:

• Имя из списка. У Яндекс Директа — закрытый перечень оптимизации, у VK Рекламы — рекомендованный список event_name; в обоих случаях имя выбирается из выпадающего списка. Tracehub подсказывает соответствие по умолчанию (например, purchase → PURCHASED у Директа); если уверенного соответствия нет, поле остаётся пустым — выберите значение сами, без него пара не сохранится.
• Свободное имя. Сети без перечня принимают произвольную строку — по умолчанию подставляется имя события приложения.

Изменения маппинга применяются к постбэкам без переподключения источника.

Сужение на кампании

На странице кампании во вкладке Настройки, блок «События постбэков»: пустой выбор означает наследование — уходят все события, настроенные на источниках кампании. Выбор подмножества сужает набор именно для этой кампании; установка отправляется всегда. Реально уйдёт пересечение выбора кампании с набором каждого её источника — панель «Эффективные постбэки по источникам» под списком показывает результат по каждому источнику.

Доход

Тумблер «Передавать сумму покупки» (в мастере подключения и на карточке источника во вкладке «Настройки») включает сумму и валюту покупки в постбэки событий дохода.

Названия событий у сетей свои

Рекламные кабинеты принимают события не по вашим именам, а по собственному перечню. Событие без сопоставленного сетевого имени либо не зачтётся, либо попадёт не в ту категорию. Проверьте блок «События для отправки» (вкладка «Постбэки») после подключения — см. перечни на страницах «Яндекс Директ» и «VK Реклама».

Диагностика

Постбэк доставлен, если кабинет ответил HTTP 200. Любой другой код — ошибка доставки.

Где смотреть: на карточке источника вкладка Журнал — журнал отправленных постбэков за последние 7 дней. Тестовый постбэк (не дожидаясь реальной конверсии) доступен только собственным каналам и подключениям вне каталога — у сетей из каталога транспорт проверен, поэтому тестовая отправка там не показывается.

Частые причины, по которым постбэк уходит, но не засчитывается:

• Пустой идентификатор клика. Он не приехал в трекинг-ссылке — проверьте имя параметра (у Директа — yclid, у VK Рекламы — vk_click_id); см. страницу Трекинг-ссылки и макросы.
• Не передан секрет аутентификации. У Яндекс Директа это pass-phrase — Tracehub подставляет его автоматически, но без него кабинет молча отбрасывает постбэк.
• Отправка с неразрешённого IP. Яндекс Директ и VK Реклама принимают постбэки только с адресов, заранее переданных при заявке на интеграцию.

Полные справочники по сетям: см. страницы Яндекс Директ и «VK Реклама».

---