Как настроить постбек Leads.su, Admitad и CityAds в self-hosted трекере

У self-hosted трекера постбек-ссылка ведёт на ваш собственный домен, а не на облако вендора. Это удобно — данные о заявках не проходят через чужие серверы, — но и настраивать связку с сетью приходится самому. Ниже — как подключить в inotrack три сети, с которыми чаще всего работают в финансовой и товарной вертикалях: Leads.su, Admitad и CityAds. Для каждой — что уже зашито в код трекера, а что придётся сверить в кабинете.

Сразу о честности: у трёх сетей разная степень готовности. У Leads.su есть пресет в списке панели. У CityAds пресет есть в ядре, но в выпадающем списке панели его нет. У Admitad пресета нет вовсе — подключение делается своим маппингом. Статья идёт от простого к сложному.

Что общего у всех трёх

Схема одна и та же:

1. В ссылку оффера добавляется параметр сети, в который трекер подставит свой {clickid}.
2. В трекере создаётся подключение: «Постбеки» → «Подключения» → «Подключить сеть». У подключения свой токен и свой адрес приёма https://<трекер-домен>/pb/<токен>.
3. В кабинете сети в постбек-ссылку вставляется этот адрес и макросы сети: clickid, статус, сумма, идентификатор заявки.

Ссылки постбеков строятся от основного трекер-домена — он показан в шапке раздела, и его можно сменить там же.

Маппинг подключения отвечает на четыре вопроса: в каком параметре придёт clickid, в каком — статус, в каком — сумма и в каком — идентификатор заявки (txid). Плюс словарь: какие значения статуса сети означают лид, апрув и отказ. Пресет — это просто заранее заполненный маппинг. Любое его поле можно поправить руками.

Важная оговорка из кода: пресеты inotrack — отправная точка, а не гарантия. Они не сверены построчно с актуальной документацией каждой сети. Поэтому после настройки обязателен тест — о нём в конце.

Leads.su

Ссылка оффера

Наш clickid уходит в параметр aff_sub1. Если офферы заведены импортом по API Leads.su, трекер добавляет aff_sub1={clickid} к ссылкам сам. Если каталог загружен файлом или оффер создан по шаблону сети, метку ставит шаблон. У оффера, заведённого полностью вручную, добавьте её сами.

Подключение в трекере

В форме подключения выберите рекламодателя и пресет «Leads.su». Пресет заполнит поля:

Поле маппинга	Параметр в нашей ссылке	Макрос Leads.su
clickid	click_id	{aff_sub1}
статус	status	{status}
сумма	sum	{payout}
заявка (txid)	action_id	{action_id}

Словарь статусов: pending → лид, accepted → апрув, declined → отказ. Валюта по умолчанию — рубли.

Постбек в кабинете

Раздел кабинета: «Инструменты» → «Postback-уведомления». Ссылка, которую соберёт панель:

https://<домен>/pb/<токен>?click_id={aff_sub1}&status={status}&sum={payout}&action_id={action_id}

На что смотреть

Параметр action_id нужен, чтобы смена статуса одной заявки обновляла одну конверсию, а не создавала новую. Если кабинет не подставляет идентификатор в этот параметр, постбеки всё равно принимаются, но сверка по API (о ней ниже) может разойтись с постбеками по ключу — для такого случая в настройках интеграции есть отдельный переключатель.

CityAds

Ссылка оффера

У CityAds метка клика — параметр xid. При импорте каталога по API трекер берёт ссылку сети как есть и собирает из неё ссылку оффера по шаблону: добавляет xid={clickid}. В настройках интеграции можно дополнительно задать, какие sub-метки трекера передавать в параметры sa, sa2…sa5 — парами через запятую, например sa=sub1,sa2=sub2.

Подключение в трекере

Пресет cityads есть в ядре, но в выпадающем списке формы его сейчас нет. Есть два пути.

Через интеграцию. Если рекламодатель CityAds создан подключением сети в разделе «Интеграции», форма постбека подставит пресет сама, как только вы выберете этого рекламодателя. В списке подключений он будет показан кодом cityads.

Вручную. Выберите «Свой (без пресета)» и заполните маппинг так же, как это делает пресет:

Поле маппинга	Параметр в нашей ссылке	Макрос CityAds
clickid	xid	{xid}
статус	status	{status}
сумма	payout	{payout}
валюта	payout_currency	{payout_currency}
заявка (txid)	cpl_id	{cpl_id}

Словарь статусов: open → лид, approved → апрув, rejected → отказ. Валюта по умолчанию — рубли, на случай если сеть не передаст макрос валюты.

Учтите: сверка по API ищет у рекламодателя подключение именно с пресетом cityads. Подключение со своим маппингом она не найдёт: поля для выбора другого пресета в форме интеграции CityAds нет, он задаётся только через API. Если планируете сверку, идите первым путём.

Постбек в кабинете

Раздел: «Инструменты» → «Conversion Postback», тип запроса GET. Ссылка:

https://<домен>/pb/<токен>?xid={xid}&status={status}&payout={payout}&cpl_id={cpl_id}&payout_currency={payout_currency}

Постбек проходит модерацию CityAds: ссылка начинает работать только после одобрения.

На что смотреть

