--- metadata: - name: generator content: Diplodoc Platform v5.54.2 alternate: - https://yandex.com/support/varioqub/en/create/conditions.md - https://yandex.com/support/varioqub/ru/create/conditions.md - https://yandex.com/support/varioqub/tr/create/conditions.md - href: ru/create/conditions.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/varioqub/ru/llms.txt # Условия По умолчанию эксперимент ограничен только по времени проведения. Вы можете добавить правила, чтобы ограничить условия: : [Продолжительность](#duration) [Доля аудитории](#audience) [Страницы применения](#pages) [GET-параметры](#gets) [Регион](#region) [Платформа](#platform) [Пользовательские параметры](#custom) [Исключить поисковых роботов](#robots) [Таргетирование](#targeting) {% note info %} Чтобы подключить условия к вашему эксперименту: 1. В Метрике перейдите на страницу **Вариокуб** → **Эксперименты** → **Создать эксперимент**. 1. Выберите необходимое условие. {% endnote %} ## Продолжительность {#duration} Длительность эксперимента можно задать от 1 до 90 дней. После достижения даты окончания эксперимент остановится автоматически. Вы можете остановить его вручную в любой момент: 1. Перейдите на страницу **Эксперименты**. 1. Около эксперимента перейдите в меню и нажмите **Остановить**. ![](../_assets/on-off.png =750x) ## Доля аудитории {#audience} По умолчанию учитывается вся аудитория сайта — 100%. Вы можете указать долю от 1% до 100% — это общий процент на все выборки, делится равномерно между выборками. Определяйте долю в зависимости от посещаемости вашего сайта. ## Страницы применения {#pages} Укажите домен сайта и путь URL без протокола (`http`/`https`) и `hash` (символ `#` в URL и значение после него). Например, чтобы в эксперименте участвовала только главная страница сайта, укажите `example.com`. Чтобы задать гибкие условия, используйте специальные операторы. При этом точка (`.`) не считается оператором. Несколько условий в строке Varioqub учитывает по оператору «И»/«ИЛИ». | **Пример использования операторов** | **Что учитывается в эксперименте** | |---------------------------------|--------------------------------| | `example.com*` | Все страницы домена. | | `example.*` | Все страницы всех доменов, которые начинаются с `example`. | | `example.com/*search*` | Все страницы сайта, в адресе которых встречается `search`. | | `example.com/search?` | Адреса страниц с отсутствием символов или одним символом в конце строки. Например: `example.com/search, example.com/search/, example.com/search2`. | | `example.com/search+` | Адреса страниц с одним и больше символами в конце строки. Например: `example.com/search/, example.com/search2, example.com/search_goods`. | {% cut "Подробно о структуре URL" %} `https:///?#` - `` — домен сайта. - `` — путь, который может иметь иерархическую структуру. Структура задается с помощью символа «/». - `` — блок параметров, который отделяется от пути символом «?». Также называется «GET-параметрами». - `` — строка с произвольным содержимым. Отделяется от GET-параметров символом «#». Также называется «hash». Не учитывается в условиях **Страницы применения эксперимента**. {% endcut %} ## GET-параметры {#gets} Если эксперимент должен проходить только на части страниц сайта, укажите GET-параметры, которые встречаются или отсутствуют в их адресах. Чтобы задать гибкие условия, используйте специальные операторы. При этом точка (`.`) не считается оператором. Чтобы Varioqub учитывал несколько условий одновременно, укажите их через запятую: `aparam=avalue,bparam=bvalue` (будет применяться оператор «И»). Отдельные блоки условий объединяются по оператору «ИЛИ». Символы, которые можно использовать с параметрами и их значениями: - `=` — ставится между названием параметра и его значением, при отсутствии учитывается только наличие параметра. Пример: `param=value` - `?` — означает любой символ, который встречается ноль или один раз. Пример: `pa?am=va?ue` - `*` — означает любые символы, которые встречаются ноль или несколько раз. Пример: `p*m=v*e` - `+` — означает любые символы, которые встречаются один или несколько раз. Пример: `p+m=v+e` - `!` — означает отрицание условия или исключение параметра из влияния на эксперимент. Пример `!param=val` {% note warning %} Отрицание `!` ставится только **первым** символом в ключе. - Корректный пример: `!param=value`. - Некорректные примеры: `param!=value` или `param=!value`. {% endnote %} #### Примеры использования #| || **Пример использования** | **Что учитывается в эксперименте** || || `param` | Только наличие параметра, независимо от значения. || || `param=value` | Наличие точного названия параметра и его точного значения. || || `!param` | Отсутствие параметра с любым значением. || || `*param*=value` | Все параметры, которые содержат фрагмент `param` со значением `value`. || || `!*param*=value` | Значение любого параметра с фрагментом `param` не должно равняться `value`. || || `!*param*=*value*` | Значение любого параметра с фрагментом `param` не должно содержать `value`. || || `!*param*` | Отсутствие параметра, содержащего фрагмент `param`. || |# ## Регион {#region} Регион определяется по IP-адресу посетителя сайта. **Доступны значения**: {% cut "Россия" %} - Москва - Москва и Московская область - Белгородская область - Брянская область - Владимирская область - Воронежская область - Ивановская область - Калужская область - Костромская область - Курская область - Липецкая область - Орловская область - Рязанская область - Смоленская область - Тамбовская область - Тверская область - Тульская область - Ярославская область - Санкт-Петербург и Ленинградская область - Архангельская область - Вологодская область - Калининградская область - Мурманская область - Новгородская область - Псковская область - Республика Карелия - Республика Коми - Кировская область - Нижегородская область - Оренбургская область - Пензенская область - Пермский край - Республика Башкортостан - Республика Марий Эл - Республика Мордовия - Республика Татарстан - Самарская область - Саратовская область - Удмуртская Республика - Ульяновская область - Чувашская Республика - Астраханская область - Волгоградская область - Краснодарский край - Республика Адыгея - Республика Калмыкия - Ростовская область - Алтайский край - Иркутская область - Кемеровская область (Кузбасс) - Красноярский край - Новосибирская область - Омская область - Республика Алтай - Республика Тыва - Республика Хакасия - Томская область - Амурская область - Еврейская автономная область - Забайкальский край - Камчатский край - Магаданская область - Приморский край - Республика Бурятия - Республика Саха (Якутия) - Сахалинская область - Хабаровский край - Алушта - Армянск - Бахчисарайский район - Джанкой - Евпатория - Керчь - Красноперекопск - Ленинский район - Саки - Севастополь - Симферополь - Судак - Феодосия - Ялта - Кабардино-Балкарская Республика - Карачаево-Черкесская Республика - Республика Дагестан - Республика Ингушетия - Республика Крым - Республика Северная Осетия — Алания - Ставропольский край - Чеченская Республика - Курганская область - Свердловская область - Тюменская область - Ханты-Мансийский автономный округ - Югра - Челябинская область - Ямало-Ненецкий автономный округ - Ненецкий автономный округ {% endcut %} {% cut "СНГ" %} - Абхазия - Азербайджан - Армения - Беларусь - Казахстан - Киргизия - Молдова - Таджикистан - Туркменистан - Узбекистан - Южная Осетия {% endcut %} {% cut "Европа" %} - Австрия - Бельгия - Болгария - Великобритания - Венгрия - Германия - Греция - Дания - Испания - Италия - Кипр - Литва - Нидерланды - Норвегия - Польша - Португалия - Румыния - Сербия - Словакия - Словения - Турция - Финляндия - Франция - Хорватия - Черногория - Чехия - Швейцария - Швеция {% endcut %} {% cut "Азия" %} - Бахрейн - Вьетнам - Грузия - Израиль - Индия - Индонезия - Иордания - Йемен - Камбоджа - Катар - Китай - Кувейт - Малайзия - Объединённые Арабские Эмираты - Оман - Саудовская Аравия - Сингапур - Таиланд - Тайвань - Филиппины - Южная Корея - Япония {% endcut %} {% cut "Северная Америка" %} - Гватемала - Доминиканская Республика - Канада - США - Мексика {% endcut %} {% cut "Южная Америка" %} - Аргентина - Бразилия - Колумбия - Перу - Уругвай - Чили {% endcut %} {% cut "Африка" %} - Египет - Кот-д’Ивуар {% endcut %} {% cut "Австралия и Океания" %} - Австралия - Новая Зеландия {% endcut %} Также доступен переключатель «Исключить выбранные регионы», который позволяет инвертировать выбор, исключая отмеченные регионы из эксперимента. ## Платформа {#platform} Смартфоны, планшеты, десктопные устройства (ПК), телевизоры (ТВ). Тип устройства определяется по User-Agent посетителя сайта. Узнать, пользователи каких устройств заходят на ваш сайт чаще, можно с помощью отчета Метрики [Устройства](https://yandex.ru/support/metrica/technologies/devices.html). ## Пользовательские параметры {#custom} {% note info %} Доступно только в [расширенной версии Varioqub](https://yandex.com/support/varioqub/ru/paid-functionality.md). {% endnote %} Чтобы использовать это условие, реализуйте на сайте передачу параметров, которые могут, например, характеризовать посетителей сайта. Это может быть признак важности клиента или регистрации на сайте. После укажите параметры и их значения в поле **Пользовательские значения** — Varioqub будет распознавать их и учитывать в ходе эксперимента. Чтобы Varioqub учитывал несколько условий одновременно, укажите их через запятую: `aparam=avalue,bparam=bvalue` (будет применяться оператор «И»). Отдельные блоки условий объединяются по оператору «ИЛИ». Символы, которые можно использовать с параметрами и их значениями: - `=` — ставится между названием параметра и его значением, при отсутствии учитывается только наличие параметра. Пример: `param=value` - `?` — означает любой символ, который встречается ноль или один раз. Пример: `pa?am=va?ue` - `*` — означает любые символы, которые встречаются ноль или несколько раз. Пример: `p*m=v*e` - `+` — означает любые символы, которые встречаются один или несколько раз. Пример: `p+m=v+e` - `!` — означает отрицание условия или исключение параметра из влияния на эксперимент. Пример `!param=val` {% note warning %} Отрицание `!` ставится только **первым** символом в ключе. - Корректный пример: `!param=value`. - Некорректные примеры: `param!=value` или `param=!value`. {% endnote %} #### Примеры использования #| || **Пример использования** | **Что учитывается в эксперименте** || || `param` | Только наличие параметра, независимо от значения. || || `param=value` | Наличие точного названия параметра и его точного значения. || || `!param` | Отсутствие параметра с любым значением. || || `*param*=value` | Все параметры, которые содержат фрагмент `param` со значением `value`. || || `!*param*=value` | Значение любого параметра с фрагментом `param` не должно равняться `value`. || || `!*param*=*value*` | Значение любого параметра с фрагментом `param` не должно содержать `value`. || || `!*param*` | Отсутствие параметра, содержащего фрагмент `param`. || |# ## Исключить поисковых роботов {#robots} Роботы — это программы, которые обходят сайт с определенной целью. Например, для индексирования сайта или проверки его работы. Какие-то роботы представляются сами, другие — наоборот, стараются маскироваться под реального пользователя, чтобы аналитические системы их не вычислили. При создании эксперимента вы можете исключить из аудитории роботов, которые представились (их User-agent известен). Для этого выберите опцию **Исключить поисковых роботов**. ## Таргетирование {#targeting} {% note info %} Доступно только в [расширенной версии Varioqub](https://yandex.com/support/varioqub/ru/paid-functionality.md). {% endnote %} ### Использование собственного идентификатора Для проведения эксперимента Varioqub разбивает посетителей сайта на группы, используя свои идентификаторы пользователей. Если ваш сервис поддерживает наличие собственных пользовательских идентификаторов, то с их помощью можно разделить пользователей эксперимента на группы. Чтобы использовать это условие: 1. Выберите чекбокс **Использовать собственный идентификатор для разбиения**. 1. Реализуйте на сайте передачу GET-параметра `cuid`, значение которого будет равно идентификатору пользователя. {% cut "Пример запроса через API usersplit" %} ```bash GET https://uaas.yandex.ru/v1/exps ? [[client_id](*client_id)=] & [[url](*url)=] & [[i](*i)=] & [[client_features](*client_features)=] & [[cuid](*cuid)=] ``` {% endcut %} {% cut "Пример инициализации через JavaScript API" %} ```javascript ymab({ clientId: 'metrika.XXXX', cuid: , callback: callback }) ``` {% endcut %} {% note warning %} Длина собственного идентификатора **не должна** превышать 30 символов. При превышении этой длины, пользователь не будет определён в эксперимент. {% endnote %} {% note alert %} Данные в отчётах Varioqub и Яндекс Метрики могут различаться, потому что собственные идентификаторы не поддерживаются в отчётах Метрики. {% endnote %} ### Добавление списка собственных идентификаторов Вы можете создать список собственных идентификаторов, чтобы эксперимент применялся только к пользователям, у которых идентификатор совпадает с одним из идентификаторов из введенного списка. Для использования этой функции необходимо: 1. Выберите чекбокс **Использовать собственный идентификатор для разбиения**. 1. Нажмите **Добавить список собственных идентификаторов**. 1. Создайте новый список или выберите один из уже созданных. Чтобы создать список идентификаторов: 1. Нажмите **Создать список**. 1. Укажите название списка. 1. Введите список идентификаторов через запятую. 1. Нажмите **Сохранить**. {% note info %} Сохранение списка может занимать несколько минут. {% endnote %} {% note warning "Ограничения" %} - Количество идентификаторов в одном списке — не более 100 000 штук. - Максимальная длина идентификатора — 30 символов. {% endnote %} ## Вопросы и проблемы [При создании эксперимента все поля заблокированы.](https://yandex.com/support/varioqub/ru/faq.md#fields-blocked) [А если нужных условий нет в интерфейсе Varioqub?](https://yandex.com/support/varioqub/ru/faq.md#custom-condition) [Как отключить тип эксперимента на всем сайте или странице?](https://yandex.com/support/varioqub/ru/faq.md#disable-experiment-type)
Задайте вопрос Нейроэксперту — в правом нижнем углу нажмите кнопку ![](../_assets/neuro-mod.png =150x). Если у вас остались вопросы, напишите в службу поддержки.
Написать в службу поддержки
[*client_id]: Идентификатор пользователя Метрики. Формат: `metrika.{counter_id}`. Где `{counter_id}` — это номер счетчика Метрики. [Как найти номер счетчика](https://yandex.ru/support/metrica/general/tag-id.html) [*url]: Адрес страницы с GET-параметрами, на которой находится посетитель. Если URL не передан, то Varioqub использует реферер из заголовков, но реферер может не передаваться или передаваться не полностью. Поэтому рекомендуем всегда передавать URL. [*i]: Идентификатор посетителя сайта, хранящийся в first-party cookies. Должен быть выставлен в cookie `_ymab_param` по факту получения ответа. Может быть пустым при первом визите посетителя. Рекомендуем передавать в каждом запросе к API. В первом запросе поле может быть пустым. [*client_features]: Сериализованный JSON-объект параметров пользователей. Пример: `{"param2": "value2", "param1": "value1"}`. [*cuid]: Собственный идентификатор, который позволяет использовать в экспериментах свои пользовательские идентификаторы.