# Начало работы

> Gravity Field — омниканальная платформа персонализации. Инструменты Gravity Field на основе больших данных адаптируют сайт, приложение под потребности каждого пользователя с целью оптимизации конверсии, роста выручки и других продуктовых метрик.

- [Начало работы](https://docs.gravityfield.ai/index.md): Начало работы
- [Интеграция](https://docs.gravityfield.ai/integration/integration.md): Ниже описаны шаги для внедрения платформы персонализации на вашем сайте или приложении. Некоторые этапы требуют принятия решений, например, выбор способа передачи событий и запуска кампаний: через JS-скрипт, API или SDK.
- [Shopping Assistant](https://docs.gravityfield.ai/shopping_assistant/shopping_assistant.md): Shopping Assistant - это AI-помощник для покупателей. Он ведет диалог, уточняет потребность, помогает выбрать подходящие товары из каталога и возвращает результат в структурированном формате для отображения в интерфейсе клиента.
- [Retail media](https://docs.gravityfield.ai/retail_media/retail_media.md): Gravity Ads — платформа для управления рекламой товаров и баннеров в экосистеме ритейлера. Инструменты Gravity Ads позволяют создать retail media медиа продукт и масштабировать рекламную выручку.
- [🛠 Поддержка клиентов](https://docs.gravityfield.ai/support.md): Каждый клиент Gravity Field может обратиться за помощью в службу поддержки. Служба поддержки работает с 10:00 до 19:00 по московскому времени в рабочие дни.

## Интеграция

### Web интеграция

- [Web интеграция](https://docs.gravityfield.ai/integration/web_integration/web_integration.md): Прежде чем приступить к работе с платформой, необходимо настроить следующие элементы.
- [🛠️ Установка скрипта](https://docs.gravityfield.ai/integration/web_integration/script.md): Для корректной работы персонализации необходимо установить следующие скрипты на каждой странице сайта.
- [🌐 Контексты](https://docs.gravityfield.ai/integration/web_integration/page_context.md): Контексты помогают платформе понимать пользовательский путь на сайте, размещать плейсменты в нужных ситуациях и запускать кампании в соответствии с условиями таргетинга.
- [Настройка передачи событий](https://docs.gravityfield.ai/integration/web_integration/events.md): События нужны для отслеживания важных пользовательских действий, таких как добавление товара в корзину, добавление в список желаемого, аутентификации в личном кабинете и многие другие.
- [Проброска cookie](https://docs.gravityfield.ai/integration/web_integration/cookie.md): В сентябре 2019 года компания Apple представила ITP 2.3, который принудительно удаляет 3rd-party cookie через 7 дней. Google также ограничивает использование 3rd-party cookie и анонсировал блокировку их использования по умолчанию в будущих обновлениях браузера.

#### JS SDK API

- [JS SDK API](https://docs.gravityfield.ai/integration/web_integration/client_side_api/client_side_api.md): JS SDK API — клиентский интерфейс web-скрипта Gravity Field. Через него можно отправлять события, получать рекомендации и данные товаров, запускать embed-кампании, ждать появления элементов на странице и отправлять трекинг для API-driven сценариев.
- [Вставка embed виджета](https://docs.gravityfield.ai/integration/web_integration/client_side_api/inster_widget.md): Для кампаний с методом вставки embed можно запускать кампанию вручную из другой кампании или внешнего клиентского кода. Скрипт выберет подходящий опыт и вариацию, проверит таргетинги и вставит результат в указанный элемент.
- [Работа с рекомендательными виджетами](https://docs.gravityfield.ai/integration/web_integration/client_side_api/work_rec_widgets.md): Вы можете использовать JS SDK API для получения рекомендаций в рамках любого типа веб-кампаний непосредственно в коде своего проекта. Результат возвращается в JSON-формате.
- [Получение аффинити профиля пользователя](https://docs.gravityfield.ai/integration/web_integration/client_side_api/get_affinity_profile.md): Аффинити-профиль показывает рассчитанные интересы текущего пользователя по свойствам товаров. Метод возвращает объект со скорами и не более 20 значений для одного свойства.
- [Получение информации о товаре](https://docs.gravityfield.ai/integration/web_integration/client_side_api/get_product_info.md): JS SDK позволяет получить данные товаров из фида, social proof по товарам и product sets. Все методы в этом разделе возвращают Promise.
- [Ожидание элементов, переменных и событий](https://docs.gravityfield.ai/integration/web_integration/client_side_api/wait_for_elements.md): Методы в этом разделе помогают выполнять код после появления DOM-элементов, переменных, пользовательских событий или выполнения произвольного условия.
- [Другие функции](https://docs.gravityfield.ai/integration/web_integration/client_side_api/other_helpful.md): В этом разделе собраны методы, которые чаще используются внутри кампаний, кастомных шаблонов и API-driven сценариев.
- [SPA сайты](https://docs.gravityfield.ai/integration/web_integration/spa.md): Запуск кампаний персонализации на странице зависит от генерации браузером pageload — большинство кампаний рендерятся в браузере пользователя, когда загружается подходящая по таргетингу страница.
- [Действия в виджетах: добавить в корзину и другое](https://docs.gravityfield.ai/integration/web_integration/widget_actions.md): Если вы используете рекомендательные виджеты с действиями (например, добавление в корзину или в избранное), необходимо реализовать соответствующие методы в window.
- [Отключение скрипта в браузере](https://docs.gravityfield.ai/integration/web_integration/disable_script.md): Отключение скрипта в браузере может понадобиться для того, чтобы увидеть страницы сайта без кампаний и быстро проверить, связаны ли какие-либо аспекты отображения сайта с платформой персонализации либо с кодом самого сайта.

### API интеграция

- [API интеграция](https://docs.gravityfield.ai/integration/api_integration/api_integration.md): Процесс интеграции включает несколько ключевых шагов. Убедитесь, что каждый из них выполнен:
- [Начало интеграции](https://docs.gravityfield.ai/integration/api_integration/getting_started.md): У API-документации есть коллекция запросов с примерами.

#### API персонализации

- [Передача контекста страницы](https://docs.gravityfield.ai/integration/api_integration/personalization/page_context.md): Для всех пользователей необходимо передавать информацию о просмотре страниц на сайте или экранов в приложении. Как правило, данная задача решается вместе с задачей запроса кампаний в рамках choose.
- [Передача событий](https://docs.gravityfield.ai/integration/api_integration/personalization/events.md): Для того, чтобы иметь возможность собирать статистику и оптимизировать кампании, необходимо передавать в Gravity Field информацию о действиях пользователя на сайте или в приложении.
- [Получение кампаний](https://docs.gravityfield.ai/integration/api_integration/personalization/choose.md): Для получения кампаний необходимо отправить запрос /choose. В запросе должен быть указан селектор кампании, который вы задали при создании кампании.
- [Передача взаимодействий пользователя с кампаниями](https://docs.gravityfield.ai/integration/api_integration/personalization/engagement.md): Для сбора статистики и последующей оптимизации кампаний необходимо передавать информацию о взаимодействиях пользователя с кампаниями.

#### API рекламной платформы

- [Получение рекламных кампаний](https://docs.gravityfield.ai/integration/api_integration/retail_media/choose.md): Для получения рекламных кампаний для определенного плейсмента необходимо отправить запрос /choose. В запросе должен быть указан идентификатор плейсмента.
- [Отправка взаимодействия с рекламным местом](https://docs.gravityfield.ai/integration/api_integration/retail_media/engagement.md): Ниже на схеме показаны основные события, связанные с показом и взаимодействием с рекламой в 4 случаях, когда в плейсмент:
- [Обновление данных о пользователе](https://docs.gravityfield.ai/integration/api_integration/retail_media/user.md): Метод позволяет:
- [API ключи](https://docs.gravityfield.ai/integration/api_integration/manage_api_keys.md): API-ключ — это уникальный код, используемый для идентификации приложения или пользователя. API-ключи используются для отслеживания и контроля того, кто и как использует API, а также для аутентификации и авторизации приложений аналогично паролям и логинам.
- [API логи](https://docs.gravityfield.ai/integration/api_integration/api_logs.md): Чтобы увидеть API-логи, необходимо перейти в Data → Sources → HTTP API Logs
- [Лимиты по количеству запросов](https://docs.gravityfield.ai/integration/api_integration/rate_limits.md): Платформа накладывает ограничения на количество запросов, чтобы защитить сетевые ресурсы и сохранить качество клиентского опыта.

#### API V2

- [API V2](https://docs.gravityfield.ai/integration/api_integration/v2/index.md): API V2 - это новый публичный Gateway API Gravity Field для server-side, web, mobile SDK и headless-сценариев. Он используется для сценариев персонализации
- [Начало интеграции](https://docs.gravityfield.ai/integration/api_integration/v2/getting_started.md): У API-документации есть коллекция запросов с примерами.
- [Контекст ctx](https://docs.gravityfield.ai/integration/api_integration/v2/context.md): ctx описывает текущую страницу, экран или условия, которые важны именно для этого запроса. API V2 использует этот объект для таргетинга, активации кампаний, выбора рекомендаций, подбора рекламы и корректной аналитики.

##### Персонализация

- [Пользователь](https://docs.gravityfield.ai/integration/api_integration/v2/personalization/user.md): /user используется, когда нужно получить или создать пользователя и сессию без отправки pageview или бизнес-события.
- [Просмотр](https://docs.gravityfield.ai/integration/api_integration/v2/personalization/visit.md): Для всех пользователей необходимо передавать информацию о просмотре страниц на сайте или экранов в приложении. В API V2 для этого используется запрос /visit.
- [События](https://docs.gravityfield.ai/integration/api_integration/v2/personalization/events.md): Для сбора статистики, расчёта целей и оптимизации кампаний необходимо передавать в Gravity Field информацию о действиях пользователя.
- [Кампании](https://docs.gravityfield.ai/integration/api_integration/v2/personalization/choose.md): Для получения контента кампании необходимо отправить запрос /choose. В API V2 кампанию можно запросить по selector, group, campaignId или placementId.
- [Стратегия](https://docs.gravityfield.ai/integration/api_integration/v2/personalization/strategy.md): /strategy используется для получения данных рекомендательной стратегии через API V2.
- [Взаимодействия](https://docs.gravityfield.ai/integration/api_integration/v2/personalization/engagement.md): Для сбора статистики и последующей оптимизации кампаний необходимо передавать информацию о взаимодействиях пользователя с контентом и товарами.

##### Рекламная платформа

- [Пользователь](https://docs.gravityfield.ai/integration/api_integration/v2/retail_media/user.md): /user используется в рекламной платформе, когда нужно получить или обновить uid и ses до запроса рекламного плейсмента.
- [Получение рекламных кампаний](https://docs.gravityfield.ai/integration/api_integration/v2/retail_media/choose.md): Для получения рекламы через API V2 отправьте запрос /choose и передайте идентификатор рекламного плейсмента в data[].placementId.
- [Взаимодействия](https://docs.gravityfield.ai/integration/api_integration/v2/retail_media/engagement.md): Для рекламной платформы важно передавать не только факт запроса плейсмента, но и взаимодействия пользователя с рекламным местом, креативом и товарами. Эти события используются для расчёта показов, видимых показов, CTR, эффективности товарных слотов и последующей оптимизации кампаний.
- [Миграция с API V1 на API V2](https://docs.gravityfield.ai/integration/api_integration/v2/migration.md): API V2 можно внедрять постепенно. V1-документация и существующие /ssapi/* интеграции остаются доступными, поэтому миграцию лучше начинать с нового selector, рекламного placement, нового канала или ограниченного набора кампаний.

### Гибридная интеграция

- [Гибридная интеграция](https://docs.gravityfield.ai/integration/hybrid_integration/hybrid_integrations.md): Гибридная интеграция сочетает возможности API и Web-интеграции. Критичные кампании можно запрашивать через API на сервере и включать персонализированный контент в HTML-разметку до загрузки страницы.
- [🧪 Руководство: Гибридное A/B-тестирование](https://docs.gravityfield.ai/integration/hybrid_integration/hybrid_ab_test.md): В этом руководстве описан процесс внедрения A/B-теста в гибридной модели интеграции. Бэкенд сайта запрашивает вариацию кампании через API во время server-side rendering и сразу включает выбранный контент в HTML.

### Товарный каталог

- [Синхронизация фида](https://docs.gravityfield.ai/integration/products_catalogues/general_reqs.md): Товарный фид — один из ключевых элементов интеграции платформы персонализации. На базе товарного фида строятся рекомендации, качество рекомендаций напрямую зависит от качества товарного фида и объёма информации, которая в нём передаётся.
- [Пользовательские параметры](https://docs.gravityfield.ai/integration/products_catalogues/additional_params.md): Параметры ниже часто используются нашими клиентами, поэтому мы решили собрать их в документации, с тем, чтобы облегчить создание фидов для тех, кто только приступает к персонализации.
- [Мультиязычность и мультирегиональность](https://docs.gravityfield.ai/integration/products_catalogues/multi_language.md): В случае, если сайт или приложение работают в разных локациях, где те или иные параметры товаров различаются, возможность настройки мультиязычности / мультирегиональности позволяет выводить товары в рекомендательных виджетах с корректным языком, корректной валютой и правильной ценой.
- [Данные](https://docs.gravityfield.ai/integration/data/data.md): Раздел «Данные» отвечает за интеграцию площадки клиента с продуктом Gravity Field. Он предоставляет инструменты для подключения и мониторинга источников данных, анализа качества интеграции и работы с API.
- [🔐 Работа с персональными данными](https://docs.gravityfield.ai/integration/personal_data.md): Gravity Field спроектирован таким образом, чтобы минимизировать риски, связанные с обработкой персональных данных (PII). Платформа не требует и не обрабатывает персональные данные пользователей напрямую.
- [🆔 Идентификация и омниканальный профиль](https://docs.gravityfield.ai/integration/identification.md): Gravity Field обеспечивает создание Единого Профиля Клиента, объединяя данные из разных источников: Web, Mobile App и оффлайн покупки.

### SDK

- [SDK Gravity Field (Flutter)](https://docs.gravityfield.ai/integration/sdk/ask_flutter.md): Gravity Field SDK — это лёгкий клиент для интеграции мобильных приложений (iOS / Android) с платформой персонализации и A/B-тестирования. Он позволяет запускать кампании без необходимости реализовывать собственную логику таргетинга, выбора и аналитики.
- [SDK Gravity Field (iOS)](https://docs.gravityfield.ai/integration/sdk/sdk_ios.md): Gravity Field SDK (iOS) — клиентская библиотека для интеграции iOS-приложений с платформой персонализации и A/B-тестирования Gravity Field.
- [SDK Gravity Field (Android)](https://docs.gravityfield.ai/integration/sdk/sdk_android.md): Gravity Field SDK - это клиентская библиотека для интеграции Android-приложений с платформой персонализации и A/B-тестирования Gravity Field.
- [Гайд: Backend-Driven UI (BDUI) с Flutter SDK](https://docs.gravityfield.ai/integration/sdk/flutter_bdui_guide.md): Этот гайд представляет собой пошаговое руководство по использованию gravity-sdk-flutter для реализации паттерна Backend-Driven UI (BDUI). BDUI — это мощный
- [Гайд: Headless-режим с Flutter SDK](https://docs.gravityfield.ai/integration/sdk/flutter_headless_guide.md): Этот гайд предназначен для разработчиков, которые хотят использовать возможности персонализации Gravity Field, но полностью контролировать UI и UX в своём Flutter-приложении.
- [Гайд: Прямая API-интеграция для Flutter](https://docs.gravityfield.ai/integration/sdk/flutter_api_integration_guide.md): Этот гайд предназначен для Flutter-разработчиков, которым нужен полный контроль над HTTP-вызовами, состоянием, рендерингом и трекингом кампаний Gravity Field без использования готового Flutter SDK UI-слоя.

## Сегментация

- [🧍 Аудитории](https://docs.gravityfield.ai/audiences/manage_auidences.md): Аудитория — это группа пользователей, объединённых общими признаками: поведением, характеристиками, местоположением и т.д. Вы можете создавать собственные аудитории и использовать их в разных сценариях: от персонализации контента до аналитики.
- [⏱ Атрибуция и период хранения](https://docs.gravityfield.ai/audiences/attribution_and_retention.md): Gravity Field позволяет управлять временем, в которое пользователь должен выполнить условия, и временем, сколько он будет оставаться в аудитории после этого.
- [🎁 Готовые аудитории](https://docs.gravityfield.ai/audiences/built_in_audiences.md): После создания аккаунта в Gravity Field в вашем проекте автоматически появляются преднастроенные аудитории. Их не нужно настраивать вручную — они сразу готовы к использованию в кампаниях, аналитике и сегментации.
- [Отчет по аудитории](https://docs.gravityfield.ai/audiences/audience_report.md): Отчет по аудитории позволяет узнать о размере аудитории, ее влиянии на ваши бизнес-показатели и поведении пользователей в аудитории. Хотя пользователи входят в аудитории в режиме реального времени, отчеты обновляются раз в день за ночь и не отображаются в реальном времени.
- [🧠 Принцип работы аудиторий в Gravity Field](https://docs.gravityfield.ai/audiences/audience_principles.md): Аудитория в Gravity Field не “держит” пользователя в режиме реального времени, а проверяется в момент нового запроса, когда:
- [Affinity аудитории](https://docs.gravityfield.ai/audiences/affinity_audiences.md): Каждое взаимодействие пользователя с сайтом или приложением — просмотр товара, добавление в корзину, покупка — сигнализирует о его предпочтениях. Особенно
- [🧍 Гайд по аудиториям: сценарии сегментации на основе поведения](https://docs.gravityfield.ai/audiences/audiences_guide.md): Этот гайд поможет быстро создавать аудитории под типовые e-commerce задачи: реактивация, работа с VIP-клиентами, частыми покупателями и т.д.
- [Источники трафика](https://docs.gravityfield.ai/audiences/traffic_sources.md): Типы источников трафика:

## Персонализация

### Кампании

- [Начало работы](https://docs.gravityfield.ai/personalization/campaigns/campaign_structure.md): Кампания в Gravity Field — это контейнер, в котором объединяются сценарии, управляющие показом персонализированного контента на сайте или в мобильном приложении.
- [Типы кампаний](https://docs.gravityfield.ai/personalization/campaigns/campaign_web_types.md): Кампании позволяют внедрять ключевые элементы роста и повышения конверсии в e-commerce: от рекомендательных блоков и social proof до промо-баннеров и кастомной коммуникации.

#### Создание кампаний

- [Рекомендательный виджет](https://docs.gravityfield.ai/personalization/campaigns/campaigns_create/create_rec_web_campaign.md): Рекомендательные кампании отображают наиболее релевантные элементы для каждого пользователя. Рекомендательная стратегия принимает решения на основе выбранных вами алгоритмов, данных, поведения пользователей.
- [Custom code](https://docs.gravityfield.ai/personalization/campaigns/campaigns_create/create_custom_code.md): В данном гайде описан процесс создания рекомедательного виджета через кампанию типа Custom code и создания шаблона для последующего его переиспользования.
- [🔌 Как создать рекомендательную API-кампанию](https://docs.gravityfield.ai/personalization/campaigns/campaigns_create/create_rec_api_campaign.md): В этом гайде разберём, как создать API-кампанию в Gravity Field, которая будет рекомендовать товары к конкретному товару на странице. Такой сценарий часто используется на карточке товара (PDP) — чтобы показать похожие или сопутствующие товары.
- [🔌 Создание WEB-кампании в Gravity Field](https://docs.gravityfield.ai/personalization/campaigns/create_web_campaigns.md): Эта инструкция поможет запустить персонализированные веб-кампании через платформу Gravity Field. Здесь описаны все основные шаги, которые необходимы для создания и полноценного запуска любой веб-кампании: от подготовки шаблона до активации.

#### Кампании в приложении

- [Кампании в приложении: начало работы](https://docs.gravityfield.ai/personalization/campaigns/app_campaigns/getting_started.md): Кампании в приложении позволяют управлять персонализированными сообщениями, inline-блоками и рекомендациями в мобильном приложении через Gravity Field.
- [Кастомизация in-app кампаний](https://docs.gravityfield.ai/personalization/campaigns/app_campaigns/in_app_customization.md): Визуальный редактор in-app кампаний позволяет собрать сообщение для мобильного приложения без разработки нового экрана. На этой странице перечислены основные форматы, элементы и параметры кастомизации.
- [🔌 Создание API-кампании в Gravity Field](https://docs.gravityfield.ai/personalization/campaigns/api_campaigns.md): Эта инструкция поможет продактам, маркетологам и разработчикам создать и запустить API-кампанию — кампанию, где контент возвращается в виде JSON, а рендеринг реализуется на стороне клиента (вашего сайта или приложения).
- [Тестирование фич через API-кампании](https://docs.gravityfield.ai/personalization/campaigns/feature_testing_api_campaigns.md): Этот гайд помогает запустить A/B или мультивариативный тест для фичи, которую нельзя корректно протестировать обычной Web campaign. Например, если нужно сравнить несколько провайдеров поискового движка, алгоритмов ранжирования, серверных правил выдачи или другой backend-driven логики.
- [🧩 Работа с переменными в Gravity Field](https://docs.gravityfield.ai/personalization/campaigns/variables.md): Переменные позволяют сделать шаблоны кампаний гибкими и удобными для редактирования — прямо из интерфейса, без вмешательства разработчиков.
- [🎯 Настройка таргетинга в Gravity Field](https://docs.gravityfield.ai/personalization/campaigns/targeting_schedule.md): Таргетинг определяет, кому, где и когда можно показать сценарий кампании. Он помогает запускать персонализацию только для нужных пользователей, в нужном контексте и в нужный момент.
- [🛍 Персонализация листинга товаров (PLP) в Gravity Field](https://docs.gravityfield.ai/personalization/campaigns/plp.md): Модуль PLP (Product Listing Personalization) позволяет персонализировать выдачу товаров на странице категории в реальном времени — на основе поведения пользователя, рекомендательных алгоритмов и мерчандайзинговых правил.
- [📦 Готовые шаблоны (Gravity Templates)](https://docs.gravityfield.ai/personalization/campaigns/gravity_templates.md): Gravity Field предлагает набор готовых шаблонов для быстрого запуска кампаний. Каждый шаблон содержит визуальный код и настраиваемые переменные, чтобы адаптировать виджет под ваш бренд и задачу — без необходимости писать всё с нуля.
- [🧱 Шаблоны в Gravity Field](https://docs.gravityfield.ai/personalization/campaigns/templates.md): Функциональность шаблонов помогает командам запускать кампании быстрее, без лишнего кода и участия разработчиков. Один раз настроенный шаблон можно многократно использовать в разных кампаниях.
- [🧠 Эвалюаторы](https://docs.gravityfield.ai/personalization/campaigns/evaluators.md): Эвалюаторы — это кастомные JavaScript-функции, которые позволяют гибко управлять персонализацией на основе данных со страницы. С их помощью вы можете реализовать любую бизнес-логику, которая зависит от контекста, пользовательских данных, структуры DOM или даже внешних API.

### Рекомендации

- [🧠 Рекомендательные стратегии](https://docs.gravityfield.ai/personalization/recs/manage_recs.md): Рекомендательная стратегия — это набор правил, который определяет, какие товары и в каком порядке будут показаны пользователю в блоках рекомендаций. Она объединяет один или несколько алгоритмов, фильтры и правила мерчандайзинга для создания персонализированной и релевантной товарной выдачи.
- [🤖 Алгоритмы рекомендаций](https://docs.gravityfield.ai/personalization/recs/algs_description.md): Алгоритмы формируют основу рекомендательных стратегий в Gravity Field. Каждый алгоритм отвечает за логику формирования товарной выдачи на основе поведения пользователя, контекста страницы и продуктового фида.
- [Функция "Алгоритм на слот"](https://docs.gravityfield.ai/personalization/recs/algorithm_per_slot.md): Функция "Алгоритм на слот" (Algorithm per slot) — это мощный инструмент для создания сложных рекомендательных стратегий, который позволяет назначать разные рекомендательные алгоритмы на разные позиции (слоты) в виджете.
- [Фильтры и правила мерчандайзинга](https://docs.gravityfield.ai/personalization/recs/filters_and_rules.md): Фильтры и правила мерчандайзинга — это мощные инструменты для управления товарной выдачей в рекомендательных стратегиях. Они позволяют сужать или изменять результаты работы алгоритмов для решения конкретных бизнес-задач.
- [👀 Превью рекомендательной стратегии](https://docs.gravityfield.ai/personalization/recs/strategy_preview.md): После настройки рекомендательной стратегии важно убедиться, что выдача товаров работает корректно — с учётом выбранного алгоритма, фильтров, пинов и прочих условий.
- [Получение расширенной информации об ответе стратегии (инструмент тестировщика)](https://docs.gravityfield.ai/personalization/recs/strategy_debug.md): Для проведения расширенного анализа ответов стратегии можно использовать запросы /recs с дополнительным параметром explain=true.
- [🧬 Affinity-профиль](https://docs.gravityfield.ai/personalization/recs/affinity_profile.md): Профиль аффинитивности пользователя собирается для каждого пользователя на основании:

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

- [Выбор основной метрики](https://docs.gravityfield.ai/personalization/ab-testing/primary_metric.md): Основная метрика определяет, как измеряется эффективность каждого сценария и что считается его успехом. Её влияние зависит от выбранного метода
- [Распределение трафика](https://docs.gravityfield.ai/personalization/ab-testing/traffic_allocation.md): Gravity Field предоставляет 2 режима для распределения трафика между вашими вариантами: A/B тестирование и Автопилот (Dynamic allocation). Эта статья описывает доступные режимы, случаи их использования.
- [Версии тестов](https://docs.gravityfield.ai/personalization/ab-testing/versions.md): Для обеспечения чистоты и надежности результатов тестирования каждый А/Б тест управляется с использованием версий. Это позволяет вносить изменения в текущий тест, не смешивая данные до и после изменения, что могло бы повлиять на итоговые результаты.
- [Probability to be best](https://docs.gravityfield.ai/personalization/ab-testing/probability_to_be_best.md): Байесовский подход основан на теореме Байеса, которая использует предыдущие знания или ожидания и обновляет их с учётом новых данных. В контексте
- [Определение победителя](https://docs.gravityfield.ai/personalization/ab-testing/winner_declaration.md): Для определения победителя в АБ-тесте система анализирует результаты эксперимента на основе следующих критериев:
- [Автопилот (Dynamic allocation)](https://docs.gravityfield.ai/personalization/ab-testing/dynamic_allocation.md): Динамическая аллокация — один из методов распределения трафика, в котором система автоматически определяет, какому проценту пользователей будет показываться та или иная вариация.
- [А/А тестирование](https://docs.gravityfield.ai/personalization/ab-testing/aa_testing.md): Одним из методов проверки достоверности результатов A/B-тестирования является A/A-тестирование. Принцип A/A-тестирования состоит в создании двух и более одинаковых вариаций и запуск с ними A/B-тестирования для проверки того, насколько корректно система работает с кампаниями.
- [Статистические выбросы](https://docs.gravityfield.ai/personalization/ab-testing/outliers.md): Платформа персонализации Gravity Field позволяет исключать статистические выбросы как в разрезе пользователей с экстремальным числом конверсий, так и в разрезе монетарных показателей.

### Аналитика

- [Обзор отчетов в Gravity Field](https://docs.gravityfield.ai/personalization/reports/getting_started.md): Эта статья описывает все доступные отчеты в платформе Gravity Field: где их найти, что они показывают и как использовать их для принятия решений. Подходит для рекомендательных и нерекомендательных кампаний.
- [📊 Отчёт по стратегиям рекомендаций](https://docs.gravityfield.ai/personalization/reports/recs_reports.md): Эта статья поможет вам анализировать эффективность рекомендательных стратегий в платформе Gravity Field. Отчёт отражает работу самих стратегий — вне зависимости от того, участвуют ли они в A/B тестах.
- [Гайд: как анализировать нерекомендательные кампании](https://docs.gravityfield.ai/personalization/reports/non_recs_campaigns_guide.md): Эта статья поможет вам проанализировать результаты A/B и мультивариативных тестов в нерекомендательных кампаниях: от метрик до принятия решений.
- [Гайд: как анализировать рекомендательные кампании](https://docs.gravityfield.ai/personalization/reports/recs_campaigns_guide.md): Этот гайд поможет вам проанализировать результаты A/B или мультивариативных тестов для кампаний, использующих рекомендательные виджеты. Он охватывает весь процесс: от проверки настройки до анализа стратегий и принятия решений.
- [Глобальная контрольная группа](https://docs.gravityfield.ai/personalization/reports/global_control_group.md): В рамках данного документа под глобальной контрольной группой (Global Control Group – GCG) подразумевается некий процент пользователей (мы рекомендуем 10%), которые не видят ни одной кампании Gravity Field, включая рекомендательные виджеты.
- [Цели](https://docs.gravityfield.ai/personalization/reports/goals.md): Цели — это инструмент, позволяющий отследить конкретные действия пользователя. Их можно задать на основе событий (Events), посещений страниц (pageView).
- [Отчёт по выручке в платформе Gravity Field](https://docs.gravityfield.ai/personalization/reports/revenue_report.md): Платформа Gravity Field позволяет запускать рекомендательные и нерекомендательные кампании, проводить A/B и мультивариативные тесты, а также собирать метрики по эффективности.
- [🧭 Атрибуция в отчётах](https://docs.gravityfield.ai/personalization/reports/attribution-in-reports.md): Эта статья описывает логику атрибуции в двух случаях:
- [Почему не загружается отчет по сценарию (A/B тесту)](https://docs.gravityfield.ai/personalization/reports/troubleshoot.md): Если вы открыли отчет, но он не содержит данных или бесконечно загружается — это не всегда ошибка. Ниже описаны распространённые причины и способы диагностики.
- [📊 Метрики в отчетах Gravity Field](https://docs.gravityfield.ai/personalization/reports/metrics.md): Gravity Field отслеживает и рассчитывает ключевые метрики эффективности для кампаний и стратегий рекомендаций. Ниже собраны все метрики с пояснением того, как именно они считаются.

## Shopping Assistant

- [Интеграция Shopping Assistant по API](https://docs.gravityfield.ai/shopping_assistant/integration.md): Shopping Assistant - это AI-помощник для покупателей. Он ведет диалог, уточняет потребность, помогает выбрать подходящие товары из каталога и возвращает результат в структурированном формате для отображения в клиентском интерфейсе.
- [Трекинг событий Shopping Assistant](https://docs.gravityfield.ai/shopping_assistant/tracking.md): Для анализа качества Shopping Assistant передавайте в Gravity Field custom events по ключевым шагам диалога. Эти события помогают понять, открывают ли пользователи чат, отправляют ли сообщения, получают ли ответы и где возникают ошибки или разрывы воронки.

## Retail media

- [🌐 Интеграция рекламной платформы](https://docs.gravityfield.ai/retail_media/integration.md): Ниже описаны шаги для внедрения рекламной платформы на вашем сайте или приложении. Некоторые этапы требуют принятия решений, например, выбор способа передачи событий и запуска кампаний: через JS-скрипт, API или SDK.

## Импорт & Экспорт данных

- [Импорт транзакций](https://docs.gravityfield.ai/data_import/import_offline_data.md): Данные по покупкам пользователей используются рекомендательной платформой в работе ряда стратегий и влияют на большинство рекомендательных алгоритмов.
- [Экспорт сырых данных ](https://docs.gravityfield.ai/data_import/export_raw_data.md): Эта статья описывает CSV-файлы с сырыми событиями Gravity Field: где они лежат, какие поля есть в выгрузке и какие технические ограничения важно учитывать перед импортом в BI.
- [Как воспроизвести отчеты из raw data](https://docs.gravityfield.ai/data_import/reproduce_reports_from_raw_data.md): Эта статья описывает, как построить в BI расчеты, близкие к отчетам Gravity Field, используя только CSV из экспорта сырых данных.
- [Экспорт заказов](https://docs.gravityfield.ai/data_import/export_direct_purchases.md): В отчете по рекомендательным стратегиям, вы можете скачать файл с заказами, которые оформили из рекомендательных виджетов.

## Обновления продукта

- [Обновления продукта](https://docs.gravityfield.ai/blog/index.md): Новости Gravity Field: релизы платформы, SDK, аналитики, персонализации и рекламных инструментов.
- [Июль '26. Запускайте собственные рекомендательные алгоритмы через Gravity Field](https://docs.gravityfield.ai/blog/2026-07-15-byoa-recommendation-algorithms.md): Собственные рекомендательные алгоритмы в Gravity Field
- [Июль '26. AI Experience Builder: интерактивные механики в e-commerce без спецпроекта](https://docs.gravityfield.ai/blog/2026-07-09-ai-experience-builder.md): AI Experience Builder
- [Июль '26. Обзор диалогов Shopping Assistant для развития ассистента](https://docs.gravityfield.ai/blog/2026-07-03-shopping-assistant-dialog-overview.md): Обзор диалогов Shopping Assistant
- [Июнь '26. iOS SDK 1.0.6: блокировка показа in-app кампаний](https://docs.gravityfield.ai/blog/2026-06-29-ios-sdk-106.md): В iOS SDK 1.0.6 добавлена блокировка показа in-app кампаний. Теперь приложение может временно запретить автопоказ Gravity-кампаний, пока пользователь взаимодействует с важным элементом интерфейса: собственной модалкой, bottom sheet, onboarding, checkout или другим приоритетным сценарием.
- [Июнь '26. Android SDK: персонализация лучше встраивается в интерфейс приложения](https://docs.gravityfield.ai/blog/2026-06-09-android-sdk-103.md): В версии 1.0.3 Android SDK стало проще встраивать персонализацию в насыщенные экраны приложения: несколько inline-блоков могут загружаться одновременно и
- [Май '26. Новый личный кабинет и no-code редактор мобильных in-app кампаний](https://docs.gravityfield.ai/blog/2026-05-12-dashboard-campaign-editor.md): Новый личный кабинет Gravity Field
- [Май '26. Мобильные SDK: точнее персонализация в приложении и проще интеграция iOS](https://docs.gravityfield.ai/blog/2026-05-01-mobile-sdk-personalization-ios.md): Во Flutter SDK добавлена возможность сбрасывать сохранённого пользователя и сессию перед новым запросом рекомендаций.
- [Апрель '26. iOS и Flutter SDK: рекомендательные виджеты, tooltip-кампании и in-app поведение](https://docs.gravityfield.ai/blog/2026-04-01-ios-flutter-sdk-updates.md): В iOS SDK 0.0.9 зафиксирован публичный сценарий для рекомендательных виджетов через getContentBySelector(...). Теперь клиентское приложение может получать
- [Март '26. SDK: приоритет кампаний, JSON-контент и стабильность UI](https://docs.gravityfield.ai/blog/2026-03-01-sdk-priority-json-ui.md): В SDK появилось управление приоритетом кампаний и задержкой показов для in-app форматов. Теперь можно определить, какая кампания должна отображаться первой, если на одном экране или событии срабатывает несколько сценариев, и через какое время после триггера показать сообщение пользователю.
- [Декабрь '25. Flutter SDK: headless режим](https://docs.gravityfield.ai/blog/2025-12-01-flutter-sdk-headless.md): Поддержка Headless-режима — это шаг, который позволяет полностью контролировать UI. Вместо готовых виджетов SDK отправляет JSON с контентом и логикой, а отображение интерфейса реализуется самостоятельно.
- [Ноябрь '25. Flutter SDK: настройка уровней логирования, товарный виджет в виде сетки](https://docs.gravityfield.ai/blog/2025-11-01-flutter-sdk-logging-grid.md): Добавлена возможность гибко управлять детализацией логов SDK для упрощения отладки и мониторинга.
- [Октябрь '25. Поддержка мультивиджет-кампаний, Контроль частоты показов, расширенная кастомизация in-app, таргетинг по версиям и аналитика по источникам данных](https://docs.gravityfield.ai/blog/2025-10-01-multiwidget-frequency-in-app.md): В GravityInlineWidget для Flutter SDK добавлен новый опциональный параметр placeholderId. Это позволяет отображать несколько разных виджетов из одной кампании на одном экране, используя один и тот же selector, но разные placeholderId.
- [Июль ‘25. Новые условия таргетинга: CUID, Push Permission, Tracking Status](https://docs.gravityfield.ai/blog/2025-07-01-targeting-cuid-push-tracking.md): В платформе появились три новых условия для таргетинга кампаний и создания аудиторий:
- [Май ‘25. Платформа мобильного маркетинга](https://docs.gravityfield.ai/blog/2025-05-01-mobile-marketing-platform.md): Gravity Field теперь помогает запускать персонализированные кампании и вовлекающие сценарии внутри мобильных приложений.
- [Январь ‘25. Аффинити аудитории, мультивиджет, таргетинг по составу корзины](https://docs.gravityfield.ai/blog/2025-01-01-affinity-multiwidget-cart-targeting.md): С помощью условия User Affinity, легко сегментировать клиентов по предпочтениями к определенным брендам, цветам, категориям и другим атрибутам товаров.
- [Август ‘24. Обновление главной, сводка по А/Б тесту, превью стратегии](https://docs.gravityfield.ai/blog/2024-08-01-home-ab-summary-strategy-preview.md): Мы сделали главную страницу еще более информативной: теперь можно сразу перейти к созданию кампании или настроить новую рекомендательную стратегию.
- [Апрель ‘24. Уведомление о победителе в A/B тесте, Персонализация страницы категории](https://docs.gravityfield.ai/blog/2024-04-01-ab-winner-category-personalization.md): Приходилось проверять каждый тест на наличие победителя? С ростом количества тестов это становится проблемой.
- [Март ‘24. Новые условия для сегментации и таргетинга, заголовки для табов, UX гипотезы](https://docs.gravityfield.ai/blog/2024-03-01-segmentation-targeting-tabs-ux.md): OS
- [Февраль ‘24. Выбор элемента на сайте, хлебные крошки, фильтр по лейблам, динамическая аллокация, экспертиза](https://docs.gravityfield.ai/blog/2024-02-01-site-element-breadcrumbs-dynamic-allocation.md): Теперь чтобы протестировать альтернативную версию элемента на сайте достаточно кликнуть по нужному элементу.
- [Январь ‘24. Ускорение отчетов по A/B тестам, новые метрики](https://docs.gravityfield.ai/blog/2024-01-01-ab-reports-new-metrics.md): Раньше отчеты по А/Б тестам с большим количеством данных долго грузились, а иногда и вовсе не загружались.