> 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

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

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

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

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FozQIY3hprqc9Z4GwZNde%2F1.png?alt=media&amp;token=0defa260-43fa-4fd8-8cea-ff547c70e1ae" alt=""><figcaption><p>Подготовленный для работы Keitaro</p></figcaption></figure></div>

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

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2Ff2IDIOOZpDTbW7YoiGE6%2F2.png?alt=media&amp;token=e2ad32e1-fa05-4ea9-b97f-294cbf24d842" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FrU0u5hql2Gcb89CuBQQd%2F3.png?alt=media&amp;token=ccb446fb-b30f-4ec8-a511-b042639a39ab" alt=""><figcaption><p>Настроенные метки в источнике</p></figcaption></figure></div>

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

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

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FVHC4R8XOt3G5aan5BrqG%2F4.png?alt=media&amp;token=18cb8b73-d26e-4e41-8d36-552253066b88" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FcVBZVWvzY7foCuM0pG7b%2F5.png?alt=media&amp;token=dbe0353b-735d-43f8-8d5e-987350112104" alt=""><figcaption><p>Настроенный оффер</p></figcaption></figure></div>

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

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

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

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

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

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FuMm1YSQhy4ZB49U0Ts1l%2F6.png?alt=media&amp;token=37e5f838-56ef-4658-b1d8-9a4c99780862" alt=""><figcaption><p>Настройка основных параметров первого потока</p></figcaption></figure></div>

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FLAB0ADdhCpqYqh8uNgd0%2F7.png?alt=media&amp;token=41378266-194e-4df2-90bf-cb5ca5d54827" alt=""><figcaption><p>Настройка фильтров первого потока</p></figcaption></figure></div>

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FPFFlvfkSYkyUCM9tr0a8%2F8.png?alt=media&amp;token=394ceee9-15c8-44e2-9220-0851c49388ab" alt=""><figcaption><p>Настройка схем первого потока</p></figcaption></figure></div>

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FQ5Ee8F0Nr0SRp2aq5dfc%2F9.png?alt=media&amp;token=96eed90d-5c6e-4c53-ab05-5346d25c7d98" alt=""><figcaption></figcaption></figure></div>

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

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FHn3zHA5Q5KDEIEXzQtx7%2F10.png?alt=media&amp;token=cb5a4169-2fa0-412e-a7eb-18e711f8d783" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FMVrf0nw2ikKm0GRUmwx5%2F11.png?alt=media&amp;token=1f524b80-4033-4f7c-ba33-811db4db9f96" alt=""><figcaption><p>Созданная партнерская сеть</p></figcaption></figure></div>

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

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

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

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

<div align="left"><figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FIohhnlNElMWAIJ4M9irk%2F12.png?alt=media&amp;token=81e35669-65c5-4287-9e01-8fa9dcd68ab4" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FdmvtpyPFPLgGYCGAtslf%2Fimage.png?alt=media&amp;token=8b1961d9-9e04-4e19-b446-b378ce355b53" alt=""><figcaption><p>HTTP запрос</p></figcaption></figure>

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

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

<figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FMIaXYrsYEv4iUBLchNJI%2Fimage.png?alt=media&amp;token=ff36bc54-1da4-4c78-ba95-8f87e1e2a200" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FPdSxVPFMFw3HrHuHKiG3%2Fimage.png?alt=media&amp;token=dadc6560-6897-4dea-a2be-00cef2f86667" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FhzrVg5NSEOca6xY5VDZ4%2Fimage.png?alt=media&amp;token=5e6fa00f-c5d7-45d9-867a-391d50023258" alt=""><figcaption><p>Мини лендинг (домен)</p></figcaption></figure>

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

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

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

<figure><img src="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FFv0dY8thrce4SBicrk9Y%2Fimage.png?alt=media&amp;token=a01990ad-dced-4413-87c9-a9ff4b89f75c" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2FRk9u2EHlCfqJfVpi0EA6%2Fimage.png?alt=media&amp;token=7070f9fb-ad00-476d-a921-606c8662f8d5" 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="https://49415206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxxJzgLIMfD15nVewbHNz%2Fuploads%2F68gqVErbDsETwF62HRPv%2Fimage.png?alt=media&amp;token=1062eac6-a706-43b5-bdc7-c6c3b04a435d" 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 %}