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

Этот документ предназначен для ознакомления с интеграцией Keitaro с Onebot

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

С чего начать?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Дополнительно так же можно рассмотреть - FAQ от Keitaro по созданию Партнерской сети в трекере.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Api токен
Идентификатор
Домен

Интеграция партнерки с Onebot

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

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

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

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/ - ваш домен кейтаро;

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

status=new - лид;

sub_id_10={{ id }} - айди в платформе;

sub_id_12={{ username }} - никнейм в телеграме;

&sub_id_11={{ name }} - имя.

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

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

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

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

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

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

Передача данных в Keitaro с Onebot

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

Чтобы передать данные в Кейтаро, нужно в главном сценарии (или сценарии на который идет трафик). После блока “Старт” использовать блок “HTTP-Запрос”

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

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

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

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

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

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

Остальное уже базовая разметка для Facebook рекламы, которая подтягивается с UTM меток. Можно подробнее ознакомиться в этой инструкции "Настройка рекламы на конверсии в FB"

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

{{ 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. Настройка мини лендинга (сайта)

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

Более подробно "Создание мини-лендинга"

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

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

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

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

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

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

Что в итоге у нас должно быть

Бот

Ссылка Postback (в партнерской сети) для HTTP запроса;
Ссылка на оффер (домен в настройках кампании) для глобальной переменной;
В кнопках сообщений стоит такой формат:

Дополнительно инструкция "Настройка рекламы на конверсии в FB" для корректной разметки UTM, чтобы в итоге все прокинулось в Кейтаро и была сквозная аналитика!

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