# 🧍 Аудитории

Аудитория — это группа пользователей, объединённых общими признаками: поведением, характеристиками, местоположением и т.д.
Вы можете создавать собственные аудитории и использовать их в разных сценариях: от персонализации контента до аналитики.

Аудитории помогают:

• Персонализировать контент
  Показать акцию на новую коллекцию обуви тем, кто уже покупал обувь раньше.

• Управлять рекомендациями
  Создать отдельный рекомендательный виджет для пользователей с повторными покупками.

• Разбивать данные в аналитике
  Например, посмотреть результаты A/B-теста отдельно по мобильным и десктопным пользователям.
  Это помогает выявить скрытые возможности персонализации — когда одна аудитория отдает предпочтение одному варианту, а другая — другому.

Все сохранённые аудитории доступны в интерфейсе Gravity Field, в разделе Audiences.

Раздел показывает:

• общее количество пользователей;
• бизнес-метрики за 7, 14 и 30 дней;
• статус использования в кампаниях персонализации.

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

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

• Окно атрибуции (Attribution window)
  Определяет, за какой период пользователь должен выполнить условия (например, в течение недели или текущей сессии).

• Время хранения (Retention)
  Указывает, как долго пользователь будет сохраняться в аудитории, даже если больше не соответствует условиям.

При создании аудитории вы можете использовать одно или несколько условий. Gravity Field позволяет настраивать логику объединения на двух уровнях:

1. Между разными условиями — работает как AND (и)
2. Внутри одного условия — можно выбрать AND или OR

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

  

  Пример:

  Products purchased → at least → 1  
  Traffic source → is → social

  → Пользователь должен купить и прийти из соцсетей

• Внутри одного условия (например, Products purchased with property) вы можете:

  • выбрать несколько значений одного или разных атрибутов
  • задать тип логики: AND или OR между этими фильтрами

  → Пользователь должен купить товары по цене от 1000 до 5000

  → Пользователь должен купить один из двух товаров

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

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

• Тип сравнения
  Тип: select — выпадающий список
  Значения:

  • belongs — пользователь входит в выбранную аудиторию
  • not belongs — пользователь не входит в выбранную аудиторию

• Аудитория
  Тип: select
  Значения:

  • все существующие аудитории, отображаются по названию

Audience → belongs → New users

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

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

• Атрибут товара
  Тип: select — выбор из характеристик товаров
  Значения:

  • category, brand, color и др.

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

• Значение атрибута
  Тип: select — конкретное значение выбранного атрибута
  Примеры: Nike, алкоголь, черный

• Уровень интереса (Affinity Score)
  Тип: select
  Значения:

  • high — высокая склонность
  • medium — средняя
  • low — низкая

User affinity → category → алкоголь → high

• Работает только в пределах текущей сессии
• Поддерживаются только дискретные атрибуты (не числовые, не уникальные)

Позволяет сегментировать пользователей по источнику трафика — откуда пришёл пользователь на сайт.

• Тип сравнения
  Тип: select
  Значения:

  • is — источник соответствует выбранному
  • is not — источник НЕ соответствует

• Источник трафика
  Тип: select
  Значения:

  • direct
  • paid search
  • referral
  • search
  • social

Источник определяется автоматически через скрипт (при web-интеграции) или по полю context.traffic.source (при API-интеграции).

Traffic source → is → direct

Фильтрует пользователей по количеству просмотренных страниц за выбранный атрибуционный период.

• Тип сравнения
  Тип: select
  Значения:

  • exactly, is not, more than, at least, less than, at most

• Значение
  Тип: input — количество просмотренных страниц, например: 3, 10

Number of page views → more than → 5

Позволяет отфильтровать новых или вернувшихся пользователей.

• Новизна пользователя
  Тип: select
  Значения:
  • yes — пользователь считается новым
  • no — пользователь не новый

Новизна пользователя определяется системой автоматически на основе cookies или ID пользователя.

New user → yes

Фильтрует пользователей, которые совершили определённое событие (например, добавили товар в корзину).

• Событие
  Тип: select
  Значения:

  • любые события, отправленные в систему через JS SDK или API, например: Add to cart, Apply filters

• Тип сравнения
  Тип: select
  Значения:

  • exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — количество событий, например: 1, 5

Event trigger → Add to cart → at least → 5

Позволяет сегментировать пользователей по событиям, содержащим определённые свойства.
Например, "Добавили в корзину товар из категории X".

• Событие
  Тип: select
  Значения:

  • любое переданное событие (например: Add to cart)

• Имя свойства
  Тип: input
  Пример: category

• Оператор для свойства
  Тип: select
  Значения:

  • is, is not, contains, does not contain, more than, less than, at least, at most

• Значение свойства
  Тип: input — текст или число

• Оператор по количеству
  Тип: select Значения:

  • exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — количество событий, например 3

