Перейти к основному содержимому

Как подключить Senler и передавать старт бота, глубокие цели в Яндекс/ФБ/Гугл/ВК

Как подключить Senler​

Senler поддерживает интеграцию с Откуда Подписки для передачи стартов бота в рекламные системы и оптимизации рекламы.

Доступный функционал:

  • Передача активаций (стартов) бота в Яндекс/ФБ/Гугл/ВК
  • Оптимизация рекламных кампаний на старты бота
  • Проверка доставки событий через страницу последних запросов

Для передачи стартов бота выполните шаги ниже.

Для того чтобы передавать старты бота или глубокие цели в рекламные системы (Яндекс, Facebook/Instagram, Google, VK), необходимо выполнить несколько ключевых шагов:

  1. Настроить передачу данных по API из Senler в наш сервис. Это позволит фиксировать каждый старт бота и достижение глубоких целей.
  2. Подключить лендинг, с которого вы ведете трафик в вашего бота. Для этого нужно получить от бота специальный скрипт и установить его на ваш лендинг.

Подробные инструкции по подключению рекламных систем доступны здесь:

Следуйте по шагам настройки подключения:​

Шаг 1 - Откройте WebHook API в Senler​

  1. Для интеграции необходимо получить API ключ. Как получить API ключ тут
  2. В рабочем пространстве проекта откройте Настройки канала.
  3. Перейдите в раздел WebHook API. Senler: Настройки кан�ала → вкладка WebHook API
  4. Создайте Новый шаблон. Senler: кнопка «+ Новый шаблон» в разделе WebHook API

Шаг 2 - Создайте и сохраните переменную start_value в конструкторе​

Чтобы передавать старт-параметр, в конструкторе чат-бота от блока Старт:

  1. Добавьте действие Ответ на сообщение.

  2. В этом действии выберите Сохранить ответ.

  3. Нажмите Создать новую переменную.

  4. Введите имя start_value и нажмите Добавить.

Это действие должно отработать сразу после старта — до блока Вызвать URL.

Шаг 3 - Заполните тело запроса из 5 параметров​

Добавьте в шаблон 5 параметров:

  1. user_id

    • Тип: Данные подписчика
    • Имя: user_id
    • Значение: Идентификатор пользователя Telegram

  2. first_name

    • Тип: Данные подписчика
    • Имя: first_name
    • Значение: Имя

  3. last_name

    • Тип: Данные подписчика
    • Имя: last_name
    • Значение: Фамилия

  4. username

    • Тип: Данные подписчика
    • Имя: username
    • Значение: Пользователь в Telegram (username)
предупреждение

Предварительно для добавления 5-го параметра выполните шаг 2 — «Создайте и сохраните переменную start_value в конструкторе». Без этого тип «Пользовательская переменная» в шаблоне выбрать не получится.

  1. start_value
    • Тип: Пользовательская переменная
    • Имя: start_value
    • Значение: start_value
подсказка

Не забудьте задать понятное название шаблону (например, Передача в Откуда Подписки), чтобы затем выбрать его в действии Вызвать URL.

Шаг 4 - Настройте отправку через «Вызвать URL» для Senler бота​

  1. От блока Старт проведите стрелку и создайте действие Вызвать URL.
  2. На стрелке от Старт к Вызвать URL выставьте таймер от 30 сек — блок Вызвать URL должен отработать после получения нами события старта и сохранения переменной start_value (шаг 2).
  3. Укажите URL:
https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/user_did_start_bot
  1. Замените API_КЛЮЧ на ваш API-ключ.
  2. В поле Выберите шаблон выберите Передача в Откуда Подписки (или созданный ранее шаблон).
  3. Тип запроса выберите POST_JSON.
  4. Нажмите Сохранить.

Шаг 5 - Выполните тестовый запрос и проверьте порядок шагов​

  1. В действии Вызвать URL нажмите Тестовый запрос.
  2. Ожидаемый результат - успешный ответ (200 OK).
  3. Проверьте порядок действий в сценарии:
    • Сохранить ответ: start_value,
    • Вызвать URL: Передача в Откуда Подписки (от Старт по стрелке с таймером от 30 сек),
    • от Вызвать URL — блок Обновить поля пользователя (если настраиваете UTM через get_user_info),
    • далее ваши шаги сценария.

Шаг 6 - Получите UTM-метки через get_user_info​

После настройки отправки старта через Вызвать URL можно запросить UTM-метки подписчика через метод get_user_info. Подробнее о методе — в общей инструкции по получению UTM-меток.

  1. Далее от блока Вызвать URL (отправка старта) проведите стрелку и создайте блок Обновить поля пользователя.
  2. Внутри блока укажите адрес:
https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/get_user_info

Замените API_КЛЮЧ на API-ключ, полученный в Откуда Подписки. 3. Метод запроса: POST. Тип ответа: JSON. 4. В теле запроса укажите объект:

{
   "user_id": event.chat.originId
}

event.chat.originId — идентификатор пользователя Telegram в контексте Senler. 5. Включите Сохранить ответ в переменную объекта с типом user. 6. Включите Преобразовать объекты воронки из результата. 7. В поле преобразования вставьте код:

