> For the complete documentation index, see [llms.txt](https://help.onebot.tech/onebot-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.onebot.tech/onebot-help/integracii/integraciya-keitaro-s-onebot.md).

# Интеграция Keitaro с Onebot

В данной пошаговой инструкции будет рассмотрена процедура интеграции Keitaro с Onebot. Эта интеграция позволит вам автоматизировать управление рекламными кампаниями, отслеживать результаты и получать уведомления о действиях пользователей через вашего выбранного мессенджера или платформу обмена сообщениями.

{% hint style="success" %}
С чего начать?
{% endhint %}

**Шаг 1. Для начала работы необходимо открыть подготовленный Keitaro**

На главной панели размещены основные инструменты управления трекером

<div align="left"><figure><img src="/files/CNrQ1gMpWcPgQpyDZxbo" alt=""><figcaption><p>Подготовленный для работы Keitaro</p></figcaption></figure></div>

**Шаг 2. Создание источника**

Для начала настроим источник. Для этого на панели управления необходимо перейти во вкладку “**Источники**”  /admin/#!/traffic\_sources/ и нажать кнопку “**Создать**”. В трекере выберем источник с которого будем заливать схемный трафик, в нашем случае это Facebook.

<div align="left"><figure><img src="/files/ysrbW5X3ixHINubhBtlA" alt=""><figcaption><p>Создание источника</p></figcaption></figure></div>

**Далее необходимо настроить метки и s2s postback для корректной работы**.&#x20;

Это позволит не вводить изменения вручную каждый раз как следствие это снизит риск неправильного ввода данных.&#x20;

Ссылка на s2s ключ к API можете запросить в чате или получить в настройках профиля:&#x20;

`https://api.bigtraff.click/?status={original_status}&uid={sub_id_10}&key=api_key_onebot`

Пропишем первую метку user\_id - данная метка позволяет синхронизировать пользователя с ботом, менять сценарий после прохождения пользователем целевых действий:

Регистрация/депозит/ квалификация

Вторая метка mb\_id позволяет пробрасывать в партнерку byer\_id, чтобы ваш менеджер в партнерской программе мог предупредить вас что ваш байер плохо льет трафик. Таким образом настроенные метки имеют такой вид:

<div align="left"><figure><img src="/files/ysNmwQXcMIzNxO4HPD6B" alt=""><figcaption><p>Настроенные метки в источнике</p></figcaption></figure></div>

После настройки меток нажимаем кнопку “**Сохранить**”. На этом настройка Источника завершена. Следующим шагом необходимо создать партнерскую сеть.

**Шаг 3. Создание партнерской сети**

Партнерская сеть позволяет отслеживать подписчиков. Для создания партнерской сети на панели управления переходим на вкладку “**Партнерские сети**” (/admin/#!/affiliate\_networks/) и нажимаем кнопку “**Создать**” В названии сети указываем OneBot и нажимаем кнопку “**Сохранить**”. &#x20;

<div align="left"><figure><img src="/files/n48azZSc5HycyUNVrEz5" alt=""><figcaption><p>Готовая партнерская сеть</p></figcaption></figure></div>

Дополнительно так же можно рассмотреть - [FAQ от Keitaro  по созданию Партнерской сети в трекере](https://docs.keitaro.io/ru/conversions-and-postback/postback.html).

**Шаг 4. Создание оффера**

Для создания оффера на панели управления переходим на вкладку “**Офферы**” (/admin/#!/offers/) и нажимаем кнопку “**Создать**”. Указываем название OneBot, выбираем созданную ранее партнерскую сеть Onebot. Во вкладке “**Действие**” выбираем параметр “**Ничего не делать**”. После чего жмем кнопку “**Сохранить**”. Настроенный оффер имеет такой вид:

<div align="left"><figure><img src="/files/Yg4DyCehXUwgh5xgp5jI" alt=""><figcaption><p>Настроенный оффер</p></figcaption></figure></div>

Таким образом мы подготовили стандартный оффер для аналитики. Следующим шагом создадим кампанию.

**Шаг 5. Создание кампании**

Для создания кампании на панели управления переходим на вкладку “**Кампании**” (/admin/#!/campaigns/) и нажимаем кнопку “**Создать**”.&#x20;

Указываем имя компании Organic. Органические кампании нужны чтобы не терять трафик в случае если человек подписался на бота через длительное время или же поделился ботом с другим человеком и нужно узнать кому он принадлежит.&#x20;

Далее указываем домен в нашем случае это (onebot.click) и источник **Facebook**. После этого необходимо создать два потока.

**Первый поток.** При создании первого потока в основных параметрах указываем его название, тип потока устанавливаем на “**Перехватывающий**”

<div align="left"><figure><img src="/files/jGqblewWiny7BjYxgAz8" alt=""><figcaption><p>Настройка основных параметров первого потока</p></figcaption></figure></div>

Далее в окне создания потока переходим во вкладку “**Фильтры**”. Добавляем фильтр Sub ID 10  и указываем правило путем установки флажка “Нет” после чего нажимаем “Добавить ‘пустое’ ” которое в случае если саб не пустой будет совершаться переход.  Настроенный фильтр имеет такой вид:

<div align="left"><figure><img src="/files/odZu9XH4aQ0pqIxVqsLR" alt=""><figcaption><p>Настройка фильтров первого потока</p></figcaption></figure></div>

Далее переходим во вкладку “**Схема**” и нажимаем “**Добавить оффер**” В нем нужно указать ваш прямой офер. Для теста выберем прямой URL, в окне URL указываем прямую ссылку. После чего нажимаем “**Сохранить**”. Настроенная Схема имеет такой вид:

<div align="left"><figure><img src="/files/qiQDzLynIZgpCrWgVrE7" alt=""><figcaption><p>Настройка схем первого потока</p></figcaption></figure></div>

**Второй поток**. В типе потока указываем “**Замыкающий**” во вкладке “**Схемы**” нажимаем “**Добавить оффер**” и выбираем созданный ранее Onebot:

<div align="left"><figure><img src="/files/H1c4Tumi8N7h4ZkGyuGd" alt=""><figcaption></figcaption></figure></div>

Сама техника работает по принципу, что к вашей ссылке добавляется параметр user\_id внутри бота и если есть значение он редиректит на оффер, если же нет этого значения, он ничего не показывает. Также в этот оффер (поток) приходят постбеки (лид new) от платформы о подписке юзера.&#x20;

Таким образом созданная компания имеет такой вид:

<div align="left"><figure><img src="/files/mycPkjq9WJvtzooxGdDW" alt=""><figcaption><p>Вид готовой кампании</p></figcaption></figure></div>

Из параметров на которые следует обратить внимание, которые понадобяться для платформы это:

* Api токен
* Идентификатор&#x20;
* Домен

{% hint style="success" %}
Интеграция партнерки с Onebot
{% endhint %}

**Шаг 1. Создание партнерской сети**

Аналогично как в прошлом случае нажимаем “**Создать**” вводим название bigtraff

В параметрах для офферов указываем pid=1. Как итог параметр для офферов должен иметь такой вид&#x20;

`pid=1&sub1={subid}&sub2={mb_id}&sub3={user_id}` - это все что нужно для работы партнерки.

Далее настроим Postback настроенный постбек имеет такой вид:

`https://onebot.click/3935e9b/postback?subid={{ $subid }}&status=new&sub_id_10={{ id }}&sub_id_12={{ username }}&sub_id_11={{ name }}`

**Рассмотрим его подробнее:**

<https://onebot.click/>  - ваш домен кейтаро;&#x20;

subid={{ $subid }} - он же клик айди;

status=new - лид;

sub\_id\_10={{ id }} - айди в платформе;&#x20;

sub\_id\_12={{ username }} - никнейм в телеграме;&#x20;

\&sub\_id\_11={{ name }} - имя.

Настроенная партнерская сеть имеет такой вид:&#x20;

<div align="left"><figure><img src="/files/WTZY2Zwvywen11TtNvIP" alt=""><figcaption><p>Созданная партнерская сеть</p></figcaption></figure></div>

**Шаг 2. Настройка домена**

Это нужно только в случае если у вас большое количество байеров. Под каждый оффер покупается отдельный домен или же используют поддомены.&#x20;

Рассмотрим на примере создания под Cosmolot. Для этого на панели управления переходим на вкладку “**Домены**” и нажимаем кнопку “**Добавить**”. В нашей ситуации домен onebot.click не используется по этому добавим домен cosmo.onebot.click

В параметре “**Index страница**” выбираем Organic и устанавливаем пункт “**перенаправить на кампанию**”. 404 ошибка спасет от потери трафика в случае пустого алиаса. После чего нажимаем кнопку “**Сохранить**”

<div align="left"><figure><img src="/files/sFr3a2qFSZdmpbQz5jM7" alt=""><figcaption><p>Созданный домен</p></figcaption></figure></div>

Если будет оставлена органическая компания, то в случае удаления всех кампаний под Cosmolot, весь трафик сохраниться и будет идти на органику.

{% hint style="success" %}
Передача данных в Keitaro с Onebot
{% endhint %}

**Шаг 1. Настройка HTTP запроса**

Чтобы передать данные в Кейтаро, нужно в главном сценарии (или сценарии на который идет трафик). После блока “**Старт**” использовать блок “[HTTP-Запрос](https://help.onebot.tech/onebot-help/bloki-konstruktora/integracii/blok-http-zapros)”

В поле URL — Нужно вставить "Postback URL" с Кейтаро!

<figure><img src="/files/ssr1qo40Uv3o2Hmh0BaJ" alt=""><figcaption><p>HTTP запрос</p></figcaption></figure>

**Шаг 2. Проставить глобальную переменную**

В настройках бота в боковом меню (слева) выбираем "**Списки**" далее "**Глобальные переменные**". Задаем имя переменной "**url**" и вставляем ссылку с компании, чтобы в дальнейшем использовать её в настройках кнопки.

<figure><img src="/files/cuO3F0G7VPYUaA0aKdwz" alt=""><figcaption><p>Глобальная переменная</p></figcaption></figure>

**Шаг 3. Ссылка в кнопке**

Вот так примерно выглядит настройка ссылки в кнопке сообщения. Имя глобальной переменной проставляется в двойных кавычках {{ url }}. Там где {{ $alias }} – это ваш идентификатор с Кейтаро.&#x20;

user\_id={{ id }} позволяет синхронизировать пользователя с ботом, менять сценарий после прохождения пользователем целевых действий (регистрации, депозита, квалификации)

Остальное уже базовая разметка для Facebook рекламы, которая подтягивается с UTM меток. Можно подробнее ознакомиться в этой инструкции "[Настройка рекламы на конверсии в FB](/onebot-help/mini-lendingi/nastroika-reklamy-na-konversii-v-fb.md)"

<div align="left"><figure><img src="/files/SyCEEVGFyMDsHBavh6k8" alt="" width="375"><figcaption><p>Ссылка в кнопке</p></figcaption></figure></div>

Для копирования:

```
{{ url }}/{{ $alias }}?user_id={{ id }}&mes_id=1_1&utm_creative={{ $utm_creative }}&utm_campaign={{ $utm_campaign }}&utm_source={{ $utm_source }}&utm_placement={{ $utm_placement }}&campaign_id={{ $campaign_id }}&adset_id={{ $adset_id }}&ad_id={{ $ad_id }}&adset_name={{ $adset_name }}
```

**Шаг 4. Настройка мини лендинга (сайта)**

Нужно добавить домен в ваш мини лендинг (подписную на бота). Имеется ввиду обычный домен для сайта, не с Кейтаро.&#x20;

<figure><img src="/files/I9XYosErsGZjsD7kCei5" alt=""><figcaption><p>Мини лендинг (домен)</p></figcaption></figure>

Более подробно "[Создание мини-лендинга](/onebot-help/mini-lendingi/sozdanie-mini-lendinga.md)"

**Шаг 5. Добавить скрипт в подвал сайта**

Необходимо добавить его в подвал скриптов мини лендинга, чтобы он передавал данные определенного вебмастера и мог разделять трафик.

<figure><img src="/files/fZZkiOa3iyDk1yJlNQym" alt=""><figcaption><p>Скрипт</p></figcaption></figure>

Для копирования:

```
<script>
    land.ready(function () {
        var api = land.keitaro;
        api.pushAllParams();
        api.send();
        land.links.attachVariable('alias', 'ваш идентификатор');
    });
</script>
```

**Шаг 6. Интеграция с Кейтаро**

Заполнить поля “**API URL**” (домен с Кейтаро) и “**API Token**” (с Кейтаро). Плюс включить переключатель “**Отправлять аналитику с помощью JavaScript**” и нажать “**Сохранить**”

<figure><img src="/files/vqnf68ofwvUdAOQeAdkv" alt=""><figcaption><p>Интеграция с Keitaro</p></figcaption></figure>

{% hint style="warning" %}
Что в итоге у нас должно быть
{% endhint %}

**Бот**

1. Ссылка Postback (в партнерской сети) для [HTTP запроса](/onebot-help/bloki-konstruktora/integracii/blok-http-zapros.md);
2. Ссылка на оффер (домен в настройках кампании) для [глобальной переменной](/onebot-help/rabota-s-peremennymi/globalnye-peremennye.md);
3. В [кнопках сообщений](/onebot-help/bloki-konstruktora/prostye/otpravka-soobshenii/knopki-v-soobshenii.md) стоит такой формат:

<figure><img src="/files/yZrBr6YsLIABGVQqEPme" alt=""><figcaption><p>Скопировать можно в пунктах выше</p></figcaption></figure>

Дополнительно инструкция "[Настройка рекламы на конверсии в FB](/onebot-help/mini-lendingi/nastroika-reklamy-na-konversii-v-fb.md)" для корректной разметки UTM, чтобы в итоге все прокинулось в Кейтаро и была сквозная аналитика!

**Мин лендинг (подписная на бота)**

1. [Домен](/onebot-help/mini-lendingi/tekhnicheskie-nastroiki-mini-lendinga.md) для мини лендинга (подписной на бота);
2. Идентификатор (в настройках кампании) для скрипта в подвал;
3. Кейтаро API url и API token для интеграции
4. Дополнительно [Код GTM или Pixel Facebook](/onebot-help/mini-lendingi/nastroika-konversii-v-fb-pixel-na-mini-lendingakh.md) для оптимизации вашей рекламы в FB

{% hint style="info" %}
Если будут дополнительные вопросы, пишите <https://t.me/onebot_supportbot>
{% endhint %}