# S2S Postback

S2S postback — это инструмент для аналитики и сбора данных на стороне источника трафика или на любом внешнем ресурсе.

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

Keitaro добавляет S2S postback автоматически при выборе источника трафика, но возможно добавить и дополнительные S2S postbacks.

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

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

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

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

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

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

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

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

# S2S postback FAQ

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

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

Информацию о статусе отправки конверсий из трекера смотрите в Логе отправленных postback'ов Обслуживание → Логи → S2S postbacks.

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

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

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

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

Информацию о статусе отправки конверсий из трекера смотрите в Логе отправленных 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.

Как настроить отправку postback в Mgid?

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

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

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