トリガー
商品トリガー
- 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 に埋め込まれたパラメーター(例:
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 のみをサポートします:販売プラン、曜日、マーケティングの受け入れ。
アクション
商品アクション
- 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 に設定している場合、上限が適用される前に商品プール全体がランダム化されます。そのため、同じ商品がランダムな順序で返されるのではなく、常にランダムに抽出された一部が返されます。
キーバリューアクション
meta.data で商品の結果と一緒に返されます。一般的な用途は次のとおりです。
- プロモーションバナーのテキスト
- 分析用のキャンペーンラベル
複数のルールが一致して同じキーを出力する場合、最初に一致したルールの値が優先され、後続のルールで上書きすることはできません。
ルールの優先度と評価順序
- 提供されたコンテキストに対して各ルールのトリガーを評価します。
- 一致したすべてのルールから商品を収集します。
- 重複を除去し、結果を設定された最大数(デフォルト: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 ルールのオン/オフを切り替えます。無効にすると、どのルールにも一致しないリクエストは空の結果を返します。
- アクションの設定 - 他のルールと同様に、利用可能なアクションタイプを自由に組み合わせて返す内容を定義します。
resolution.fallbackUsed: true が示されます。