Перейти к содержанию

FAQ — Часто задаваемые вопросы

Ответы на частые вопросы о BotSafe. Если вы не нашли ответ на свой вопрос, обратитесь в поддержку.

🚀 Начало работы

Как начать использовать BotSafe?
  1. Зарегистрируйте сайт в Telegram-боте BotSafe
  2. Получите код интеграции
  3. Вставьте код в <head> вашего сайта
  4. Готово! Система начнёт собирать данные

Подробнее читайте в разделе Быстрый старт.

Сколько времени занимает установка?

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

Первые данные

Первые параметры визита обычно появляются в Яндекс.Метрике в течение 5-10 минут после установки кода.

Нужно ли что-то настраивать после установки?

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

Рекомендация

Рекомендуется начать с настроек по умолчанию, понаблюдать за результатами в течение нескольких дней, а затем скорректировать при необходимости.

💻 Технические вопросы

Где нужно установить код?

Код нужно вставить в <head> вашего сайта, перед закрывающим тегом </head>. Подробные инструкции для разных платформ читайте в разделе Установка кода.

Важно

Код должен быть в <head>, а не в <body>. Если код вставлен в неправильное место, он может работать некорректно.

Код не работает. Что делать?

Шаг 1: Проверьте расположение кода

Убедитесь, что код вставлен в <head>, а не в <body>.

Шаг 2: Проверьте целостность кода

Проверьте, что код не повреждён при копировании. Убедитесь, что код скопирован полностью.

Шаг 3: Проверьте консоль браузера

  • Откройте консоль браузера (F12 или Ctrl+Shift+I)
  • Перейдите на вкладку "Console"
  • Проверьте на наличие ошибок, связанных с BotSafe

Шаг 4: Проверьте сетевые запросы

  • Откройте вкладку "Network" в консоли браузера
  • Обновите страницу
  • Проверьте, есть ли запросы к botsafe.ru или track.botsafe.ru

Если ничего не помогает, обратитесь в поддержку.

Параметры не появляются в Яндекс.Метрике

Шаг 1: Проверьте номер счётчика

Убедитесь, что номер счётчика Яндекс.Метрики указан правильно при регистрации сайта в Telegram-боте.

Шаг 2: Подождите

Подождите несколько минут — данные могут появиться с задержкой (обычно 5-10 минут).

Шаг 3: Проверьте счётчик

Проверьте, что счётчик Яндекс.Метрики установлен и работает на сайте.

Шаг 4: Проверьте консоль

Проверьте консоль браузера на наличие ошибок.

Проверка работы

Откройте консоль браузера (F12) и проверьте, есть ли запросы к BotSafe. Если запросов нет, код может быть установлен неправильно.

Влияет ли BotSafe на скорость загрузки сайта?

BotSafe оптимизирован для минимального влияния на скорость загрузки:

  • Код загружается асинхронно
  • Не блокирует загрузку страницы
  • Проверки выполняются в фоновом режиме
  • Влияние на скорость практически незаметно

Производительность

Влияние BotSafe на скорость загрузки страницы обычно составляет менее 100ms, что практически незаметно для пользователей.

⚙️ Настройки

Какие настройки нужно изменить?

Для большинства сайтов настройки по умолчанию работают хорошо. Рекомендуется:

  1. Начать с настроек по умолчанию
  2. Понаблюдать за результатами в течение нескольких дней
  3. При необходимости скорректировать порог уверенности

Подробнее читайте в разделе Примеры использования.

Как выбрать порог уверенности?

Мягкая фильтрация (0.3-0.4): - Меньше ложных срабатываний - Может пропускать некоторых ботов - Подходит для сайтов с низким риском ботов

Сбалансированное значение (0.5): - Хороший баланс между точностью и ложными срабатываниями - Подходит для большинства сайтов - Рекомендуется по умолчанию

Строгая фильтрация (0.6-0.7): - Выявляет больше ботов - Может быть больше ложных срабатываний - Подходит для сайтов с высоким риском ботов

Начните с 0.5 и корректируйте при необходимости. Подробнее читайте в разделе Основные параметры.

Нужно ли включать все проверки?

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

Рекомендация

Включите все основные проверки, но отключите те, которые дают много ложных срабатываний для вашего проекта.

📊 Работа с данными

Как посмотреть статистику?

Статистику можно посмотреть:

  1. В Telegram-боте BotSafe:
  2. Выберите сайт
  3. Нажмите "📊 Статистика"

  4. Просмотрите данные о визитах и ботах

  5. В Яндекс.Метрике:

  6. Используйте сегменты для анализа
  7. Фильтруйте отчёты по сегментам
  8. Анализируйте параметры визита
Как создать сегменты в Яндекс.Метрике?
  1. Откройте Яндекс.Метрику
  2. Перейдите в раздел "Сегменты"
  3. Создайте сегмент с условием (например, bs_bot_detected = 1 для ботов)

Подробнее читайте в разделе Создание сегментов.

Какие параметры передаются в Яндекс.Метрику?

Полный список параметров читайте в разделе Параметры визита. Основные параметры:

  • bs_bot_detected — обнаружен ли бот (0 или 1)
  • bs_bot_confidence — уверенность в детекции (0.0 до 1.0)
  • bs_bot_reasons — причины детекции
Почему данные по количеству визитов BotSafe отличаются от данных Яндекс.Метрики, Google Analytics и других систем?

Расхождения в данных между BotSafe и другими системами аналитики — это нормальное явление, которое объясняется несколькими причинами:

1. Разные методы подсчета:

  • BotSafe считает запросы (каждый визит на сайт)
  • Яндекс.Метрика считает визиты (сессии пользователей)
  • Google Analytics считает сессии и пользователей
  • Разные системы могут по-разному определять начало и конец визита

