Постбеки (отправка)

Отправка постбеков необходима для уведомления рекламных, баннерных сетей или других инструментов аналитики о полученных конверсиях.

Добавить постбек внешнего сервиса можно двумя способами:

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

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

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

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

  1. Поддерживает ли ваш источник постбеки
  2. Какой токер используется для передачи «external_id» (Еще его называют ID клика или SubID источника)
  3. На какой Postback URL отправлять постбеки.

После получения всей информации, необходимо настроить следующее:

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

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

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

  • {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 постбек: {code} 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} {code} API_KEY и APPLICATION_ID - заменить на ваши значения.

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

Документация по параметрам постбека https://tech.yandex.ru/appmetrica/doc/mobile-api/post/post-import-events-docpage/

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