Пресет CityAds в коде прямо помечен как не сверенный с документацией сети. Перед боевым запуском сверьте с подсказкой формы Conversion Postback в кабинете: имя параметра ссылки и макрос {xid}, формат суммы и код валюты, значения статусов и то, что {cpl_id} не меняется при смене статуса заявки.

Admitad

Ссылка оффера

В партнёрских ссылках Admitad свой идентификатор передаётся в параметре subid. Трекер не дописывает его к ссылкам Admitad сам, даже если программы импортированы по API. Добавьте к ссылке оффера subid={clickid} вручную.

Подключение в трекере

Пресета для Admitad нет. Выберите «Свой (без пресета)»: поля по умолчанию называются clickid, status, sum и txid, словарь статусов пустой. Дальше:

1. Оставьте имена параметров как есть или переименуйте под себя — это имена в вашей ссылке, сеть о них ничего не знает.
2. Заполните словарь статусов: значения, которые Admitad подставляет в макрос статуса, сопоставьте с лидом, апрувом и отказом.
3. Проверьте, что параметр суммы задан. Маппинг с пустым полем суммы без явного подтверждения не сохранится: иначе выплата записалась бы нулём.
4. В параметр транзакции направьте идентификатор действия Admitad — он один на всю жизнь заявки.

Имена макросов для постбека возьмите из справки Admitad для вебмастеров и подставьте в ссылку https://<домен>/pb/<токен>?….

Если планируете сверку по API

Сверка сопоставляет конверсии по subid и идентификатору действия. Чтобы она находила ваше подключение, в настройках интеграции Admitad укажите его пресет — для своего маппинга это custom. Адаптер передаёт статусы в виде pending, approved и rejected, поэтому добавьте эти три значения в словарь подключения.

Импорт офферов и сверка

Все три сети подключаются ещё и как интеграции: «Интеграции» → «Партнёрские сети» → «Подключение». Это отдельная от постбеков связь — по API сети.

Что нужно для подключения:

• Leads.su — API-токен из кабинета вебмастера («Аккаунт» → «Доступ к API») и, по желанию, ID площадки;
• CityAds — токен авторизации запросов из раздела API кабинета вебмастера;
• Admitad — Client ID и Client secret («Настройки» → «API и приложения») и ID площадки.

Секреты хранятся на вашем сервере в зашифрованном виде и после сохранения в форме не показываются.

Интеграция делает две вещи. Первая — импорт каталога: офферы, гео, выплаты, а при изменении ставки — запись в историю ставок. Вторая — сверка конверсий: раз в час трекер забирает конверсии сети за последние дни и сравнивает их с тем, что пришло постбеками. Так находятся потерянные постбеки. Подробно — в статье о сверке конверсий по API, общий обзор — на странице партнёрских сетей.

Проверка после настройки

1. «Проверить» в списке подключений. Трекер отправляет себе пробный постбек с clickid последнего реального клика по офферам сети. Он прогоняет маппинг и поиск клика, но ничего не записывает. В результате видно поток, оффер, статус и сумму.
2. Тест из кабинета сети. Ответ должен быть 200. Это значит «принято в очередь», а не «конверсия записана»: обработка идёт асинхронно. Синхронно трекер сообщает только о двух проблемах — нет clickid и нераспознанный статус; тогда в ответе 200 quarantined с причиной. Неизвестный токен получает 404.
3. Первая реальная заявка. Она должна появиться в ленте конверсий, а не во вкладке «Карантин».
4. Смена статуса. Когда сеть одобрит или отклонит заявку, статус должен измениться у той же конверсии. Вторая конверсия по той же заявке — признак того, что txid не задан или меняется.

Частые ошибки

• В кабинете сети виден текст {clickid}. Ссылку оффера открыли напрямую, а не через трекинговую ссылку потока. Макросы подставляет только клик через трекер.
• Постбеки приходят, конверсий нет. Откройте «Карантин». Причина «клик не найден» обычно значит, что сеть возвращает не тот параметр — например, sub-метку вместо clickid.
• Причина «Ошибка маппинга». Сеть прислала статус, которого нет в словаре. Добавьте значение в словарь подключения и переобработайте постбеки из карантина — они не потеряны.
• Конверсии с нулевой суммой. Трекер не прочитал сумму. Если в запросе есть параметр, похожий на деньги, а маппинг его не читает, постбек уйдёт в карантин с отдельной причиной. Если денег в запросе нет совсем, трекер поднимет сигнал о подтверждённой конверсии с нулевой выплатой.
• Сверка по API молчит. У рекламодателя нет подключения постбеков с пресетом, который ищет сверка. У Leads.su и CityAds подключение должно быть создано с пресетом сети, у Admitad — проверьте поле пресета в настройках интеграции.

Итог

Leads.su настраивается пресетом за несколько минут. CityAds — пресетом через интеграцию или вручную по таблице выше, с обязательной сверкой макросов в кабинете. Admitad — своим маппингом. Во всех трёх случаях логика одна: clickid уходит в ссылку оффера, возвращается в постбеке, а тест «Проверить» показывает результат до первой реальной заявки. Форматы запросов, статусная модель и дедупликация описаны в руководстве по постбекам, все доступные макросы — в справочнике макросов, а возможности раздела целиком — на странице постбеков.