> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Обзор стратегий

> Узнайте, что такое стратегии, как они работают и как начать создавать интеллектуальные пользовательские сценарии.

<div id="what-are-strategies">
  ## Что такое стратегии?
</div>

Стратегии — это основанный на правилах движок пользовательских сценариев и рекомендаций товаров в Aftersell. Отдельная стратегия — это набор правил таргетинга, которые оценивают контекст покупателя (товары в корзине, атрибуты клиента, UTM-параметры и многое другое) и возвращают полностью обогащенные рекомендации товаров в реальном времени.

В отличие от статических виджетов рекомендаций, стратегии дают вам полный контроль над тем, *какие* товары показываются *каким* покупателям и *когда*. Вы можете использовать их для карусели апселлов, блоков кросс-селла, post-purchase предложений или любого пользовательского сценария в магазине Shopify.

<div id="how-it-works">
  ### Как это работает
</div>

1. **Вы создаете стратегию** — стратегию, содержащую одно или несколько правил, каждое с триггерами (предикатами) и набором товаров, рекомендуемых при срабатывании этих триггеров.
2. **Ваш витринный сайт отправляет контекст** — когда страница загружается или корзина обновляется, витрина отправляет текущие данные о товаре, корзине, клиенте и сессии в API стратегий.
3. **Движок выполняет оценку** — движок правил Aftersell оценивает каждое правило стратегии по предоставленному контексту и возвращает полностью обогащенные товары с названиями, ценами, изображениями, вариантами и доступностью.
4. **Вы отображаете результаты** — ответ API содержит все необходимое для непосредственного показа рекомендаций. Дополнительные вызовы API Shopify не требуются.

<div id="key-concepts">
  ### Ключевые понятия
</div>

**Стратегия** — именованный набор правил, оцениваемых вместе. У каждой стратегии есть уникальный ID (24-символьная шестнадцатеричная строка), на который вы ссылаетесь при вызове API.

**Шаг** — иерархическая последовательность оценки внутри стратегии. Правила оцениваются в порядке шагов, поэтому действия шага 1 имеют приоритет над действиями шага 2.

**Правило** — одна пара «триггер—действие» внутри стратегии. Правило определяет, *когда* оно должно сработать (например, «корзина содержит товар с тегом `summer`»), и *затем* соответствующий сценарий для отображения.

**Триггер** — предикат, прикрепленный к правилу. Триггеры могут таргетироваться на атрибуты товара, свойства корзины, данные клиента, параметры сессии/UTM и метаполя товара.

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

**Catch all** — специальное правило, срабатывающее автоматически, когда ни одно другое правило стратегии не совпало. У него нет триггеров, и оно всегда является финальным шагом оценки. Когда оно включено, оно гарантирует, что слот рекомендаций никогда не будет пустым, и может быть настроено с любым типом действия, доступным обычным правилам.

***

<div id="getting-started">
  ## Начало работы
</div>

<div id="prerequisites">
  ### Предварительные требования
</div>

* Активный магазин Shopify с установленным приложением Aftersell.
* Доступ к дашборду Aftersell (здесь вы будете создавать стратегии и генерировать API-ключи).
* Стратегии, включенные в вашем магазине. Стратегии включены не во всех магазинах — если вы не видите **Settings → Product Strategy** в дашборде, свяжитесь со службой поддержки или вашим менеджером, чтобы включить их.

<div id="step-1-generate-your-api-key">
  ### Шаг 1: сгенерируйте API-ключ
</div>

API-ключи привязаны к одному магазину и обязательны для всех запросов к API стратегий. В дашборде ключ называется **Security Token** — это значение, которое вы отправляете в заголовке `X-Strategy-Api-Key`.

1. Войдите в дашборд Aftersell.
2. Перейдите в **Settings** в левой боковой панели.
3. Откройте **Product Strategy**.
4. В карточке **Security Token** нажмите **Generate Token**.
5. Скопируйте ключ сразу — он показывается только один раз и не может быть получен позднее. Хранится только односторонний хеш.

<Warning>
  Храните ваш API-ключ в безопасности. Ключ в открытом виде возвращается **один раз** в момент генерации. Если вы его потеряете, потребуется сгенерировать новый. Генерация нового ключа автоматически отзывает предыдущий — одновременно может быть активен только один API-ключ на магазин. Любые интеграции, использующие старый ключ, немедленно перестанут работать.
</Warning>

<div id="step-2-create-your-first-strategy">
  ### Шаг 2: создайте свою первую стратегию
</div>

Вы можете создавать стратегии полностью через интерфейс Aftersell — код не требуется. См. пошаговое руководство [Создание стратегий в приложении](/ru/aftersell/strategies_building_in_app).

<div id="step-3-integrate-with-your-storefront">
  ### Шаг 3: интегрируйте с вашей витриной
</div>

Когда у вас есть стратегия и API-ключ, вы можете вызывать эндпоинт Evaluate с вашей витрины для получения рекомендаций.