# Отправка постбеков (S2S)

Отправка постбеков необходима для уведомления рекламных, баннерных сетей или других инструментов аналитики о полученных конверсиях. Добавить постбек внешнего сервиса можно следующими способами:

  • При создании источника, поле «Postback URL»;
  • При создании кампании, вкладка «S2S Постбеки».
  • При создании источника из шаблона, поле Postback URL заполняется автоматически.

# Как настроить отправку постбека для нового источника?

В случае, когда в шаблонах не нашлось вашего источника, необходимо выяснить следующее:

  1. Поддерживает ли ваш источник постбеки
  2. Какой токен используется для передачи external_id (Еще его называют ID клика или SubID источника)
  3. На какой Postback URL отправлять постбеки.
  4. После получения всей информации, необходимо настроить следующее:
  • Откройте страницу редактирования источника или откройте создание нового;
  • В таблице параметров. Рядом с external_id впишите токен для передачи ID клика. Обычно, это похожее на {UID} или {clickid}.
  • В поле Postback URL вставьте полученный постбек источника. Там где нужно передавать ID клика, впишите макрос {external_id}. Пример, http://adnetwork.com/postback?id=123&uid={external_id};
  • Источник теперь можно подключать в кампаниях.

# Какие макросы доступны?

Все перечисленные на странице список_макросов и перечисленные ниже.

{external_id} — это id переданный источником трафика

{status} — статус конверсии

{tid} — transaction id

# Как передавать другие статусы?

Для макроса {status} можно указать как конвертировать статусы. Например -1 - отмена, 0 - регистрация, 1 - депозит:

{status: rejected=-1 lead=0 sale=1}

# Что если статусы у рекламной сети другие?

Можно добавить соотношения:

{status: lead=install sale=bill rejected=trash}

# Как проверить результат отправки постбеков?

Посмотрите лог на странице «Обслуживание > Логи > Отправленные постбеки»

# Когда отправлется исходящий постбек?

Когда Keitaro сам получает постбек с конверсией.

# Как отправлять постбек в AppMetrica?

Создайте в источнике трафика или в кампании S2S постбек:

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={concersion_time:U}

API_KEY и APPLICATION_ID - заменить на ваши значения.

device_id должен быть задан в параметрах кампании.

Документация по параметрам постбека.

# Как отправлять оповещения в 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} - выплата по конверсии.

# Как конвертировать валюту при отправке постбека?

Чтобы передать в S2S постбеке выплату в другой валюте, используйте макрос {conversion_revenue: eur} eur/usd/rub