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

戦略(Strategies)は、Aftersellのルールベースの体験・商品レコメンデーションエンジンです。個々の戦略は、ショッパーのコンテキスト(カート内の商品、顧客属性、UTMパラメーターなど)を評価し、完全にエンリッチされた商品レコメンデーションをリアルタイムで返すターゲティングルールの集合です。

静的なレコメンデーションウィジェットとは異なり、戦略では、\_どの\_商品を\_どの\_ショッパーに\_いつ\_表示するかを完全にコントロールできます。アップセルカルーセル、クロスセルブロック、購入後オファー、あるいはShopifyストア上のあらゆるカスタム体験の基盤として利用できます。

<div id="how-it-works">
  ### 仕組み
</div>

1. **戦略を作成する** — 1つ以上のルールを含む戦略を作成します。各ルールにはトリガー(述語)と、それらのトリガーがマッチしたときにおすすめする商品のセットがあります。
2. **ストアフロントがコンテキストを送信する** — ページの読み込み時やカートの更新時に、ストアフロントが現在の商品、カート、顧客、セッションのデータを戦略APIに送信します。
3. **エンジンが評価する** — Aftersellのルールエンジンが、提供されたコンテキストに対して戦略内のすべてのルールを評価し、タイトル、価格、画像、バリエーション、在庫状況を含む完全にエンリッチされた商品を返します。
4. **結果をレンダリングする** — APIレスポンスには、レコメンデーションを直接表示するために必要なものがすべて含まれています。追加のShopify API呼び出しは不要です。

<div id="key-concepts">
  ### 主要な概念
</div>

**Strategy(戦略)** — まとめて評価される、名前付きのルールの集合です。各戦略には一意のID(24文字の16進文字列)があり、API呼び出し時に参照します。

**Step(ステップ)** — 戦略内の階層的な評価シーケンスです。ルールはステップ順に評価されるため、ステップ1のアクションはステップ2のアクションより優先されます。

**Rule(ルール)** — 戦略内の単一のトリガーとアクションのペアです。ルールは、\_いつ\_マッチすべきか(例: 「カートに`summer`タグの付いた商品が含まれる」)と、\_その場合に\_レンダリングされる対応する体験を定義します。

**Trigger(トリガー)** — ルールに付随する述語です。トリガーは、商品属性、カートのプロパティ、顧客データ、セッション/UTMパラメーター、商品メタフィールドをターゲットにできます。

**Action(アクション)** — ルールに付随する結果です。アクションは、エンリッチされた商品の選択、並べ替えとフィルタリングのオプション、およびメタデータを返します。

**Catch all(キャッチオール)** — 戦略内の他のどのルールもマッチしなかった場合に自動的に発火する特別なルールです。トリガーを持たず、常に評価の最終ステップです。有効にすると、レコメンデーション枠が空になることがなくなり、通常のルールで利用可能な任意のアクションタイプで設定できます。

***

<div id="getting-started">
  ## はじめに
</div>

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

* Aftersellアプリがインストールされた、アクティブなShopifyストア。
* 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キーは1つだけです。古いキーを使用している連携は、即座に動作しなくなります。
</Warning>

<div id="step-2-create-your-first-strategy">
  ### ステップ2: 最初の戦略を作成する
</div>

戦略はAftersellのUIだけで完全に構築できます — コードは不要です。手順については[アプリ内での戦略の作成](/ja/aftersell/strategies_building_in_app)を参照してください。

<div id="step-3-integrate-with-your-storefront">
  ### ステップ3: ストアフロントと連携する
</div>

戦略とAPIキーが用意できたら、ストアフロントからEvaluateエンドポイントを呼び出してレコメンデーションを取得できます。