Skip to content

S2S постбэки ​

S2S постбэки (server-to-server postback) позволяют передавать в Adstat конверсии из вашего трекера или CRM. Когда пользователь, пришедший из объявления Telegram Ads, совершает целевое действие: регистрируется или совершает покупку на сайте, трекер отправляет запрос на ссылку Adstat — и событие появляется в разделе «Статистика» в колонках «Лиды» и «Продажи». Запрос идёт напрямую с сервера на сервер, без участия браузера пользователя.

В этой инструкции настройка разобрана на примере трекера Keitaro. В схеме Keitaro Adstat выступает источником трафика: трекер получает клики из объявлений Adstat и отправляет конверсии обратно в Adstat.


Как это работает ​

  1. Вы указываете в объявлении ссылку кампании трекера с параметром creative_id={{ad_id}}. При создании объявления Adstat подставляет вместо {{ad_id}} ID объявления.
  2. Пользователь кликает по объявлению в Telegram. Трекер фиксирует клик и сохраняет ID объявления.
  3. Пользователь совершает целевое действие на сайте. Партнёрская сеть или ваша CRM сообщает трекеру о конверсии.
  4. Трекер отправляет S2S постбэк на ссылку Adstat: передаёт ID объявления и тип события.
  5. Adstat привязывает событие к объявлению по ID и показывает его в статистике.

Важно

Без параметра creative_id в ссылке кампании Adstat не сможет понять, к какому объявлению относится конверсия. Такое событие не попадёт в статистику.


Ссылка для постбэков в Adstat ​

Ссылка для постбэков находится на странице S2S Постбэки в разделе «Источники данных». Нажмите «Скопировать ссылку», чтобы скопировать базовую ссылку.

Страница S2S Постбэки в Adstat

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 ​

Настройка состоит из четырёх шагов:

  1. Создать источник трафика Adstat в Keitaro.
  2. Подключить источник к кампании.
  3. Указать ссылку кампании в объявлениях Adstat.
  4. Проверить, что постбэки доходят.

Шаг 1. Создайте источник трафика ​

Источник трафика в Keitaro — это шаблон. Он задаёт, какие параметры приходят с кликом и куда отправлять конверсии. Готового шаблона Adstat в Keitaro нет, поэтому источник создаётся вручную.

Создание источника Adstat в Keitaro
  1. В Keitaro откройте раздел «Источники» и нажмите «Создать».

  2. В поле «Название» укажите понятное имя, например Adstat (Telegram Ads).

  3. В поле «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. Необязательные параметры можно убрать из ссылки, если они вам не нужны.

  4. В поле «Только со статусами» выберите lead и sale. Остальные статусы (rejected, rebill) Adstat не учитывает, отправлять их не нужно.

  5. В блоке «Параметры» найдите строку Creative ID и заполните её:

    Название (1-й столбец)Параметр (2-й столбец)Значение (3-й столбец)
    Объявлениеcreative_id{{ad_id}}
    • Во втором столбце оставьте creative_id (значение по умолчанию): под этим именем параметр попадёт в ссылку кампании.
    • В третьем столбце — {{ad_id}}: макрос Adstat. При создании объявления Adstat заменит его на реальный ID объявления.

    Keitaro сохранит полученное значение как Creative ID клика и вернёт его в постбэке через макрос {creative_id}.

  6. Нажмите «Сохранить».

Шаг 2. Подключите источник к кампании ​

Поле «Источник» в настройках кампании Keitaro
  1. Откройте настройки кампании в Keitaro.

  2. В поле «Источник» выберите созданный источник Adstat (Telegram Ads).

  3. Keitaro автоматически добавит параметры источника в ссылку кампании (Campaign URL). Она будет выглядеть примерно так:

    https://your-tracker-domain.com/AbCdEf?creative_id={{ad_id}}
  4. Сохраните кампанию и скопируйте ссылку кампании.

TIP

После выбора источника S2S постбэк на Adstat подключается к кампании автоматически. Отдельно добавлять его на вкладке «S2S Postbacks» не нужно.

Шаг 3. Укажите ссылку кампании в объявлениях Adstat ​

  1. В Adstat создайте объявление или откройте существующее.

  2. В поле «URL канала/бота/сайта» вставьте ссылку кампании Keitaro из шага 2.

  3. Убедитесь, что в ссылке есть параметр creative_id={{ad_id}}. Его можно дописать вручную или добавить в окне «Рекламируемый объект с параметрами»: укажите параметр creative_id со значением {{ad_id}} и нажмите «Вставить в объявление».

    Окно «Рекламируемый объект с параметрами» с параметром creative_id

    После вставки ссылка в объявлении будет содержать параметр:

    Ссылка с параметром creative_id в объявлении Adstat
  4. Сохраните объявление. Adstat заменит {{ad_id}} на ID объявления — после создания в ссылке будет, например, creative_id=12345.

Одну и ту же ссылку кампании можно использовать во всех объявлениях: ID у каждого объявления будет свой.

Подробнее о создании объявлений — в разделе Объявления.

Важно

  • Изменение ссылки в объявлении отправляет его на повторную модерацию.
  • Ссылка должна быть полной, с https://. Сокращатели ссылок запрещены правилами Telegram Ads.
  • Постбэки начнут приходить только по кликам, совершённым после того, как в объявлении появилась ссылка с параметром creative_id.

Шаг 4. Проверьте, что постбэки доходят ​

Лог S2S postbacks в Keitaro
  1. Перейдите по ссылке объявления и совершите тестовое целевое действие — или дождитесь первой реальной конверсии.
  2. В Keitaro откройте Обслуживание → Логи → S2S postbacks. В логе видно, на какую ссылку ушла конверсия и какой ответ пришёл от Adstat.
  3. Убедитесь, что в отправленной ссылке вместо макросов подставлены значения: ad_id содержит ID объявления, а status — lead или sale.
  4. Откройте в 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: при неправильном формате датой события становится время получения постбэка.