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

Как настроить на глубокие цели

Глубокие цели — это важные действия пользователей в боте, которые можно отслеживать и передавать в Яндекс/ФБ/Гугл/ВК для оптимизации рекламы. Например: пользователь оставил номер телефона, прошел тест, зарегистрировался на вебинар, совершил покупку.

Как это работает​

В конструкторах ботов (SaleBot, BotHelp и др.) для передачи глубоких целей обычно используется шаг "Внешний запрос" или "API-запрос". В этом шаге прописывается отправка запроса с двумя полями: ID пользователя (user_id) и идентификатор цели (target).

Что происходит дальше:

  1. Вы отправляете запрос с ID пользователя (user_id) и идентификатором цели (target)
  2. Наш сервис автоматически определяет, откуда пришел этот пользователь (из Яндекс.Директ, VK, Facebook/Instagram или Google)
  3. Если пользователь пришел из Яндекс.Директ, цель, которую вы указали в запросе, прокидывается в Яндекс.Метрику
  4. Если из VK — в VK Рекламу, и так далее
подсказка

Цель можно передавать в течение 21 дня с момента подписки пользователя на канал или старта вашего бота.

Шаг 1 — Определите, где в вашем боте происходит целевое действие​

Выберите момент в воронке вашего бота, когда пользователь совершает важное действие, которое вы хотите отслеживать. Например:

  • Пользователь оставил номер телефона
  • Пользователь прошел тест или опрос
  • Пользователь зарегистрировался на вебинар
  • Пользователь совершил покупку
  • Пользователь посмотрел ключевое видео

Шаг 2 — Настройте отправку запроса​

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

  • SaleBot: "API-запрос"
  • BotHelp: "Внешний запрос"
  • Botmen: "Вебхук" или "HTTP-запрос"
  • PuzzleBot: "Внешний запрос"
  • Другие платформы: ищите действия типа "Webhook", "HTTP Request", "API Request" или "Внешний запрос"
примечание

Где искать: Обычно такие действия находятся в разделе "Действия", "Интеграции" или "API" в конструкторе воронки. Если не можете найти, проверьте подробную инструкцию для вашей платформы ниже — там есть скриншоты с примерами.

URL для запроса:​

https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/send_reach_goal
подсказка

Замените API_КЛЮЧ в ссылке на ваш собственный API ключ, полученный от бота «Откуда Подписки» на 📘 шаге 1.

Метод HTTP-запроса: POST

Заголовки запроса:

  • Content-Type: application/json

Тело запроса (JSON) — два обязательных поля:​

