# 🧾 Глоссарий Gravity Field

Этот глоссарий описывает ключевые сущности платформы Gravity Field.

# 🔷 Аккаунт и Секции

# Аккаунт (Account)

Аккаунт — это сущность верхнего уровня в Gravity Field, которая объединяет все секции одного клиента. Он используется для организации доступа, настройки пользователей и логической группировки активностей. Один аккаунт может содержать несколько секций, например, для разных сайтов, брендов или регионов. API-доступ и бизнес-логика делегируются на уровень секции.

# Секция (Section)

Секция — это рабочее пространство клиента в рамках аккаунта. В каждой секции настраиваются кампании, сценарии, шаблоны, цели и интеграции. Секция содержит данные (например, продуктовый фид) и отображает контент на соответствующем сайте или в приложении. Если у клиента несколько витрин, создаётся отдельная секция под каждую.

# 📦 Кампании

# Кампания (Campaign)

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

# Сценарий (Experience)

Сценарий — это логическая единица внутри кампании, содержащая одну или несколько версий. Сценарий определяет условия показа, контент и таргетинг. Каждый пользователь попадает в первый подходящий сценарий согласно порядку. В сценарии могут использоваться A/B-тесты, цели и рекомендательные стратегии.

# 🧪 A/B тестирование

# Версия (Version)

Версия — это снимок набора вариаций и условий сценария на момент запуска теста. При любом изменении создаётся новая версия. Только одна версия может быть активной. Внутри версии настраиваются вариации, цели, аллокация и режим тестирования.

# Вариация (Variation)

Вариация — это конкретный вариант контента в рамках A/B-теста. Вариации могут отличаться шаблоном, стилем, логикой, стратегией рекомендаций. Вариации получают трафик согласно настройкам аллокации и участвуют в аналитике.

# Контрольная группа (Control Group)

Контрольная группа — это вариация, не содержащая персонализированного контента. Она используется для замера инкрементального эффекта. Может быть локальной (в рамках одного сценария) или глобальной (GCG), исключающей пользователя из всех кампаний.

# Stickiness

Stickiness определяет, как пользователь закрепляется за вариацией. Варианты: per session (новая вариация в каждой сессии), per user (пользователь всегда видит одну и ту же вариацию). Используется для чистоты A/B теста и консистентности аналитики.

# Attribution Window

Окно атрибуции — это период времени, в течение которого событие пользователя (например, покупка) засчитывается как результат взаимодействия с вариацией. Типичные значения: 1, 7, 14 дней. Применяется только в A/B-тестах.

# Autopilot

Autopilot — это автоматический режим тестирования, при котором система сама распределяет трафик между вариациями, завершает тест и выбирает победителя. Основан на основной метрике.

# P2BB (Probability to Be Best)

P2BB — это вероятность того, что вариация окажется лучшей по выбранной метрике. Показывается только при достаточном объёме трафика и данных. Используется в отчётах и при автоматической аллокации.

# 🔌 Интеграция и данные

# CSS Selector

CSS Selector — это строка, по которой виджет вставляется в нужный DOM-элемент на странице. Используется при типе вставки replace, before, after, append, prepend.

# Insert Method

Способ вставки контента на страницу: replace (заменить элемент), before, after, append, prepend. Определяется в настройке шаблона или в коде вставки.

# API Key

API-ключ — токен, необходимый для server-to-server запросов. Создаётся в разделе Data → Sources → HTTP API. Имеет права и ограничения.

# API Logs

Раздел, где отображаются все запросы к HTTP API: тела, ответы, статусы, ошибки. Используется для отладки и мониторинга.

# Источник данных (Source)

Источник данных — это место, откуда приходят события, фиды, профили: API, Pixel, CRM, фид.

# Потребитель данных (Consumer)

Система, в которую передаются данные Gravity Field: BI, витрины, внешние API.

# Контекст (Page Context)

Контекст страницы — это данные о текущей ситуации (страница, SKU, тип, категория), передаваемые через SDK или API. Используются в таргетинге и выдаче.

# API Selector

Selector — это строковый идентификатор АПИ кампании, по которому он вызывается через API. Он указывается при вызове /choose и позволяет системе выбрать нужную кампанию. Selector может быть точечным (selector.name) или групповым (selector.group).

# 🧩 События и взаимодействия

# Events

События — это действия пользователя (например, add_to_cart, purchase, custom_event), отправляемые через POST /ssapi/event. Используются для аудиторий, таргетинга, аналитики.

# Engagements

Engagement — это взаимодействие с кампаниями, фиксируемое через POST /ssapi/engagement. Каждое взаимодействие требует наличия decisionId, которое связывает его с выбранной вариацией. Основные типы взаимодействий:

Что это: Показ виджета в зоне видимости экрана пользователя. Виджет считается видимым, если он отображается на ≥50% экрана и находится в области, видимой пользователю не менее 1 секунды.
Использование: Это важный показатель для анализа охвата, его используют для оценки реального вовлечения в кампании.

# CLICK

Что это: Клик по кампании или баннеру. Фиксируется, когда пользователь взаимодействует с контентом, показанным в рамках кампании.
Использование: Это основная метрика для анализа интереса пользователя и взаимодействия с контентом.

# SLOT_CLICK

Что это: Клик по товару или элементу в рекомендациях (например, в списке товаров на баннере или в виджете).
Использование: Это важно для анализа, какие товары или элементы из рекомендованного контента пользователи предпочитают.

# PIMP (Product Impression)

Что это: Показ товара в рамках виджета или рекламного блока. Это событие фиксируется, когда товар был продемонстрирован пользователю, но он ещё не совершил действия с ним.
Использование: Полезно для анализа видимости товаров в контексте рекомендаций.

# PCLICK (Product Click)

