# Отправка постбеков (S2S)
- Как настроить отправку постбека для нового источника?
- Какие макросы доступны?
- Как передавать другие статусы?
- Что если статусы у рекламной сети другие?
- Как проверить результат отправки постбеков?
- Когда отправлется исходящий постбек?
- Как отправлять постбек в AppMetrica?
- Как отправлять оповещения в Telegram?
- Как конвертировать валюту при отправке постбека?
Отправка постбеков необходима для уведомления рекламных, баннерных сетей или других инструментов аналитики о полученных конверсиях. Добавить постбек внешнего сервиса можно следующими способами:
- При создании источника, поле «Postback URL»;
- При создании кампании, вкладка «S2S Постбеки».
- При создании источника из шаблона, поле Postback URL заполняется автоматически.
# Как настроить отправку постбека для нового источника?
В случае, когда в шаблонах не нашлось вашего источника, необходимо выяснить следующее:
- Поддерживает ли ваш источник постбеки
- Какой токен используется для передачи
external_id
(Еще его называют ID клика или SubID источника) - На какой Postback URL отправлять постбеки.
- После получения всей информации, необходимо настроить следующее:
- Откройте страницу редактирования источника или откройте создание нового;
- В таблице параметров. Рядом с
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?
- Создать нового бота в Telegram, используя бота
@BotFather
и команду/newbot
. - Задаем имена и сохраняем полученный токен
- Открываем диалог со своим ботом, пишем ему сообщение.
- Делаем запрос на бота, чтобы получить id бота для отправки сообщений, следующей командой
api.telegram.org/botREPLACE/getUpdates
где, вместо REPLACE
нужно вставить API token бота в формате 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
- Получаем id из строки
message«:{«message_id»:X,»from«:{«id»:ID
где, вместо ID будет ваш реальный id
- Отправляем боту сообщение через API , командой
https://api.telegram.org/botREPLACE/sendMessage?chat_id=ID&text=text
где, вместо REPLACE
нужно вставить API token бота, а вместо ID – реальный id
- Если все ок и сообщение пришло, то можно использовать полученный адрес в качестве 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