# S2S Postback

S2S postbacks - это инструмент для аналитики и сбора данных на стороне источника трафика или на любом внешнем ресурсе, который умеет с ними работать.

# Добавление дополнительного S2S postback

  1. Зайдите в настройки кампании.
  2. Откройте вкладку S2S Postbacks.
  3. Нажмите Добавить внешний postback.

  • URL — укажите адрес, куда отправлять postback.
  • Метод отправки — необходимо уточнять в Источнике, GET или POST.
  • Состояние — при каких статусах конверсии отправлять postback.

Метод GET — отправляет скрипту всю собранную информацию формы как часть URL.

Метод POST — передаёт данные таким образом, что пользователь сайта уже не видит передаваемые скрипту данные.

# S2S источника трафика

Смотрите страницу S2S postback источника трафика

# S2S макросы (placeholders)

Смотрите страницу S2S postback макросы

# S2S postback FAQ

Почему S2S postback не отправляется?

Проверьте, выставлен ли в настройках кампании Источник со ссылкой S2S, или есть ли в настройках кампании во вкладке S2S postback'и настроенный postback. Если postback настроен — переходим к следующему пункту. Если постбека нет — настраиваем его по инструкции выше.

Всю информацию о статусе отправки конверсий из трекера можно получить в Логе отправленных postback: Обслуживание → Логи → Отправленные postback.

Мы постарались максимально детализировать его, вплоть до того, что добавили туда информацию о том, какой subid инициирует S2S отправку.

В логе Отправленных postback будет видно, на какую ссылку ушла конверсия из Keitaro и какой ответ был получен из Источника. Если в ответе ошибка, необхолимо обратиться в Источник за разъяснением этой ошибки.

Убедитесь, что в ссылке S2S подставляется значение ID клика Источника. Т.е. вместо макроса {external_id} должно подставляться значение ID клика из Источника. Если значение не подставляется, убедитесь, что трафик в Источнике льется на ссылку, в которой есть параметр {external_id}. Если параметра нет — перейдите к пункту настройки в данной статье, где настраивается Источник, шаблона которого нет в трекере. Настройка должны выглядеть так, как в пункте 3 на скриншоте выше.

Проверьте, какой статус конверсии пришел в трекере, и убедитесь, что в настройках S2S постбека стоит галочка отправлять конверсии с этим статусом.

Где найти лог отправленных S2S postback?

Нажмите на Обслуживание. Затем Логи и внутри на вкладке S2S postbacks.

Как отправить в Telegram?
  1. Создайте нового бота в Telegram, используя бота @BotFather и команду /newbot.
  2. Сохраните полученный токен.
  3. Откройте диалог со своим ботом, напишите ему сообщение.
  4. Сделайте запрос, чтобы получить ID бота для отправки сообщений, следующей командой:

api.telegram.org/botREPLACE/getUpdates

Где вместо REPLACE необходимо вставить API token бота в формате 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

  1. Возьмите ID из строки "message":{"message_id": X,"from":{id: ID}}

Где вместо ID необходимо вставить реальный ID.

  1. Отправьте боту сообщение через API командой https://api.telegram.org/botREPLACE/sendMessage?chat_id=ID&text=text

Где вместо REPLACE необходимо вставить API token бота, а вместо ID — реальный ID.

  1. Если все ок и сообщение пришло, то можно использовать полученный адрес в качестве S2S postback в настройках кампании трекера. Примерный шаблон S2S postback может выглядеть следующим образом:

https://api.telegram.org/botREPLACE/sendMessage?chat_id=ID&text={campaign_name}:{status}:{conversion_revenue}

Где {campaign_name} — имя кампании, {status} — статус конверсии, {conversion_revenue} — выплата по конверсии.

Как отправить в AppMetrica?

Добавьте дополнительный S2S postback:

https://api.appmetrica.yandex.ru/logs/v1/import/events?post_api_key=API_KEY&application_id=APPLICATION_ID&appmetrica_device_id={device_id}&event_name={status}&event_timestamp={conversion_time:U} 
1

Замените API_KEY и APPLICATION_ID на значения. Параметр device_id задайте в параметрах кампании.

Читайте также документацию по postback в AppMetrica.

Когда отправляется S2S postback?

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

::: Как настроить отправку постбеков в Mgid?

Читайте статью в блоге Mgid. :::