Постбэк для Keitaro
Задача
Передавать конверсии из Keitaro в кабинет: Keitaro получает ID клика из ссылки кампании и возвращает его в постбэкеСерверное уведомление о конверсии, которое трекер отправляет в кабинет. вместе с доходом конверсии.
Это частный случай общей инструкции «Настроить postback и учёт конверсий». Здесь — только то, что отличается для Keitaro.
Что нужно заранее
- Кампания в Keitaro и её ссылка: адрес, по которому Keitaro принимает клики.
- Источник трафика в Keitaro для трафика Youtarget.
- Кампания в кабинете. Как её создать — в инструкции «Первая кампания за 15 минут».
Шаги
В левом меню откройте Конверсии, перейдите на вкладку Интеграция и нажмите Создать интеграцию.

В поле Трекер выберите Keitaro. Кабинет заполнит поля макросами Keitaro: Идентификатор клика —
{external_id}, Стоимость конверсии —{conversion_revenue}. Эти поля недоступны для правки, пока выбран шаблон.В поле Название замените подставленное «Keitaro» на понятное вам название, например «Keitaro: покупки». Длина — до 20 символов.
В поле Валюта конверсии выберите USD или RUB — валюту, в которой Keitaro передаёт доход конверсии. Кабинет запишет её в ссылку постбэка как есть. Валюта в ссылке одна для всех конверсий: если в Keitaro выплаты в разных валютах, кабинет всё равно посчитает их в выбранной.
В поле Тип конверсии выберите событие, например Покупка. Про тип конверсии и переключатель Принимать дублирующиеся конверсии — в общей инструкции.
Нажмите Создать интеграцию.

В окне Код интеграции нажмите Скопировать и выйти. Ссылка постбэка скопируется в буфер обмена.

В Keitaro откройте настройки источника трафика Youtarget и укажите, в каком параметре ссылки приходит внешний ID клика: его Keitaro подставит в макрос
{external_id}. Например, параметрexternal_id.В тех же настройках источника вставьте скопированную ссылку как постбэк. Ссылку вставляйте целиком, макросы
{external_id}и{conversion_revenue}не меняйте: их заменит Keitaro.В кабинете откройте кампанию и в поле Конечный URL вставьте ссылку кампании Keitaro с параметром из шага 8 и макросом
{click_id}. Например:https://tracker.example.com/r7Kq2m?external_id={click_id}.
Нажмите Сохранить общие настройки.
Если ссылка задана в креативе, а не в кампании, добавьте параметр с {click_id} в Страницу перехода креатива.
Результат
Цепочка работает так. При клике кабинет подставляет ID клика в {click_id}, Keitaro сохраняет его как external_id. Когда в Keitaro появляется конверсия, он отправляет постбэк и подставляет этот ID вместо {external_id}.
Ссылка постбэка для Keitaro выглядит так:
https://postback.events/?postback_id=<id интеграции>&click_id={external_id}&event_type=accept&cur=usd&payout={conversion_revenue}&ct=purchase| Параметр | Значение в ссылке | Откуда берётся |
|---|---|---|
postback_id | ID интеграции | Кабинет, не меняйте |
click_id | {external_id} | Шаблон Keitaro. Keitaro подставит ID клика, полученный из {click_id} |
payout | {conversion_revenue} | Шаблон Keitaro. Keitaro подставит доход конверсии |
cur | usd или rub | Поле Валюта конверсии |
event_type | accept | Кабинет. На учёт не влияет, см. «Не приходят конверсии» |
ct | Ключ типа конверсии, например purchase | Поле Тип конверсии. Если тип не выбран, параметра нет |
Проверьте связку тестовой конверсией: на вкладке Проверка событий выберите кампанию и креатив, откройте ссылку и выполните на сайте целевое действие. Конверсия появится на вкладке События с названием интеграции и стоимостью из Keitaro. Когда ждать конверсию и как читать ответ кабинета в логе Keitaro — в разделе «Не приходят конверсии».
NOTE
Кабинет учитывает все полученные конверсии как подтверждённые. Настройте в Keitaro отправку постбэка только для подтверждённых конверсий.
Что может пойти не так
| Симптом | Причина | Решение |
|---|---|---|
В логе Keitaro ответ invalid uuid format | Keitaro не получил ID клика: в Конечном URL нет параметра с {click_id} или имя параметра не совпадает с настройкой источника | Сверьте имя параметра в Конечном URL и в настройках источника в Keitaro |
В логе Keitaro ответ invalid payout | Keitaro не подставил доход: {conversion_revenue} пришёл пустым или незаменённым | Проверьте, что у конверсии в Keitaro есть доход. Подробно — в разделе «Не приходят конверсии» |
| Поля Идентификатор клика и Стоимость конверсии не редактируются | Выбран шаблон Keitaro: макросы берутся из шаблона | Чтобы вписать другие макросы, выберите в поле Трекер вариант Свой вариант |
| Изменили валюту или тип конверсии в интеграции, а в кабинете приходят прежние значения | Валюта и тип конверсии записаны в саму ссылку постбэка. В Keitaro осталась старая ссылка | После сохранения интеграции кабинет снова покажет окно Код интеграции. Скопируйте новую ссылку и замените её в Keitaro |
| В кабинете есть конверсии, которые Keitaro отклонил | Кабинет учитывает все полученные постбэки как подтверждённые | Отключите в Keitaro отправку постбэка для отклонённых и отложенных конверсий |
Что дальше
- Оптимизировать кампанию по CPA и брать стоимость конверсии из постбэка — в разделе «Что дальше» общей инструкции.
- Та же связка для Binom — «Постбэк для Binom».
- Если конверсии не появились — «Не приходят конверсии».