Стратегии — это основанный на правилах движок пользовательских сценариев и рекомендаций товаров в Aftersell. Отдельная стратегия — это набор правил таргетинга, которые оценивают контекст покупателя (товары в корзине, атрибуты клиента, UTM-параметры и многое другое) и возвращают полностью обогащенные рекомендации товаров в реальном времени.
В отличие от статических виджетов рекомендаций, стратегии дают вам полный контроль над тем, какие товары показываются каким покупателям и когда. Вы можете использовать их для карусели апселлов, блоков кросс-селла, post-purchase предложений или любого пользовательского сценария в магазине Shopify.
- Вы создаете стратегию — стратегию, содержащую одно или несколько правил, каждое с триггерами (предикатами) и набором товаров, рекомендуемых при срабатывании этих триггеров.
- Ваш витринный сайт отправляет контекст — когда страница загружается или корзина обновляется, витрина отправляет текущие данные о товаре, корзине, клиенте и сессии в API стратегий.
- Движок выполняет оценку — движок правил Aftersell оценивает каждое правило стратегии по предоставленному контексту и возвращает полностью обогащенные товары с названиями, ценами, изображениями, вариантами и доступностью.
- Вы отображаете результаты — ответ API содержит все необходимое для непосредственного показа рекомендаций. Дополнительные вызовы API Shopify не требуются.
Стратегия — именованный набор правил, оцениваемых вместе. У каждой стратегии есть уникальный ID (24-символьная шестнадцатеричная строка), на который вы ссылаетесь при вызове API.
Шаг — иерархическая последовательность оценки внутри стратегии. Правила оцениваются в порядке шагов, поэтому действия шага 1 имеют приоритет над действиями шага 2.
Правило — одна пара «триггер—действие» внутри стратегии. Правило определяет, когда оно должно сработать (например, «корзина содержит товар с тегом summer»), и затем соответствующий сценарий для отображения.
Триггер — предикат, прикрепленный к правилу. Триггеры могут таргетироваться на атрибуты товара, свойства корзины, данные клиента, параметры сессии/UTM и метаполя товара.
Действие — результат, прикрепленный к правилу. Действия возвращают подборку обогащенных товаров, параметры сортировки и фильтрации, а также метаданные.
Catch all — специальное правило, срабатывающее автоматически, когда ни одно другое правило стратегии не совпало. У него нет триггеров, и оно всегда является финальным шагом оценки. Когда оно включено, оно гарантирует, что слот рекомендаций никогда не будет пустым, и может быть настроено с любым типом действия, доступным обычным правилам.
Предварительные требования
- Активный магазин Shopify с установленным приложением Aftersell.
- Доступ к дашборду Aftersell (здесь вы будете создавать стратегии и генерировать API-ключи).
- Стратегии, включенные в вашем магазине. Стратегии включены не во всех магазинах — если вы не видите Settings → Product Strategy в дашборде, свяжитесь со службой поддержки или вашим менеджером, чтобы включить их.
Шаг 1: сгенерируйте API-ключ
API-ключи привязаны к одному магазину и обязательны для всех запросов к API стратегий. В дашборде ключ называется Security Token — это значение, которое вы отправляете в заголовке X-Strategy-Api-Key.
- Войдите в дашборд Aftersell.
- Перейдите в Settings в левой боковой панели.
- Откройте Product Strategy.
- В карточке Security Token нажмите Generate Token.
- Скопируйте ключ сразу — он показывается только один раз и не может быть получен позднее. Хранится только односторонний хеш.
Храните ваш API-ключ в безопасности. Ключ в открытом виде возвращается один раз в момент генерации. Если вы его потеряете, потребуется сгенерировать новый. Генерация нового ключа автоматически отзывает предыдущий — одновременно может быть активен только один API-ключ на магазин. Любые интеграции, использующие старый ключ, немедленно перестанут работать.
Шаг 2: создайте свою первую стратегию
Вы можете создавать стратегии полностью через интерфейс Aftersell — код не требуется. См. пошаговое руководство Создание стратегий в приложении.
Шаг 3: интегрируйте с вашей витриной
Когда у вас есть стратегия и API-ключ, вы можете вызывать эндпоинт Evaluate с вашей витрины для получения рекомендаций.