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

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

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

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

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

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

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

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

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

• Яндекс Директ: Инструкция
• VK Реклама: Инструкция
• Facebook / Instagram: Инструкция
• Google: Инструкция

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

Шаг 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. Добавьте действие Ответ на сообщение.

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

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

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

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

1. В конструкторе создайте действие Вебхук.
2. Укажите URL:

https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/user_did_start_bot

3. Замените API_КЛЮЧ на API ключ, полученный в Откуда Подписки.
4. В категории шаблон выберите созданный ранее шаблон.
5. Тип запроса выберите POST_JSON.
6. Нажмите Сохранить.

Шаг 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, а уже потом отправляйте вебхук.