Параметры визита BotSafe¶

Полный список параметров визита, которые BotSafe передаёт в Яндекс.Метрику для анализа трафика и создания сегментов. Все параметры имеют префикс bs_ (BotSafe).

Почему BotSafe — лучшая система?

BotSafe передаёт в Яндекс.Метрику более 50 различных параметров, что обеспечивает максимально детальную аналитику. В отличие от конкурентов, которые передают только базовую информацию о ботах, BotSafe предоставляет детальные данные о причинах детекции, уверенности, поведении и других параметрах, что позволяет создавать точные сегменты и эффективно оптимизировать рекламу.

Что такое параметры визита

Параметры визита — это дополнительные данные, которые передаются в Яндекс.Метрику вместе с информацией о визите. Они позволяют создавать сегменты и анализировать трафик более детально.

📋 Общая информация¶

Использование параметров¶

Параметры можно использовать для:

Создания сегментов в Яндекс.Метрике
Анализа качества трафика
Корректировки ставок в Яндекс.Директе
Фильтрации ботов в отчётах

Просмотр параметров¶

Чтобы посмотреть параметры визита:

Откройте Яндекс.Метрику
Перейдите в отчёт "Посетители"
Откройте конкретное посещение
В разделе "Параметры визита" вы увидите все параметры с префиксом bs_

Совет

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

🔍 Основные параметры детекции ботов¶

bs_bot_detected¶

Тип: Число (0 или 1)
Описание: Обнаружен ли посетитель как бот

Возможные значения: - 0 — не бот (реальный пользователь) - 1 — бот

Использование:

Создание сегмента ботов:

bs_bot_detected = 1

Создание сегмента реальных пользователей:

bs_bot_detected = 0

Пример использования

Создайте сегмент "Боты" с условием bs_bot_detected = 1 для анализа доли ботов в трафике и исключения их из отчётов.

bs_bot_confidence¶

Тип: Число (0.0 до 1.0)
Описание: Уверенность системы в том, что посетитель является ботом

Возможные значения: - 0.0 — точно не бот - 0.5 — средняя уверенность - 1.0 — точно бот

Использование:

Создание сегмента высокой уверенности:

bs_bot_confidence >= 0.7

Создание сегмента низкой уверенности:

bs_bot_confidence < 0.5

Пример использования

Создайте сегмент "Высокая уверенность бота" с условием bs_bot_confidence >= 0.7 для более строгой фильтрации явных ботов.

bs_bot_reasons¶

Тип: Объект (JSON строка)
Описание: Причины, по которым посетитель определён как бот

Формат данных:

{"webdriver": 1, "selenium": 1, "headless": 1}

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

webdriver — обнаружен WebDriver
selenium — обнаружен Selenium
puppeteer — обнаружен Puppeteer
headless — обнаружен headless-браузер
phantom — обнаружен PhantomJS
uaIsBotDetected — бот по User-Agent
ip2ProxyDetected — обнаружен прокси
fireholBlocklist — IP в черном списке Firehol
stopForumSpamBlocklist — IP в базе StopForumSpam
И другие причины

Использование:

Анализ наиболее частых причин детекции ботов. Позволяет понять, какие проверки наиболее эффективны.

Анализ причин

Используйте параметр bs_bot_reasons для анализа, какие проверки наиболее эффективны для вашего проекта. Это поможет оптимизировать настройки.

🖥️ Параметры фронтенд-проверок¶

Эти параметры содержат результаты проверок, выполняемых в браузере посетителя.

bs_webdriver¶

Тип: Число (0 или 1)
Описание: Обнаружен ли WebDriver

Использование: - Анализ доли посетителей с WebDriver - Создание сегментов для анализа автоматизации

bs_headless¶

Тип: Число (0 или 1)
Описание: Обнаружен ли headless-браузер

Использование: - Анализ использования headless-браузеров - Создание сегментов для анализа автоматизации

bs_puppeteer¶