Event trigger → Add to cart → category → is not → алкоголь → less than → 10

Позволяет выбрать пользователей, которые посещали определённые URL.

• Тип сравнения по URL
  Тип: select
  Значения:

  • is, is not, contains, does not contain, regexp

• URL
  Тип: input — ввод адреса вручную

• Ignore URL parameters
  Тип: checkbox — если включено, query-параметры игнорируются

• Тип сравнения по количеству визитов
  Тип: select
  Значения:

  • exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — количество посещений, например 5

URL visit → is → www.gravityfield.ru → ignore params:true → at least → 5

Сегментирует пользователей, которые добавили товары в корзину.
Можно указать конкретные характеристики добавленных товаров.

• Тип фильтрации
  Тип: select
  Значения:

  • any product — любые товары
  • with property — с указанным атрибутом
  • without property — без атрибута

  Значения:

  • category, brand, color и др.

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

• Значение атрибута
  Тип: select — значение выбранного атрибута
  Примеры: Nike, Матрасы

• Тип сравнения по количеству
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — число, например 5

⚠️ Атрибуты доступны только из фида. Их список настраивается вручную через поддержку.

Products added → with property → category → Матрасы → at least → 5  
Products added → any product → at least → 5

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

• Тип фильтрации
  Тип: select
  Значения:

  • any product
  • with property
  • without property

  Значения:

  • category, brand, color и др.

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

• Значение атрибута
  Тип: select — значение выбранного атрибута
  Примеры: Nike, Матрасы

• Тип сравнения по количеству
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — число, например: 5

Products viewed → with property → category → Матрасы → at least → 5  
Products viewed → any product → at least → 5

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

• Тип фильтрации
  Тип: select
  Значения: any product, with property, without property

  Значения:

  • category, brand, color и др.

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

• Значение атрибута
  Тип: select — значение выбранного атрибута
  Примеры: Nike, Матрасы

• Тип сравнения по количеству
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — число, например: 5

Products purchased → with property → category → Матрасы → at least → 5  
Products purchased → any product → at least → 5

Фильтрует пользователей, которые посещали страницы конкретных товарных категорий.

• Тип категории
  Тип: select
  Значения: any category, of category

• Значение категории
  Тип: select — значения берутся из фида

• Тип сравнения по количеству
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — число, например 3

Category page visit → of category → Матрасы → at least → 5  
Category page visit → any category → at least → 5

Выбирает пользователей, которые посещали страницу поиска на сайте.

• Тип сравнения по количеству
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — число, например 3

Search page visit → at least → 5

Позволяет выбрать пользователей, которые посещали главную страницу сайта.

• Тип сравнения по количеству
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — число, например 3

Homepage visit → at least → 5

Сегментирует пользователей, посетивших страницу корзины.

• Тип сравнения по количеству
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Количество
  Тип: input — число, например 3

Cart page visit → at least → 5

Фильтрует пользователей по общей стоимости всех их покупок за заданный период.

• Тип сравнения по сумме
  Тип: select
  Значения: exactly, is not, more than, at least, less than, at most

• Сумма
  Тип: input — число, например 3000

Total purchase value → at least → 10000

Позволяет сегментировать пользователей по статистике их покупок: сумма, среднее, медиана и др.
Можно выбрать период: все покупки или последние N покупок.

• Метрика
  Тип: select
  Значения: sum, average, minimum, maximum, median, 75th percentile, 90th percentile

• Диапазон
  Тип: select
  Значения:

  • all purchases — учитываются все покупки
  • last purchases — учитываются последние N покупок

• Количество покупок (для last purchases)
  Тип: input — число, например: 5

• Тип сравнения по значению
  Тип: select — exactly, is not, more than, at least, less than, at most

• Значение
  Тип: input — сумма в условной валюте

Purchase value → sum → Last purchases → 5 → at least → 5000  
Purchase value → average → All purchases → at least → 5000

Сегментация по техническим параметрам устройства: браузер, тип устройства, операционная система.

💡 Источник данных: при web-интеграции данные определяются автоматически скриптом. При API-интеграции — передаются через context.device.userAgent.

Сегментирует по браузеру, которым пользуется посетитель.

• Тип: select — оператор сравнения
  Значения: is, is not
• Тип: select — название браузера
  Значения:
  • Chrome
  • Firefox
  • Safari
  • Yandex
  • Edge
  • Internet explorer
  • Opera
  • Android browser
  • Samsung internet
  • MIUI browser
  • Other

Browser → is → Chrome

Определяет тип устройства, с которого пользователь зашёл на сайт.

• Тип: select — оператор сравнения
  Значения: is, is not
• Тип: select — тип устройства
  Значения:
  • Desktop
  • Tablet
  • Mobile

Device category → is → Mobile

Сегментирует по операционной системе устройства пользователя.