НазваниеТипОписание
user_idstringID пользователя в телеграм, с которым связано событие. В конструкторах обычно используется переменная платформы (например, #{platform_id} в SaleBot или {%user_id%} в BotHelp)
targetstringИдентификатор вашей глубокой цели. Это название события, которое будет передано в рекламную систему. Например: "userDidSharePhone", "testCompleted", "webinarRegistered"

Пример запроса:

{
  "user_id": "987654321",
  "target": "userDidSharePhone"
}
примечание

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

  • В SaleBot: "user_id": "#{platform_id}"
  • В BotHelp: "user_id": "{%user_id%}"
  • В других платформах проверьте документацию, какая переменная используется для ID пользователя

Шаг 3 — Создайте цель в рекламной системе​

После настройки передачи глубоких целей из бота, необходимо создать соответствующую цель в вашей рекламной системе:

  • Яндекс.Метрика: Создайте цель с идентификатором, который совпадает со значением target в вашем запросе. Например, если вы отправляете "target": "userDidSharePhone", создайте цель с идентификатором userDidSharePhone в Метрике. Это обязательно нужно сделать, чтобы цель передавалась корректно.
  • VK Реклама: Аналогично создайте цели с соответствующими идентификаторами.
подсказка

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

Шаг 4 — Проверка работоспособности интеграции​

Для проверки работоспособности интеграции используйте нашу 🔗 страницу проверки.

  1. Перейдите по ссылке: https://bot-api.tgtrack.ru/last_events/
  2. Введите ваш API ключ (который получили на 📘 шаге 1)
  3. Проверьте последние 100 запросов
  4. Убедитесь, что ваш бот успешно передаёт события глубоких целей, а сервис "Откуда Подписки" принимает их без ошибок. Статус обработки событий должен быть 0.

Как проверить:

  • Совершите целевое действие в вашем боте (например, оставьте номер телефона или пройдите тест)
  • Подождите несколько секунд
  • Обновите страницу проверки и найдите ваше событие в списке
  • Убедитесь, что событие имеет статус 0 (успешная обработка)

Типичные ошибки и их решение​

Ошибка: Событие не появляется на странице проверки​

Возможные причины:

  • Неправильно указан API ключ в URL — проверьте, что вы заменили API_КЛЮЧ на ваш реальный ключ
  • Запрос не отправляется из бота — проверьте, что действие добавлено в правильное место воронки и срабатывает
  • Неправильный метод запроса — убедитесь, что используется метод POST, а не GET

Решение: Проверьте настройки запроса в конструкторе бота, убедитесь, что URL и метод указаны правильно.

Ошибка: Статус обработки не 0​

Возможные причины:

  • Неправильный формат JSON — проверьте, что в теле запроса корректный JSON с кавычками
  • Отсутствует обязательное поле — убедитесь, что указаны оба поля: user_id и target
  • Неправильная переменная для user_id — используйте переменную платформы (например, #{platform_id} в SaleBot)

Решение: Проверьте формат JSON в теле запроса, убедитесь, что используются правильные переменные платформы.

Ошибка: Цель не передается в рекламную систему​

Возможные причины:

  • Цель не создана в рекламной системе — обязательно создайте цель с идентификатором, совпадающим со значением target
  • Не подключена интеграция с рекламной системой — убедитесь, что вы выполнили подключение к Яндекс.Директ, VK, Facebook/Instagram или Google
  • Идентификатор цели не совпадает — проверьте, что target в запросе точно совпадает с идентификатором цели в Метрике

Решение: Создайте цель в рекламной системе с идентификатором, который совпадает со значением target в вашем запросе, и убедитесь, что интеграция с рекламной системой настроена.

Ошибка: Переменная user_id не подставляется​

Возможные причины:

  • Неправильный синтаксис переменной — каждая платформа использует свой формат (например, #{platform_id} в SaleBot, {%user_id%} в BotHelp, {{user_id}} в Botmen)
  • Переменная не поддерживается платформой — проверьте документацию вашей платформы

Решение: Используйте правильный синтаксис переменной для вашей платформы. См. примеры выше в разделе "Примеры для разных платформ".

Примеры для разных платформ​

SaleBot​

  1. В конструкторе воронки выберите нужный шаг, где требуется передать данные
  2. Добавьте действие "API-запрос"
  3. Укажите URL: https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/send_reach_goal
  4. В поле JSON укажите:
{
  "user_id": "#{platform_id}",
  "target": "testResult"
}

Подробная инструкция: Как подключить SaleBot

BotHelp​

  1. В нужном месте воронки добавьте шаг
  2. Выберите действие "Внешний запрос"
  3. Укажите URL: https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/send_reach_goal
  4. В поле для тела запроса добавьте:
{
  "user_id": "{%user_id%}",
  "target": "testResult"
}

Подробная инструкция: Как подключить BotHelp

Botmen​

  1. В конструкторе воронок найдите блок, в котором совершается целевое действие
  2. После этого действия добавьте новый шаг "Вебхук" или "HTTP-запрос"
  3. В настройках укажите:
    • Метод запроса: POST
    • URL: https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/send_reach_goal
  4. В поле для тела запроса (Body) укажите:
{
  "user_id": "{{user_id}}",
  "target": "webinar_reg"
}

Подробная инструкция: Как подключить Botmen

PuzzleBot​

  1. В воронке бота создайте блок с внешним запросом на том шаге, где нужно передать данные
  2. Укажите URL: https://bot-api.tgtrack.ru/v1/API_КЛЮЧ/send_reach_goal
  3. В теле запроса укажите JSON с полями user_id и target

Подробная инструкция: Как подключить PuzzleBot

Самописный бот​

Если вы разрабатываете собственного бота, отправьте HTTP POST-запрос к нашему API в момент, когда пользователь совершает целевое действие.

Подробная инструкция: Как подключить самописного бота

подсказка

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