<!-- https://docs.youtarget.com/advertiser/cases/postback-keitaro.html -->

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

> Связать кабинет с Keitaro: интеграция с шаблоном Keitaro, ссылка кампании с ID клика и постбэк в настройках источника.

## Задача

Передавать конверсии из Keitaro в кабинет: Keitaro получает ID клика из ссылки кампании и возвращает его в [постбэке](https://docs.youtarget.com/advertiser/glossary/postback.md) вместе с доходом конверсии.

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

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

- Кампания в Keitaro и её ссылка: адрес, по которому Keitaro принимает клики.
- Источник трафика в Keitaro для трафика Youtarget.
- Кампания в кабинете. Как её создать — в инструкции [«Первая кампания за 15 минут»](../quick-start/first-campaign.md).

## Шаги

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

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

2. В поле **Трекер** выберите **Keitaro**. Кабинет заполнит поля макросами Keitaro: **Идентификатор клика** — `{external_id}`, **Стоимость конверсии** — `{conversion_revenue}`. Эти поля недоступны для правки, пока выбран шаблон.
3. В поле **Название** замените подставленное «Keitaro» на понятное вам название, например «Keitaro: покупки». Длина — до 20 символов.
4. В поле **Валюта конверсии** выберите **USD** или **RUB** — валюту, в которой Keitaro передаёт доход конверсии. Кабинет запишет её в ссылку постбэка как есть. Валюта в ссылке одна для всех конверсий: если в Keitaro выплаты в разных валютах, кабинет всё равно посчитает их в выбранной.
5. В поле **Тип конверсии** выберите событие, например **Покупка**. Про тип конверсии и переключатель **Принимать дублирующиеся конверсии** — в [общей инструкции](./postback.md).
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_id` | ID интеграции | Кабинет, не меняйте |
| `click_id` | `{external_id}` | Шаблон Keitaro. Keitaro подставит ID клика, полученный из `{click_id}` |
| `payout` | `{conversion_revenue}` | Шаблон Keitaro. Keitaro подставит доход конверсии |
| `cur` | `usd` или `rub` | Поле **Валюта конверсии** |
| `event_type` | `accept` | Кабинет. На учёт не влияет, см. [«Не приходят конверсии»](../troubleshooting/no-conversions.md) |
| `ct` | Ключ типа конверсии, например `purchase` | Поле **Тип конверсии**. Если тип не выбран, параметра нет |

Проверьте связку тестовой конверсией: на вкладке **Проверка событий** выберите кампанию и креатив, откройте ссылку и выполните на сайте целевое действие. Конверсия появится на вкладке **События** с названием интеграции и стоимостью из Keitaro. Когда ждать конверсию и как читать ответ кабинета в логе Keitaro — в разделе [«Не приходят конверсии»](../troubleshooting/no-conversions.md).

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

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

| Симптом | Причина | Решение |
| --- | --- | --- |
| В логе Keitaro ответ `invalid uuid format` | Keitaro не получил ID клика: в **Конечном URL** нет параметра с `{click_id}` или имя параметра не совпадает с настройкой источника | Сверьте имя параметра в **Конечном URL** и в настройках источника в Keitaro |
| В логе Keitaro ответ `invalid payout` | Keitaro не подставил доход: `{conversion_revenue}` пришёл пустым или незаменённым | Проверьте, что у конверсии в Keitaro есть доход. Подробно — в разделе [«Не приходят конверсии»](../troubleshooting/no-conversions.md) |
| Поля **Идентификатор клика** и **Стоимость конверсии** не редактируются | Выбран шаблон Keitaro: макросы берутся из шаблона | Чтобы вписать другие макросы, выберите в поле **Трекер** вариант **Свой вариант** |
| Изменили валюту или тип конверсии в интеграции, а в кабинете приходят прежние значения | Валюта и тип конверсии записаны в саму ссылку постбэка. В Keitaro осталась старая ссылка | После сохранения интеграции кабинет снова покажет окно **Код интеграции**. Скопируйте новую ссылку и замените её в Keitaro |
| В кабинете есть конверсии, которые Keitaro отклонил | Кабинет учитывает все полученные постбэки как подтверждённые | Отключите в Keitaro отправку постбэка для отклонённых и отложенных конверсий |

## Что дальше

- Оптимизировать кампанию по CPA и брать стоимость конверсии из постбэка — в разделе «Что дальше» [общей инструкции](./postback.md).
- Та же связка для Binom — [«Постбэк для Binom»](./postback-binom.md).
- Если конверсии не появились — [«Не приходят конверсии»](../troubleshooting/no-conversions.md).
