# Интеграция 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.onebot.tech/onebot-help/integracii/integraciya-keitaro-s-onebot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.