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

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

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

## Задача

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

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

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

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

## Шаги

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

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

2. В поле **Трекер** выберите **Binom**. Кабинет заполнит поля макросами Binom: **Идентификатор клика** — `{externalid}`, **Стоимость конверсии** — `{payout}`. Эти поля недоступны для правки, пока выбран шаблон.
3. В поле **Название** замените подставленное «Binom» на понятное вам название, например «Binom: лиды». Длина — до 20 символов.
4. В поле **Валюта конверсии** выберите **USD** или **RUB** — валюту, в которой Binom передаёт доход конверсии. Кабинет запишет её в ссылку постбэка как есть. Валюта в ссылке одна для всех конверсий: если в Binom выплаты в разных валютах, кабинет всё равно посчитает их в выбранной.
5. В поле **Тип конверсии** выберите событие, например **Лид (заявка/форма)**. Про тип конверсии и переключатель **Принимать дублирующиеся конверсии** — в [общей инструкции](./postback.md).
6. Нажмите **Создать интеграцию**.

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

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

   *Скриншот: Окно «Код интеграции» со ссылкой постбэка для Binom*

8. В Binom откройте настройки источника трафика Youtarget и укажите, в каком параметре ссылки приходит внешний ID клика: его Binom подставит в макрос `{externalid}`. Например, параметр `externalid`.
9. В тех же настройках источника вставьте скопированную ссылку как постбэк. Ссылку вставляйте целиком, макросы `{externalid}` и `{payout}` не меняйте: их заменит Binom.
10. В кабинете откройте кампанию и в поле **Конечный URL** вставьте ссылку кампании Binom с параметром из шага 8 и макросом `{click_id}`. Например: `https://tracker.example.com/k4Tz9p?externalid={click_id}`.

    *Скриншот: Поле «Конечный URL» со ссылкой кампании Binom*

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

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

## Результат

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

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

```text
https://postback.events/?postback_id=<id интеграции>&click_id={externalid}&event_type=accept&cur=usd&payout={payout}&ct=lead
```

| Параметр | Значение в ссылке | Откуда берётся |
| --- | --- | --- |
| `postback_id` | ID интеграции | Кабинет, не меняйте |
| `click_id` | `{externalid}` | Шаблон Binom. Binom подставит ID клика, полученный из `{click_id}` |
| `payout` | `{payout}` | Шаблон Binom. Binom подставит доход конверсии |
| `cur` | `usd` или `rub` | Поле **Валюта конверсии** |
| `event_type` | `accept` | Кабинет. На учёт не влияет, см. [«Не приходят конверсии»](../troubleshooting/no-conversions.md) |
| `ct` | Ключ типа конверсии, например `lead` | Поле **Тип конверсии**. Если тип не выбран, параметра нет |

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

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

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

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

## Что дальше

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