• Тип: select — оператор сравнения
  Значения: is, is not
• Тип: select — название ОС
  Значения:
  • Android
  • Chrome OS
  • Gaming Console
  • iOS
  • Mac
  • GNU/Linux
  • Other mobile
  • Windows
  • Windows mobile
  • Smart TV
  • Other

Operating system → is → iOS

Фильтрация пользователей по месту их нахождения: страна, регион, город.

Определение локации происходит по IP-адресу пользователя. При API-интеграции IP передается в поле context.device.ip.

Сегментирует по стране, в которой находится пользователь.

• Тип: select — оператор сравнения
  Значения: is, is not
• Тип: select — название страны
  Примеры: Russia, Belarus, Kazakhstan, Armenia

Country → is → Russia

Сегментирует по региону (области, краю и т.п.).

Важно: выбранный регион не включает одноимённый город.

• Тип: select — оператор сравнения
  Значения: is, is not
• Тип: select — название региона
  Пример: Moscow oblast, Almaty, Leningrad oblast

Region → is → Moscow oblast

Сегментирует по городу.

Важно: выбранный город не включает одноимённую область.

• Тип: select — оператор сравнения
  Значения: is, is not
• Тип: select — название города
  Пример: Moscow, Novosibirsk, Astana

City → is → Moscow

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

1. Когда должны произойти действия пользователя, чтобы он попал в аудиторию
2. Как долго пользователь остаётся в аудитории после того, как перестал соответствовать условиям

Окно атрибуции — период, в течение которого все условия сегментации должны быть выполнены.
Измеряется в календарном времени или в рамках сессии.

• Тип: select
  Значения:
  • current session
  • one day
  • one week
  • two weeks
  • one month
  • three months
  • one year

💡 Для условий типа User Affinity доступно только значение current session, так как аффинитивность рассчитывается в рамках одной сессии.

• User purchased > 5 товаров → в течение одного месяца
  → Выбирается "one month"
• Просмотрел 3 товара из категории Матрасы → за текущую сессию
  → Выбирается "current session"

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

• Тип: input — целое число, от 1 до 365

• Смотрел видео в течение одного дня → сохранить в аудитории на 30 дней
• Сделал дорогую покупку один раз → оставить в сегменте на 365 дней

Q: Могу ли я комбинировать несколько условий?
A: Да, вы можете задать любое количество условий, и они будут применяться одновременно. Пользователь должен соответствовать всем условиям внутри выбранного окна атрибуции (All conditions must be met within).

Q: Что происходит, если пользователь перестал соответствовать условиям?
A: Он остаётся в аудитории в течение срока, указанного в Keep visitors within this Audience for (в днях). По окончании этого срока он будет исключён из аудитории.

Q: В чём разница между “is” и “contains”?
A:

• is означает строгое соответствие значению
• contains — значение может входить в строку (частичное совпадение, удобно для URL)

Q: Можно ли фильтровать по событиям с конкретными свойствами (например, категория товара)?
A: Да, используйте условие Event trigger by property — оно позволяет задать свойство события, его значение и количество повторений.

Q: Какие события я могу использовать?
A: Все события, отправленные в платформу через JS SDK или API — например: Add to cart, Apply filters, Purchase.

Q: Что такое “User Affinity” и как она работает?
A: Это система оценки интереса пользователя к товарным атрибутам. Работает только в пределах одной сессии. Используются только характеристики из фида (например, категория, бренд).

Q: Почему в фильтре нет нужного атрибута (например, “материал”)?
A: Список доступных атрибутов формируется на основе товарного фида. Чтобы его изменить, обратитесь к менеджеру по персонализации или в поддержку.

Q: Чем отличается “Products viewed” от “URL visit”?
A:

• Products viewed — это просмотры карточек товаров
• URL visit — любые страницы сайта, включая промо, формы и т.д.

Q: Moscow и Moscow oblast — это одно и то же?
A: Нет. Moscow — это город, Moscow oblast — регион. Они не включают друг друга.

Q: Как определяется страна / город пользователя?
A: По IP-адресу (автоматически или через поле context.device.ip, если используется API-интеграция).

Q: Что такое “All conditions must be met within”?
A: Это окно времени, в течение которого пользователь должен выполнить все условия (например, в рамках сессии или за 1 месяц).

Q: Как работает “Keep visitors within this Audience for”?
A: Это срок хранения пользователя в аудитории, даже если он больше не соответствует условиям. Задаётся в днях (до 365).

Q: Можно ли настроить аудиторию “люди, которые купили X товаров за последние 2 недели, и не заходили последние 3 дня”?
A: Да. Скомбинируйте:

• Products purchased → at least → X
• All conditions must be met within → two weeks
• И добавьте условие: Last seen → more than → 3 days ago (если доступно в вашей платформе).