Skip to main content
このページは、戦略エディターを支える完全なカタログです。すべてのトリガーとそれぞれで使用できる演算子、すべてのアクション、グローバルフィルター、戦略の評価方法を掲載しています。戦略の作成のウォークスルーと対になるページで、特定のオプションについて網羅的な詳細が必要なときに参照してください。 ルールは、トリガー(いつ)とアクション(何を)を組み合わせたものです。1つの AND / OR トグルの下に最大5つのトリガーを組み合わせることができ、AND ではすべてのトリガーが一致する必要があり、OR ではいずれか1つが一致すれば十分です。以下のセクションもこの構成に沿っています。まずトリガーとアクション、次にすべてのルールに適用される戦略レベルのコントロールとして、ルールの順序、グローバルフィルター、Catch all を説明します。

トリガー

トリガーは、ルールがいつ発火するかを決めます。利用可能なトリガータイプは次のとおりです。

商品トリガー

コンテキスト内の商品(ショッパーのカート、完了したばかりの注文、または閲覧中の商品)に基づいてターゲティングします。
  • Specific product(s) - ID で特定の Shopify 商品に一致します
  • Collection - 特定のコレクションに属する商品に一致します
  • Tag(s) - 特定のタグ(例:「sale」、「summer」)を持つ商品に一致します
  • Title - 商品タイトルに一致します
  • Vendor - ベンダー/ブランド名に一致します
  • Type - 商品タイプのフィールド(例:「Apparel」、「Electronics」)に一致します
  • Handle - 商品 URL のスラッグに一致します
  • Metafield - カスタムメタフィールドのネームスペース/キー/値の組み合わせに一致します
  • Selling plan - 「subscription」または「one-time」の商品に一致します。リクエストのコンテキストに商品の販売プランが含まれている場合にのみ評価されます。Aftersell のチェックアウトと購入後アップセルのサーフェスはこれを送信しないため、カスタム連携で明示的に指定しない限り、これらのサーフェスではこのトリガーは一致しません

顧客トリガー

ショッパーが誰であるかに基づいてターゲティングします。
  • Customer tag - 例:「VIP」、「loyalty-gold」
  • Country code - 請求先の国
  • Province code - 請求先の州/都道府県
  • Locale - 顧客のロケール(例:「en-US」)
  • Accepts marketing - マーケティングのオプトイン状況
  • Order count - 過去の注文数
  • Total spent - 累計購入金額

カートトリガー

カート全体の状態に基づいてターゲティングします。
  • Cart subtotal - 例:小計が $50 を超える
  • Item count - カート内のアイテムの合計数量
  • Line count - 個別のラインアイテムの数
  • Cart attribute - Shopify のカート API で設定されたカスタムのカート属性
  • Cart note - カートのメモフィールド

ロケーショントリガー

ショッパーの配送先とストアの通貨に基づいてターゲティングします。
  • Shipping country - 配送先の国
  • Shipping province - 配送先の州/都道府県
  • Shipping method - 選択された配送方法
  • Store currency - 有効なストア通貨のコード

マーケティングトリガー

ショッパーが訪れたページの URL に基づいてターゲティングします。
  • URL - ランディング URL の部分文字列に一致します。URL に埋め込まれたパラメーター(例:utm_source=newsletter)に一致させることで、特定のキャンペーンやチャネルをターゲティングできます

時間トリガー

リクエストが評価された時刻(ストアの時間)に基づいてターゲティングします。
  • Day of week - 現在の曜日
  • Hour of day - 現在の時間

動的トリガー

  • Always match - 条件がなく常に発火するトリガー。すべてのリクエストでルールを実行させたい場合に使用します(これは、他のどのルールも一致しない場合にのみ発火する戦略レベルの Catch all とは異なります)。
すべてのトリガーがすべてのサーフェスで値を持つわけではありません。たとえばチェックアウトは商品とカートのコンテキストのみを送信するため、顧客、ロケーション、マーケティングのトリガーは一致しません。各サーフェスが送信する内容については、戦略の実装ガイドを参照してください。

演算子

各トリガーは、値の一致方法を定義する演算子を使用します。利用可能な演算子はトリガータイプによって異なります。 すべての演算子がすべてのトリガーで使用できるわけではありません。
  • リスト演算子(Contains any / all とその否定)は、タグ、コレクション、顧客タグ、特定の商品などの複数値フィールドに適用されます。
  • テキスト演算子(Equals、Contains とその否定)は、タイトル、ベンダー、ハンドル、ロケール、国、URL などの単一値のテキストフィールドに適用されます。
  • 数値演算子は、カートの小計、アイテム数、ライン数、注文数、累計購入金額、時間などのフィールドに適用されます。数値演算子には「does not」の否定形はありません。
  • いくつかのフィールドは Equals と Does not equal のみをサポートします:販売プラン、曜日、マーケティングの受け入れ。

アクション

アクションは、顧客に届けたい体験を作り出します。ここで、どの商品を表示するか、どのように表示するか、商品と一緒に渡す追加データを決めます。1つのルールに複数のアクションを組み合わせて設定し、完全な体験を構築できます。 ルールごとに、設定されたすべてのアクションが1つの統合されたプールに商品を提供します。たとえば、特定の商品アクション、コレクションアクション、タグベースのアクションを持つルールは、3つのソースすべての商品をまとめて返します。商品が複数のソースに一致する場合は、重複が除去されます。