2. Фильтрация коротких визитов:

  • BotSafe не обрабатывает визиты длительностью менее 5 секунд
  • Такие визиты не входят в тарификацию и не передаются в Яндекс.Метрику
  • Другие системы могут считать все визиты, включая очень короткие

3. Различия в определении ботов:

  • BotSafe использует более строгие критерии для определения ботов
  • Некоторые визиты, которые BotSafe считает ботами, могут учитываться в других системах как обычные визиты
  • Это особенно заметно, если в BotSafe включена блокировка отправки данных для ботов

4. Временные задержки синхронизации:

  • Данные в BotSafe обрабатываются в реальном времени
  • Данные в Яндекс.Метрике могут появляться с задержкой (обычно 5-10 минут)
  • Google Analytics также имеет задержку в обработке данных

5. Различия в обработке данных:

  • BotSafe обрабатывает данные на серверах в России
  • Яндекс.Метрика обрабатывает данные на своих серверах
  • Google Analytics обрабатывает данные на серверах Google
  • Разные алгоритмы обработки могут давать разные результаты

6. Технические различия:

  • BotSafe использует JavaScript для сбора данных в браузере
  • Разные системы могут использовать разные методы сбора данных
  • Блокировщики рекламы могут блокировать некоторые системы аналитики

Рекомендации:

  • Используйте данные BotSafe для анализа качества трафика и детекции ботов
  • Используйте данные Яндекс.Метрики для общего анализа трафика
  • Не сравнивайте абсолютные числа напрямую — сравнивайте тренды и относительные показатели
  • Обращайте внимание на долю ботов в трафике, а не на абсолютные числа

💰 Оптимизация рекламы

Как использовать данные для корректировки ставок?
  1. Создайте сегменты в Яндекс.Метрике
  2. Используйте сегменты для корректировки ставок в Яндекс.Директе
  3. Снижайте ставки для ботов, повышайте для реальных пользователей

Подробнее читайте в разделе Корректировка ставок в Яндекс.Директе.

Нужно ли блокировать отправку данных в Яндекс.Метрику для ботов?

Это зависит от ваших целей:

  • Блокировать, если боты искажают статистику или влияют на автоматические стратегии
  • Не блокировать, если хотите анализировать ботов отдельно через сегменты

Подробнее читайте в разделе Деактивация Яндекс.Метрики для ботов.

❓ Проблемы и решения

Много ложных срабатываний

Если реальные пользователи помечаются как боты:

Смягчите фильтрацию:

  • Уменьшите порог уверенности до 0.4-0.5
  • Отключите проверки, которые дают много ложных срабатываний (VPN, инкогнито, cookies)
  • Увеличьте лимиты (7-10)

Проверьте конкретные проверки:

  • Если много пользователей с VPN — отключите проверку VPN из России
  • Если много пользователей в инкогнито — отключите проверку инкогнито
  • Если много пользователей с отключенными cookies — отключите эту проверку

Подробнее читайте в разделе Типичные сценарии.

Система пропускает ботов

Если система не выявляет ботов:

Ужесточите фильтрацию:

  • Увеличьте порог уверенности до 0.6-0.7
  • Включите все проверки
  • Уменьшите лимиты (3-5)

Проверьте настройки:

  • Убедитесь, что все основные проверки включены
  • Проверьте, что анализ поведения включен
  • Убедитесь, что BotD включен
Высокая доля ботов в трафике

Если боты составляют большую долю трафика:

Ужесточите фильтрацию:

  • Увеличьте порог уверенности
  • Включите все проверки
  • Уменьшите лимиты

Включите блокировку:

  • Включите блокировку отправки данных в Яндекс.Метрику для ботов
  • Это поможет получить чистую статистику

Проанализируйте источники:

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

🔒 Безопасность и приватность

Безопасны ли данные?

Да, BotSafe собирает только технические данные, необходимые для детекции ботов:

  • Свойства браузера
  • Поведение пользователя
  • IP-адрес (для проверки по базам данных)
  • И другие технические параметры

Персональные данные (имя, email, телефон и т.д.) не собираются и не хранятся.

Где хранятся данные?

Данные хранятся на серверах в России в соответствии с требованиями законодательства. Все данные обрабатываются в соответствии с политикой конфиденциальности.

Влияет ли BotSafe на приватность пользователей?

BotSafe собирает только технические данные для детекции ботов. Это стандартная практика для веб-аналитики и не нарушает приватность пользователей.

Соответствие требованиям

BotSafe соответствует требованиям законодательства о защите персональных данных и не собирает персональную информацию пользователей.

💳 Тарификация и оплата

Как работает тарификация?

BotSafe использует тарифную систему с лимитами на количество запросов (визитов) в месяц. Подробнее читайте в разделе Тарификация и оплата.

Как оплатить тариф?

Оплата производится через Telegram-бота с использованием платёжной системы ЮKassa. Подробнее читайте в разделе Тарификация и оплата.

Что такое 'запрос' в контексте тарификации?

Один запрос = один визит на сайт. Каждый раз, когда посетитель заходит на ваш сайт, это считается одним запросом. Подробнее читайте в разделе Тарификация и оплата.

📞 Поддержка

Как связаться с поддержкой?
  • Напишите в Telegram-бота BotSafe
  • Напишите в Telegram: @AlAblex open_in_new
Где найти дополнительную информацию?
  • Изучите разделы справки в этой документации
  • Проверьте раздел FAQ (этот раздел)
  • Обратитесь в поддержку через Telegram-бота

📚 Дополнительная информация