> ## 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.

# 策略概览

> 了解什么是策略（Strategies）、它们如何工作，以及如何开始进行智能体验创建。

<div id="what-are-strategies">
  ## 什么是策略（Strategies）？
</div>

策略是 Aftersell 基于规则的体验和产品推荐引擎。单个策略是一组定向规则的集合，这些规则会评估购物者上下文（购物车中的产品、客户属性、UTM 参数等），并实时返回完整充实的产品推荐。

与静态推荐组件不同，策略让你完全掌控*哪些*产品在*何时*展示给*哪些*购物者。你可以用它来驱动 upsell 轮播、交叉销售模块、购后优惠，或 Shopify 商店上的任何自定义体验。

<div id="how-it-works">
  ### 工作原理
</div>

1. **你创建一个策略** — 一个包含一条或多条规则的策略，每条规则都有触发条件（谓词）以及在触发条件匹配时要推荐的一组产品。
2. **你的店面发送上下文** — 当页面加载或购物车更新时，你的店面会将当前的产品、购物车、客户和会话数据发送到 Strategies API。
3. **引擎进行评估** — Aftersell 的规则引擎根据提供的上下文评估策略中的每条规则，并返回包含标题、价格、图片、款式和库存状态的完整产品信息。
4. **你渲染结果** — API 响应包含直接展示推荐所需的一切。无需额外调用 Shopify API。

<div id="key-concepts">
  ### 核心概念
</div>

**Strategy（策略）** — 一组会被一起评估的、有名称的规则集合。每个策略都有一个唯一 ID（24 位十六进制字符串），调用 API 时需要引用它。

**Step（步骤）** — 策略内的层级评估序列。规则按步骤顺序评估，因此步骤 1 中的动作优先于步骤 2 中的动作。

**Rule（规则）** — 策略中的一个触发条件-动作组合。规则定义了它*何时*应该匹配（例如"购物车包含带有 `summer` 标签的产品"），*然后*要渲染的相应体验。

**Trigger（触发条件）** — 附加到规则上的谓词。触发条件可以定向产品属性、购物车属性、客户数据、会话/UTM 参数以及产品元字段。

**Action（动作）** — 附加到规则上的结果。动作会返回一组充实的产品信息、排序和筛选选项以及元数据。

**Catch all** — 一条特殊规则，当策略中没有其他规则匹配时自动生效。它没有触发条件，并且始终是评估的最后一步。启用后，它可确保推荐位永远不会为空，并且可以使用常规规则可用的任何动作类型进行配置。

***

<div id="getting-started">
  ## 快速开始
</div>

<div id="prerequisites">
  ### 前提条件
</div>

* 一个已安装 Aftersell 应用且处于活跃状态的 Shopify 商店。
* 拥有 Aftersell 控制台的访问权限（你将在这里创建策略并生成 API 密钥）。
* 你的商店已启用 Strategies。并非每个商店都默认开启 Strategies — 如果你在控制台中看不到 **Settings → Product Strategy**，请联系支持团队或你的客户经理为你启用。

<div id="step-1-generate-your-api-key">
  ### 第 1 步：生成你的 API 密钥
</div>

API 密钥的作用范围限定于单个商店，所有 Strategy 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 界面构建策略 — 无需编写代码。请参阅[在应用内构建策略](/zh/aftersell/strategies_building_in_app)了解完整流程。

<div id="step-3-integrate-with-your-storefront">
  ### 第 3 步：与你的店面集成
</div>

拥有策略和 API 密钥后，你就可以从店面调用 Evaluate 端点来获取推荐了。