if (
  response?.statusCode === 200 &&
  response?.body?.status === "OK" &&
  response?.body?.data
) {
  user.gc_system_user_utm_source = response.body.data.utm_source ?? "";
  user.gc_system_user_utm_medium = response.body.data.utm_medium ?? "";
  user.gc_system_user_utm_campaign = response.body.data.utm_campaign ?? "";
  user.gc_system_user_utm_term = response.body.data.utm_term ?? "";
  user.gc_system_user_utm_content = response.body.data.utm_content ?? "";
} else {
  user.gc_system_user_utm_source = "";
  user.gc_system_user_utm_medium = "";
  user.gc_system_user_utm_campaign = "";
  user.gc_system_user_utm_term = "";
  user.gc_system_user_utm_content = "";
}
  1. Нажмите Применить.
  2. В блоке Обновить поля пользователя выберите Добавить дополнительное поле. Добавьте 6 дополнительных полей; для каждого поля укажите одно и то же значение в полях «Имя» и «Значение»:
  • user.gc_system_user_utm_source
  • user.gc_system_user_utm_medium
  • user.gc_system_user_utm_campaign
  • user.gc_system_user_utm_term
  • user.gc_system_user_utm_content
  • user.requestResult
  1. Нажмите Сохранить.

После выполнения блока Обновить поля пользователя UTM-метки будут доступны в переменных объекта пользователя (gc_system_user_utm_source, gc_system_user_utm_medium и т. д.).

Как настроить передачу для глубоких целей​

Глубокие цели передаются через отдельный шаблон WebHook API на каждую цель и действие «Вебхук» с методом send_reach_goal — не через шаблон старта бота «Передача в Откуда Подписки».

Шаг 1 - Создайте новый шаблон WebHook API​

  1. Откройте раздел WebHook API.
  2. Нажмите + Новый шаблон.
Senler: список шаблонов WebHook API и кнопка «+ Новый шаблон»

Шаг 2 - Назовите шаблон строго по цели​

  1. В поле Название укажите имя строго по цели, например Оставил телефон.
  2. Сколько целей — столько шаблонов: на каждую цель создайте отдельный шаблон.
Senler: поле «Название» шаблона WebHook API — «Оставил телефон»

Шаг 3 - Добавьте параметр user_id​

Создайте тело запроса. Первый параметр:

  • Тип: Данные подписчика
  • Имя: user_id
  • Значение: Идентификатор пользователя Telegram
Senler: параметр user_id в шаблоне «Оставил телефон» — тип «Данные подписчика», значение «Идентификатор пользователя Telegram»

Шаг 4 - Добавьте параметр target и сохраните шаблон​

Второй параметр:

  • Тип: Константа
  • Имя: target
  • Значение: ваш идентификатор цели — тот же, который вы установите в Яндекс.Метрике, например userDidSharePhone

Нажмите Сохранить.

подсказка

Идентификатор в шаблоне (target) должен совпадать с идентификатором цели в Метрике и рекламной системе.

Senler: параметр target в шаблоне «Оставил телефон» — тип «Константа», значение userDidSharePhone

Шаг 5 - В конструкторе протяните стрелку к действию «Вебхук»​

В конструкторе чат-бота после целевого действия и сохранения ответа в переменной протяните стрелку к действию Вебхук.

Пример: сообщение «Введите ваш номер телефона» → сохранение ответа в phone_number → действие Вебхук «Передача цели» (шаблон Оставил телефон, URL send_reach_goal) → «Спасибо, мы перезвоним».

Senler: конструктор — после сохранения ответа в phone_number стрелка к действию Вебхук «Передача цели»

Шаг 6 - Укажите URL send_reach_goal, шаблон и POST_JSON​

  1. В настройках укажите URL:
https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/send_reach_goal
  1. Вставьте вместо API_КЛЮЧ ваш API-ключ, полученный в боте Откуда Подписки.
  2. Выберите ранее созданный шаблон (например Оставил телефон).
  3. Метод запроса выберите POST_JSON.
  4. Нажмите Сохранить.
  5. Нажмите Тестовый запрос.
Senler: настройки действия Вебхук «Передача цели» — URL send_reach_goal, шаблон «Оставил телефон», метод POST_JSON

Шаг 7 - Проверьте событие в чекере last_events​

Откройте страницу последних запросов. В списке должно появиться событие send_reach_goal с телом вида {"target":"userDidSharePhone","user_id":...}.

Страница последних запросов: событие send_reach_goal с JSON target userDidSharePhone и user_id

Проверка подключения​

Проверить события: https://bot-api.tgtrack.ru/last_events/

  1. Укажите API ключ, который получили в Откуда Подписки.
  2. Проверьте последние 100 запросов.
  3. Убедитесь, что события от Senler поступают без ошибок.

В списке будут и send_reach_goal (глубокая цель), и user_did_start_bot (старт бота).

Страница последних запросов: успешный send_reach_goal — метод send_reach_goal и JSON с target (userDidSharePhone) и user_id

Особенности​

  • В URL действия Вызвать URL всегда подставляйте актуальный API ключ вашего бота.
  • Для корректной передачи старт-параметра обязательно сначала сохраняйте start_value, а уже потом отправляйте запрос через Вызвать URL. Задержка от 30 сек на стрелке от Старт к Вызвать URL как раз обеспечивает этот порядок.