Skip to content
Для опытных⏱ 15 мин

Постбэк для Keitaro ​

Задача ​

Передавать конверсии из Keitaro в кабинет: Keitaro получает ID клика из ссылки кампании и возвращает его в постбэкеСерверное уведомление о конверсии, которое трекер отправляет в кабинет. вместе с доходом конверсии.

Это частный случай общей инструкции «Настроить postback и учёт конверсий». Здесь — только то, что отличается для Keitaro.

Что нужно заранее ​

  • Кампания в Keitaro и её ссылка: адрес, по которому Keitaro принимает клики.
  • Источник трафика в Keitaro для трафика Youtarget.
  • Кампания в кабинете. Как её создать — в инструкции «Первая кампания за 15 минут».

Шаги ​

  1. В левом меню откройте Конверсии, перейдите на вкладку Интеграция и нажмите Создать интеграцию.

    Вкладка «Интеграция» раздела «Конверсии»

  2. В поле Трекер выберите Keitaro. Кабинет заполнит поля макросами Keitaro: Идентификатор клика — {external_id}, Стоимость конверсии — {conversion_revenue}. Эти поля недоступны для правки, пока выбран шаблон.

  3. В поле Название замените подставленное «Keitaro» на понятное вам название, например «Keitaro: покупки». Длина — до 20 символов.

  4. В поле Валюта конверсии выберите USD или RUB — валюту, в которой Keitaro передаёт доход конверсии. Кабинет запишет её в ссылку постбэка как есть. Валюта в ссылке одна для всех конверсий: если в Keitaro выплаты в разных валютах, кабинет всё равно посчитает их в выбранной.

  5. В поле Тип конверсии выберите событие, например Покупка. Про тип конверсии и переключатель Принимать дублирующиеся конверсии — в общей инструкции.

  6. Нажмите Создать интеграцию.

    Окно «Создание интеграции» с выбранным шаблоном Keitaro

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

    Окно «Код интеграции» со ссылкой постбэка для Keitaro

  8. В Keitaro откройте настройки источника трафика Youtarget и укажите, в каком параметре ссылки приходит внешний ID клика: его Keitaro подставит в макрос {external_id}. Например, параметр external_id.

  9. В тех же настройках источника вставьте скопированную ссылку как постбэк. Ссылку вставляйте целиком, макросы {external_id} и {conversion_revenue} не меняйте: их заменит Keitaro.

  10. В кабинете откройте кампанию и в поле Конечный URL вставьте ссылку кампании Keitaro с параметром из шага 8 и макросом {click_id}. Например: https://tracker.example.com/r7Kq2m?external_id={click_id}.

    Поле «Конечный URL» со ссылкой кампании Keitaro

  11. Нажмите Сохранить общие настройки.

Если ссылка задана в креативе, а не в кампании, добавьте параметр с {click_id} в Страницу перехода креатива.

Результат ​

Цепочка работает так. При клике кабинет подставляет ID клика в {click_id}, Keitaro сохраняет его как external_id. Когда в Keitaro появляется конверсия, он отправляет постбэк и подставляет этот ID вместо {external_id}.

Ссылка постбэка для Keitaro выглядит так:

text
https://postback.events/?postback_id=<id интеграции>&click_id={external_id}&event_type=accept&cur=usd&payout={conversion_revenue}&ct=purchase
ПараметрЗначение в ссылкеОткуда берётся
postback_idID интеграцииКабинет, не меняйте
click_id{external_id}Шаблон Keitaro. Keitaro подставит ID клика, полученный из {click_id}
payout{conversion_revenue}Шаблон Keitaro. Keitaro подставит доход конверсии
curusd или rubПоле Валюта конверсии
event_typeacceptКабинет. На учёт не влияет, см. «Не приходят конверсии»
ctКлюч типа конверсии, например purchaseПоле Тип конверсии. Если тип не выбран, параметра нет

Проверьте связку тестовой конверсией: на вкладке Проверка событий выберите кампанию и креатив, откройте ссылку и выполните на сайте целевое действие. Конверсия появится на вкладке События с названием интеграции и стоимостью из Keitaro. Когда ждать конверсию и как читать ответ кабинета в логе Keitaro — в разделе «Не приходят конверсии».

NOTE

Кабинет учитывает все полученные конверсии как подтверждённые. Настройте в Keitaro отправку постбэка только для подтверждённых конверсий.

Что может пойти не так ​

СимптомПричинаРешение
В логе Keitaro ответ invalid uuid formatKeitaro не получил ID клика: в Конечном URL нет параметра с {click_id} или имя параметра не совпадает с настройкой источникаСверьте имя параметра в Конечном URL и в настройках источника в Keitaro
В логе Keitaro ответ invalid payoutKeitaro не подставил доход: {conversion_revenue} пришёл пустым или незаменённымПроверьте, что у конверсии в Keitaro есть доход. Подробно — в разделе «Не приходят конверсии»
Поля Идентификатор клика и Стоимость конверсии не редактируютсяВыбран шаблон Keitaro: макросы берутся из шаблонаЧтобы вписать другие макросы, выберите в поле Трекер вариант Свой вариант
Изменили валюту или тип конверсии в интеграции, а в кабинете приходят прежние значенияВалюта и тип конверсии записаны в саму ссылку постбэка. В Keitaro осталась старая ссылкаПосле сохранения интеграции кабинет снова покажет окно Код интеграции. Скопируйте новую ссылку и замените её в Keitaro
В кабинете есть конверсии, которые Keitaro отклонилКабинет учитывает все полученные постбэки как подтверждённыеОтключите в Keitaro отправку постбэка для отклонённых и отложенных конверсий

Что дальше ​

© Youtarget