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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. user_id

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

  2. first_name

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

  3. last_name

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

  4. username

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

  5. start_value

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

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

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

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

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

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

  1. Создайте новую пользовательскую переменную start_value.
  2. Выберите действие Добавить.

Это действие понадобится в цепочке перед отправкой вебхука.

Шаг 4 - Настройте отправку вебхук для Senler бота​

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

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

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

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

Для проверки работоспособности интеграции используйте страницу проверки: https://bot-api.tgtrack.ru/last_events/

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

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

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