Тип: Число (0 или 1)
Описание: Обнаружен ли Puppeteer

Использование: - Анализ использования Puppeteer - Создание сегментов для анализа автоматизации

bs_selenium¶

Тип: Число (0 или 1)
Описание: Обнаружен ли Selenium

Использование: - Анализ использования Selenium - Создание сегментов для анализа автоматизации

bs_incognito¶

Тип: Число (0 или 1)
Описание: Обнаружен ли режим инкогнито

Важно

Режим инкогнито не всегда означает бота. Многие реальные пользователи используют инкогнито для приватности.

bs_cookies_disabled¶

Тип: Число (0 или 1)
Описание: Отключены ли cookies

Важно

Отключенные cookies не всегда означают бота. Некоторые пользователи отключают cookies для приватности.

bs_vpn_russia¶

Тип: Число (0 или 1)
Описание: Используется ли VPN из России

Важно

VPN не всегда означает бота. Многие реальные пользователи используют VPN для приватности.

bs_webrtc_proxy¶

Тип: Число (0 или 1)
Описание: Обнаружен ли прокси через WebRTC

Ложные срабатывания

Эта проверка может давать ложные срабатывания у пользователей с VPN.

🌐 Параметры браузера и устройства¶

Эти параметры содержат информацию о браузере и устройстве посетителя.

bs_browser¶

Тип: Строка
Описание: Название браузера

Примеры значений: - Chrome - Firefox - Safari - Edge

Использование: - Анализ распределения браузеров - Создание сегментов по браузерам

bs_browser_version¶

Тип: Строка
Описание: Версия браузера (major version)

Примеры значений: - 120 (для Chrome 120.x.x) - 121 (для Chrome 121.x.x)

bs_os¶

Тип: Строка
Описание: Название операционной системы

Примеры значений: - Windows - macOS - Linux - Android - iOS

bs_os_version¶

Тип: Строка
Описание: Версия операционной системы

bs_platform¶

Тип: Строка
Описание: Платформа устройства

bs_timezone¶

Тип: Строка
Описание: Часовой пояс пользователя

Примеры значений: - Europe/Moscow - America/New_York

bs_device_memory¶

Тип: Число
Описание: Объём памяти устройства (в GB)

bs_cpu_cores¶

Тип: Число
Описание: Количество ядер процессора

📍 Параметры геолокации¶

Эти параметры содержат информацию о местоположении посетителя.

bs_country¶

Тип: Строка (код страны)
Описание: Страна посетителя

Формат: ISO код страны (например, RU, US, DE)

Использование: - Анализ географического распределения трафика - Создание сегментов по странам

bs_region¶

Тип: Строка
Описание: Регион посетителя

bs_city¶

Тип: Строка
Описание: Город посетителя

🔗 Параметры сети и прокси¶

Эти параметры содержат информацию о сетевом подключении посетителя.

bs_ip_subnet¶

Тип: Строка
Описание: IP-адрес посетителя (или подсеть)

Приватность

IP-адрес передаётся в Яндекс.Метрику для технических целей. В отчётах он может быть анонимизирован в зависимости от настроек Метрики.

bs_is_proxy¶

Тип: Число (0 или 1)
Описание: Используется ли прокси

Использование: - Анализ доли посетителей с прокси - Создание сегментов для анализа прокси-трафика

Пример использования

Создайте сегмент "Прокси/VPN" с условием bs_is_proxy = 1 для анализа трафика через прокси.

bs_proxy_type¶

Тип: Строка
Описание: Тип прокси (если обнаружен)

Возможные значения: - PUB — публичный прокси - VPN — VPN - TOR — TOR выходной узел - WEB — веб-прокси - И другие типы

bs_asn¶

Тип: Число
Описание: Номер автономной системы (ASN)

Использование: - Анализ провайдеров интернета - Создание сегментов по ASN

bs_asn_org¶

Тип: Строка
Описание: Название организации автономной системы