商品アクション

トリガー側で使用できるのと同じ商品属性を、アクションの定義でも使用できます。次の条件に基づいて商品を返すことができます。
  • Specific products - Shopify カタログから個々の商品を手動で選びます。
  • Collection - 特定のコレクションに属するすべての商品を返します。
  • Product attributes - タグ、ベンダー、商品タイプ、メタフィールドなどの条件(トリガーで使用するのと同じ属性タイプ)に一致する商品を返します。

動的アクション

動的アクションは、固定の商品リストではなく、リアルタイムのシグナルに基づいて返す内容を変えます。利用可能な動的アクションのタイプは次のとおりです。
  • Most popular - 販売数量に基づくストアで最もパフォーマンスの高い商品。ストア全体またはコレクションに絞って指定できます。
  • Recently purchased - ストア全体で最近購入された商品。
  • Inherit from when - ルール自身のトリガー(「いつ」)を商品セレクターとして再利用し、ルールが発火したのと同じ条件に一致する商品を返します。
  • AI Recommendations - Aftersell のレコメンデーションモデルが生成するパーソナライズされた提案。

フィルタリングアクション

商品プールが組み立てられた後、返される商品の数と順序を設定できます。
  • Sort - どの商品を選択するかを制御します。
    • Random - ランダムに選択します。
    • Price: high → low - 最も高価な商品から返します。
    • Price: low → high - 最も安価な商品から返します。
  • Amount/Limit - 返す商品の最大数を設定します。
  • Type - 組み立てられた商品プールを単一の Shopify 商品タイプに絞り込みます。完全一致には Equals、部分一致には Contains を選択します(どちらも大文字と小文字を区別しません)。入力した値に商品タイプが一致する商品のみが残り、それ以外は Amount/Limit が適用される前に除外されます。
Type フィルターは、商品アクションによって組み立てられた商品プールを絞り込むものです。指定したタイプの商品を返す Product type 商品アクションとは異なります。より広範なアクション(コレクションや動的アクションなど)が返せる内容を制限したい場合にフィルターを使用してください。
Sort が最初に適用され、次に Amount/Limit が適用されます。たとえば、ソートを Random に設定している場合、上限が適用される前に商品プール全体がランダム化されます。そのため、同じ商品がランダムな順序で返されるのではなく、常にランダムに抽出された一部が返されます。

キーバリューアクション

必要に応じて、ルールにキーと値のペアを添付できます。ルールが一致すると、これらは API レスポンスの meta.data で商品の結果と一緒に返されます。一般的な用途は次のとおりです。
  • プロモーションバナーのテキスト
  • 分析用のキャンペーンラベル
複数のルールが一致して同じキーを出力する場合、最初に一致したルールの値が優先され、後続のルールで上書きすることはできません。

ルールの優先度と評価順序

戦略内のルールは、1ステップずつ順番に評価されます。ステップ1が最初に評価され、以降も同様です。戦略エディターでルールをドラッグ&ドロップして並べ替えることができます。評価エンジンは次のように動作します。
  1. 提供されたコンテキストに対して各ルールのトリガーを評価します。
  2. 一致したすべてのルールから商品を収集します。
  3. 重複を除去し、結果を設定された最大数(デフォルト:20商品)に制限します。

グローバルフィルター

グローバルフィルターは、戦略内のすべてのルールにわたって、商品を選択の対象から除外します。戦略エディターの左上にある戦略名の横のフィルターアイコンからアクセスできます。 利用可能なグローバルフィルター:
  • Exclude out of stock - 現在購入できない商品を自動的に除外します。
  • Exclude input products - ルールをトリガーした商品(例:ショッパーが PDP で現在閲覧している商品)を除外し、ショッパーがすでに見ている商品を推薦しないようにします。
  • Exclude by product tag - 特定のタグが付いた商品を除外します。
  • Exclude by metafield - 特定のメタフィールドのネームスペース/キー/値に一致する商品を除外します。
  • Exclude by product ID - ID で特定の商品を除外します。
  • Require stock at location - 選択したロケーションに在庫がある商品のみを残します(在庫とロケーションの読み取り権限が必要です)。

Catch all

Catch all は、すべての戦略評価の最終ステップとして機能する特別なルールです。トリガーはなく、戦略内の他のどのルールも現在のリクエストに一致しない場合に自動的に発火します。 有効にすると、Catch all によってレコメンデーション枠が空になることはありません。そのアクションは、通常のルールで使用できるのと同じアクションタイプ(特定の商品、コレクション、動的アクションなど)を使って設定できます。
  • 有効化/無効化 - 戦略の Catch all ルールのオン/オフを切り替えます。無効にすると、どのルールにも一致しないリクエストは空の結果を返します。
  • アクションの設定 - 他のルールと同様に、利用可能なアクションタイプを自由に組み合わせて返す内容を定義します。
Catch all が発火すると、API レスポンスに resolution.fallbackUsed: true が示されます。