S2S постбэки
S2S постбэки (server-to-server postback) позволяют передавать в Adstat конверсии из вашего трекера или CRM. Когда пользователь, пришедший из объявления Telegram Ads, совершает целевое действие: регистрируется или совершает покупку на сайте, трекер отправляет запрос на ссылку Adstat — и событие появляется в разделе «Статистика» в колонках «Лиды» и «Продажи». Запрос идёт напрямую с сервера на сервер, без участия браузера пользователя.
В этой инструкции настройка разобрана на примере трекера Keitaro. В схеме Keitaro Adstat выступает источником трафика: трекер получает клики из объявлений Adstat и отправляет конверсии обратно в Adstat.
Как это работает
- Вы указываете в объявлении ссылку кампании трекера с параметром
creative_id={{ad_id}}. При создании объявления Adstat подставляет вместо{{ad_id}}ID объявления. - Пользователь кликает по объявлению в Telegram. Трекер фиксирует клик и сохраняет ID объявления.
- Пользователь совершает целевое действие на сайте. Партнёрская сеть или ваша CRM сообщает трекеру о конверсии.
- Трекер отправляет S2S постбэк на ссылку Adstat: передаёт ID объявления и тип события.
- Adstat привязывает событие к объявлению по ID и показывает его в статистике.
Важно
Без параметра creative_id в ссылке кампании Adstat не сможет понять, к какому объявлению относится конверсия. Такое событие не попадёт в статистику.
Ссылка для постбэков в Adstat
Ссылка для постбэков находится на странице S2S Постбэки в разделе «Источники данных». Нажмите «Скопировать ссылку», чтобы скопировать базовую ссылку.

Adstat принимает постбэки в формате:
https://postback.adstat.pro/?ad_id=<ID объявления>&status=<lead или sale>Например: https://postback.adstat.pro/?ad_id=12345&status=lead.
В трекере вместо <ID объявления> и <lead или sale> указываются макросы, которые трекер заменит на реальные значения при отправке. Остальные параметры из таблицы ниже добавляются к ссылке по желанию.
Параметры ссылки
| Параметр | Обязательный | Что передаёт |
|---|---|---|
ad_id | Да | ID объявления, пришедший с кликом. По нему событие привязывается к объявлению |
status | Да | Тип события: lead — регистрация, sale — продажа. Другие значения не учитываются |
tid | Нет | Номер конверсии в вашей системе. По нему отсекаются повторные постбэки |
click_id | Нет | ID клика в вашем трекере. Нужен для разбора проблем |
event_date | Нет | Дата и время события в источнике |
Дата события
Если event_date не передан или передан в неправильном формате, датой события считается фактическое время получения постбэка в Adstat.
Настройка в Keitaro
Настройка состоит из четырёх шагов:
- Создать источник трафика Adstat в Keitaro.
- Подключить источник к кампании.
- Указать ссылку кампании в объявлениях Adstat.
- Проверить, что постбэки доходят.
Шаг 1. Создайте источник трафика
Источник трафика в Keitaro — это шаблон. Он задаёт, какие параметры приходят с кликом и куда отправлять конверсии. Готового шаблона Adstat в Keitaro нет, поэтому источник создаётся вручную.

В Keitaro откройте раздел «Источники» и нажмите «Создать».
В поле «Название» укажите понятное имя, например
Adstat (Telegram Ads).В поле «S2S postback» вставьте ссылку Adstat с макросами Keitaro:
https://postback.adstat.pro/?ad_id={creative_id}&status={status}Это минимальный вариант. Чтобы передавать также номер конверсии, ID клика и дату события, используйте расширенную ссылку:
https://postback.adstat.pro/?ad_id={creative_id}&status={status}&tid={tid}&click_id={subid}&event_date={conversion_time:Y-m-d H:i:s,UTC}В ссылке используются макросы Keitaro. При отправке постбэка трекер заменит их на реальные значения:
Макрос Keitaro Параметр Adstat Значение {creative_id}ad_idID объявления, пришедший с кликом {status}statusСтатус конверсии: lead,sale{tid}tidID транзакции (конверсии) {subid}click_idID клика в Keitaro {conversion_time:Y-m-d H:i:s,UTC}event_dateДата и время конверсии в UTC Обязательны только
ad_idиstatus. Необязательные параметры можно убрать из ссылки, если они вам не нужны.В поле «Только со статусами» выберите lead и sale. Остальные статусы (
rejected,rebill) Adstat не учитывает, отправлять их не нужно.В блоке «Параметры» найдите строку Creative ID и заполните её:
Название (1-й столбец) Параметр (2-й столбец) Значение (3-й столбец) Объявление creative_id{{ad_id}}- Во втором столбце оставьте
creative_id(значение по умолчанию): под этим именем параметр попадёт в ссылку кампании. - В третьем столбце —
{{ad_id}}: макрос Adstat. При создании объявления Adstat заменит его на реальный ID объявления.
Keitaro сохранит полученное значение как Creative ID клика и вернёт его в постбэке через макрос
{creative_id}.- Во втором столбце оставьте
Нажмите «Сохранить».
Шаг 2. Подключите источник к кампании

