Отправка постбеков (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};
• Источник теперь можно подключать в кампаниях.

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

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

{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}

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

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

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

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

Как отправлять постбек в 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 должен быть задан в параметрах кампании.

Документация по параметрам постбека. (opens new window)

Как отправлять оповещения в Telegram?

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

api.telegram.org/botREPLACE/getUpdates

где, вместо REPLACE нужно вставить API token бота в формате 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

5. Получаем id из строки message«:{«message_id»:X,»from«:{«id»:ID

где, вместо ID будет ваш реальный id

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

где, вместо REPLACE нужно вставить API token бота, а вместо ID – реальный id

7. Если все ок и сообщение пришло, то можно использовать полученный адрес в качестве 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 можно использовать одну из валют: eur/usd/gbp/rub/uah