Что это: Клик по товару, который был показан в рамках виджета или рекламного блока.
Использование: Используется для анализа покупательского интереса к конкретным товарам в момент их представления в контенте кампании.

# Variation Impression

Что это: Показ вариации в рамках A/B теста. Событие фиксируется, когда пользователь видит одну из вариаций контента (не обязательно кликать).
Использование: Важный показатель для анализа охвата и эффективной видимости различных вариантов контента в тестах.

# Variation Click

Что это: Клик по вариации в рамках A/B теста. Событие фиксируется, когда пользователь взаимодействует с вариацией контента, выбранной в рамках A/B теста.
Использование: Используется для анализа эффективности вариаций, основанных на вовлеченности пользователей.

# 🎨 Ресурсы кампаний

# Шаблон (Template)

Шаблон — это HTML/JS конструкция, содержащая визуальный код кампании. Связан с переменными. Обновление шаблона влияет на все кампании, которые его используют.

# Переменные (Variables)

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

# Эвалюатор (Evaluator)

JS-функция, возвращающая значение на лету. Используется в таргетинге и логике отображения (например, проверка control group, localStorage и пр.).

# 🤖 Товарные рекомендации

# Рекомендательная стратегия

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

# Алгоритм

Метод отбора товаров: Popularity, Similar Items, Recently Viewed, Affinity.

# Real-time rules

Правила фильтрации, которые применяются в момент запроса /choose в случае АПИ интеграции или через JS SDK в случае веб интеграции. Пример: исключить товары дороже текущего, товары не со склада, товары из другой категории.

# Метрики

Direct Purchases — покупки, сделанные после взаимодействия;
Direct Revenue — выручка, связанная с рекомендацией;
CTR, Coverage, Viewability.

# 🧱 Визуальные компоненты

Блок на странице, отображающий контент кампании. Виджет может быть статичным или динамичным, отображать товары, рекламные баннеры, сообщения о скидках и другое. Виджеты могут быть встроены в страницу или отображаться как всплывающие элементы.

# Варианты виджетов

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

# Notification

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

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

# Recommendation

Что это: Виджет, который отображает персонализированные рекомендации товаров или услуг. Эти рекомендации могут быть основаны на предыдущих действиях пользователя (например, просмотренных товарах) или на общих предпочтениях других пользователей.
Пример использования: блок с рекомендациями "Похожие товары", "Вы могли бы заинтересоваться".

Что это: Виджет, который отображает данные о популярных товарах или услугах, а также действиях других пользователей. Этот виджет помогает создать ощущение доверия к продукту через демонстрацию популярности или активных покупателей.
Пример использования: "9 человек недавно приобрели", "Пользователи, купившие этот товар, также приобрели", "Популярные товары месяца".

# Low Stock

Что это: Виджет, который информирует пользователя о товарах с ограниченным количеством на складе. Это создает ощущение срочности и может побудить пользователя совершить покупку быстрее.
Пример использования: "Товар на складе ограничен — осталось 3 штуки", "Скоро закончится — закажи сейчас".

# Exit Intent

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

# Slider

Что это: Карусель, которая отображает несколько товаров или предложений, с возможностью прокрутки. Это может быть как горизонтальная, так и вертикальная карусель с контентом.
Пример использования: отображение новинок, популярных товаров или специальных предложений в виде слайдера на главной странице.

# Inline Block

Что это: Встроенный элемент, который отображается непосредственно в контексте контента, например, внутри текста статьи или на странице продукта.
Пример использования: кнопки "Добавить в корзину" или рекламные блоки, вставленные в описание товара, статьи или на страницы категорий.

# 📢 Retail Media

# Gravity Ads

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

# Рекламная кампания

Настраиваемая кампания для продвижения товаров или брендов в интерфейсе ритейлера.

# Рекламодатель / Бренд

Компания, размещающая рекламу. Имеет ограничения по доступу к инвентарю.

# Плейсмент

Слот на сайте, куда вставляется рекламный блок или виджет.

# Ad Strategy

Правила выбора товаров или баннеров, которые будут показаны пользователю.

# Метрики

Показы, клики, CTR, DRR, ROI, конверсии, стоимость привлечения.

# 🧾 Глоссарий Gravity Field

# 🔷 Аккаунт и Секции

# Аккаунт (Account)

# Секция (Section)

# 📦 Кампании

# Кампания (Campaign)

# Сценарий (Experience)

# 🧪 A/B тестирование

# Версия (Version)

# Вариация (Variation)

# Контрольная группа (Control Group)

# Stickiness

# Attribution Window

# Autopilot

# P2BB (Probability to Be Best)

# 🔌 Интеграция и данные

# CSS Selector

# Insert Method

# API Key

# API Logs

# Источник данных (Source)

# Потребитель данных (Consumer)

# Контекст (Page Context)

# API Selector

# 🧩 События и взаимодействия

# Events

# Engagements

# WRIMP (Widget Real Impression)

# CLICK

# SLOT_CLICK

# PIMP (Product Impression)

# PCLICK (Product Click)

# Variation Impression

# Variation Click

# 🎨 Ресурсы кампаний

# Шаблон (Template)

# Переменные (Variables)

# Эвалюатор (Evaluator)

# 🤖 Товарные рекомендации

# Рекомендательная стратегия

# Алгоритм

# Real-time rules

# Метрики

# 🧱 Визуальные компоненты

# Виджет (Widget)

# Варианты виджетов

# Popup

# Notification

# Banner

# Recommendation

# Social Proof

# Low Stock

# Exit Intent

# Slider

# Inline Block

# 📢 Retail Media

# Gravity Ads

# Рекламная кампания

# Рекламодатель / Бренд

# Плейсмент

# Ad Strategy

# Метрики