Откройте настройки кампании в Keitaro.
В поле «Источник» выберите созданный источник
Adstat (Telegram Ads).Keitaro автоматически добавит параметры источника в ссылку кампании (Campaign URL). Она будет выглядеть примерно так:
https://your-tracker-domain.com/AbCdEf?creative_id={{ad_id}}Сохраните кампанию и скопируйте ссылку кампании.
TIP
После выбора источника S2S постбэк на Adstat подключается к кампании автоматически. Отдельно добавлять его на вкладке «S2S Postbacks» не нужно.
Шаг 3. Укажите ссылку кампании в объявлениях Adstat
В Adstat создайте объявление или откройте существующее.
В поле «URL канала/бота/сайта» вставьте ссылку кампании Keitaro из шага 2.
Убедитесь, что в ссылке есть параметр
creative_id={{ad_id}}. Его можно дописать вручную или добавить в окне «Рекламируемый объект с параметрами»: укажите параметрcreative_idсо значением{{ad_id}}и нажмите «Вставить в объявление».
После вставки ссылка в объявлении будет содержать параметр:

Сохраните объявление. Adstat заменит
{{ad_id}}на ID объявления — после создания в ссылке будет, например,creative_id=12345.
Одну и ту же ссылку кампании можно использовать во всех объявлениях: ID у каждого объявления будет свой.
Подробнее о создании объявлений — в разделе Объявления.
Важно
- Изменение ссылки в объявлении отправляет его на повторную модерацию.
- Ссылка должна быть полной, с
https://. Сокращатели ссылок запрещены правилами Telegram Ads. - Постбэки начнут приходить только по кликам, совершённым после того, как в объявлении появилась ссылка с параметром
creative_id.
Шаг 4. Проверьте, что постбэки доходят

- Перейдите по ссылке объявления и совершите тестовое целевое действие — или дождитесь первой реальной конверсии.
- В Keitaro откройте Обслуживание → Логи → S2S postbacks. В логе видно, на какую ссылку ушла конверсия и какой ответ пришёл от Adstat.
- Убедитесь, что в отправленной ссылке вместо макросов подставлены значения:
ad_idсодержит ID объявления, аstatus—leadилиsale. - Откройте в Adstat раздел Статистика, выберите разбивку «По объявлениям» и включите колонки «Лиды» и «Продажи» через значок шестерёнки.
Как считаются события
- Лиды — количество постбэков со статусом
lead. - Продажи — количество постбэков со статусом
sale. - Постбэки с другими статусами не учитываются.
- Если передан
tid, повторные постбэки с тем же номером конверсии не засчитываются дважды. Передавайтеtid, если трекер может повторно отправить одну и ту же конверсию. - Событие учитывается в статистике по дате из
event_date. Если параметр не передан или его формат неправильный, используется фактическое время получения постбэка. - Статистика в Adstat отображается в часовом поясе UTC.
Если конверсии не появляются в статистике
Постбэк не отправляется из Keitaro
- Проверьте, что в настройках кампании выбран источник Adstat.
- Проверьте, что в настройках источника в поле «Только со статусами» отмечены статусы конверсии, которая пришла в трекер.
- Посмотрите лог: Обслуживание → Логи → S2S postbacks.
В ссылке постбэка пустой ad_id или вместо значения стоит {creative_id}
- Проверьте, что в объявлении Adstat указана ссылка кампании с параметром
creative_id, и что после создания объявления в нём стоит ID объявления, а не пустое значение. - Проверьте, что в параметрах источника в строке Creative ID во втором столбце указано
creative_id, а в третьем —{{ad_id}}. - Откройте в Keitaro лог кликов, добавьте колонку Creative ID и убедитесь, что значение приходит с кликом.
Постбэк отправлен, но событие не видно в Adstat
- Проверьте значение
status: учитываются толькоleadиsale. - Проверьте, что
ad_idв постбэке совпадает с ID объявления в Adstat. - Проверьте фильтры статистики: период, кабинет и объект рекламирования должны включать нужное объявление.
- Если событие попало не в тот день, проверьте
event_date: при неправильном формате датой события становится время получения постбэка.