Документация
Справочник разработчика
API управления
Управление клиентами Директа
API отчетов v1
Группировки
Клики
Параметры посетителей

Сегментация

Сегментация позволяет ограничить данные, возвращаемые в результате запроса. Для сегментации запроса используйте параметр filters.

Вы можете сегментировать запрос по группировкам и метрикам. При этом обратите внимание на следующие особенности:

  • Фильтрация по группировке производится до использования группировок. Таким образом результирующая метрика представляет собой итоговое значение только для данных, удовлетворяющих условию группировки.
  • Фильтрация по метрике производится после использования метрик.
  • Вы можете использовать для фильтрации те группировки и метрики, которые не входят в состав вашего запроса.
&filters=ga:<группировка или метрика> <оператор фильтрации для указанных метрик> <оператор фильтрации для атрибутов>

Также действует лимит: количество уникальных группировок и метрик — до 10, количество отдельных фильтров — до 20, длина строки в фильтре — до 2000 символов.

Операторы фильтрации для метрик

ОператорОписаниеКодированный видПример
==Равно%3D%3DВремя, проведенное на странице, равно 10 секундам: filters=ga:timeOnPage%3D%3D10.
!=Не равно!%3DВремя, проведенное на странице, не равно 10 секундам: filters=ga:timeOnPage!%3D%3D10.
>Больше%3EВремя, проведенное на странице, больше 10 секунд: filters=ga:timeOnPage%3E10.
<Меньше%3CВремя, проведенное на странице, меньше 10 секунд: filters=ga:timeOnPage%3C10.
>=Больше или равно%3E%3DВремя, проведенное на странице, равно или больше 10 секунд: filters=ga:timeOnPage%3E%3D10.
<=Меньше или равно%3C%3DВремя, проведенное на странице, равно или меньше 10 секунд: filters=ga:timeOnPage%3C%3D10.

Операторы фильтрации для атрибутов

УсловиеОписаниеКодированный видПример
==Точно соответствует%3D%3DОтбирает данные, по которым вычисляются метрики для города Москва: filters=ga:city%3D%3DMoscow.
!=Не соответствует!%3DОтбирает данные, по которым вычисляются метрики для всех городов кроме города Москва: filters=ga:city!%3DMoscow.
=@Содержит подстроку%3D@Отбирает данные, по которым вычисляются метрики для города. Название города соответствует значению «Moscow»: filters=ga:city%3D@Moscow.
!@Не содержит подстроку!@Отбирает данные, по которым вычисляются метрики для города. Название города не соответствует значению «Moscow»: filters= ga:city!@Moscow.
=~Соответствует регулярному выражению%3D~Отбирает данные, по которым вычисляются метрики для города. Название города начинается со значения «Moscow»: filters=ga:city%3D~%5EMoscow.*
!~Не соответствует регулярному выражению!~Отбирает данные, по которым вычисляются метрики для города. Название города не начинается со значения «Moscow»: filters=ga:city!~%5EMoscow.*

Вы можете использовать одновременно несколько условий фильтрации данных в запросе.

При формировании составных фильтров:

  • Допускается использовать следующие операторы регулярных выражений: =~ и !~.
  • Специфические символы (например, &) должны быть закодированы в соответствии с форматом кодирования URL-адресов.

Также вы можете использовать операторы условия: AND или OR.

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

<!--Страна Россия, язык не соответствует русскому.-->

ga:country==Russia;ga:language!~^ru.*

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

<!--Страна Россия или Украина.-->

ga:country==Russia,ga:country==Ukraine