Использование: - Анализ провайдеров интернета - Выявление подозрительных провайдеров (VPN, прокси, дата-центры)

🎯 Параметры поведения¶

Эти параметры содержат информацию о поведении пользователя на странице.

bs_behavior_hash¶

Тип: Строка
Описание: Хеш паттерна поведения пользователя

Использование: - Выявление повторяющихся паттернов поведения - Анализ автоматизированных действий

bs_behavior_bucket¶

Тип: Строка
Описание: Группа похожих паттернов поведения

Использование: - Группировка похожих паттернов - Анализ типов поведения

bs_behavior_score¶

Тип: Число (0.0 до 1.0)
Описание: Оценка подозрительности поведения

Использование: - Создание сегментов по подозрительности поведения - Анализ качества трафика

bs_behavior_detected¶

Тип: Число (0 или 1)
Описание: Обнаружено ли подозрительное поведение

Использование: - Создание сегментов для подозрительного поведения - Дополнительная фильтрация трафика

bs_behavior_reasons¶

Тип: Объект (JSON строка)
Описание: Причины подозрительного поведения

Формат данных:

{"bh_too_uniform": 1, "bh_constant_speed": 1}

📊 Параметры трафика¶

Эти параметры содержат информацию об источнике трафика.

bs_traffic_direct¶

Тип: Число (0 или 1)
Описание: Прямой трафик (пользователь ввёл URL напрямую)

bs_traffic_organic¶

Тип: Число (0 или 1)
Описание: Органический трафик (из поисковых систем)

bs_traffic_social¶

Тип: Число (0 или 1)
Описание: Трафик из социальных сетей

bs_traffic_paid¶

Тип: Число (0 или 1)
Описание: Платный трафик (реклама)

Использование: - Анализ источников трафика - Создание сегментов для платного трафика

Пример использования

Создайте сегмент "Платный трафик без ботов" с условиями bs_traffic_paid = 1 И bs_bot_detected = 0 для анализа качества платного трафика.

bs_referrer_domain¶

Тип: Строка
Описание: Домен источника трафика

bs_ad_platform¶

Тип: Строка
Описание: Платформа рекламы (если определена)

Примеры значений: - yandex — Яндекс.Директ - google — Google Ads - И другие платформы

bs_page_path¶

Тип: Строка
Описание: Путь страницы

🔑 Идентификаторы¶

Эти параметры содержат технические идентификаторы для отслеживания посетителей.

bs_visitor_id¶

Тип: Строка
Описание: Уникальный идентификатор посетителя (fingerprint)

Использование: - Отслеживание посетителей между визитами - Выявление повторяющихся посетителей

bs_backend_fp_hash¶

Тип: Строка
Описание: Хеш отпечатка браузера с бэкенда

Использование: - Дополнительная идентификация посетителя - Выявление повторяющихся отпечатков

💡 Как использовать параметры¶

Просмотр параметров в Яндекс.Метрике¶

Откройте Яндекс.Метрику
Перейдите в отчёт "Посетители"
Откройте конкретное посещение
В разделе "Параметры визита" вы увидите все параметры с префиксом bs_

Создание сегментов¶

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

Примеры использования¶

Сегмент ботов¶

Условие:

bs_bot_detected = 1

Использование: - Анализ доли ботов в трафике - Исключение ботов из отчётов

Сегмент высокой уверенности¶

Условие:

bs_bot_confidence >= 0.7

Использование: - Более строгая фильтрация ботов - Анализ наиболее явных ботов

Сегмент с прокси¶

Условие:

bs_is_proxy = 1

Использование: - Анализ трафика через прокси - Понимание влияния прокси на конверсии

Сегмент реальных пользователей¶

Условие:

bs_bot_detected = 0

Использование: - Анализ реального трафика - Корректировка ставок для реальных пользователей

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

Создание сегментов — как использовать параметры для сегментации
Корректировка ставок в Яндекс.Директе — использование сегментов для оптимизации рекламы
Настройки системы — какие настройки влияют на параметры