ヘルプ
ログイン

Shopify に基づく顧客セグメントフィルター

このリファレンスガイドでは、デフォルトの Shopify フィルターに基づいて顧客セグメントを構築するために使用されるフィルター名、演算子、値について説明します。

このページの内容

チェックアウト離脱日

名前： abandoned_checkout_date

お客様が最後にカートを放棄した日付別にお客様を絞り込みます。

演算子 特定の日付に等しい： =
特定の日付に等しくない： !=
特定の日付以前： <=
特定の日付より前： <
特定の日付以降： >=
特定の日付より後： >
期間指定： BETWEEN {date1} AND {date2}
存在しない： IS NULL
存在する： IS NOT NULL







値
形式 絶対日付： YYYY-MM-DD
日付オフセットの例： -4w、 -10y
指定された日付：
  • 今日： = today
  • 昨日： = yesterday
指定された日付はデフォルト値であり、変更することはできません。カスタムの日付を使用するには、日付オフセットを使用します。

例 過去1週間以内に最後にカートを放棄したお客様を絞り込む場合：
abandoned_checkout_date >= -7d

過去8か月以内に最後にカートを放棄したお客様を絞り込む場合：
abandoned_checkout_date > -8m



注日付の値は丸1日に基づいており、ストアのタイムゾーンによって異なります。

記念日

名前： anniversary

日付パラメーターに関連付けられているイベントの日付別にお客様を絞り込みます。

関数パラメーター 絞り込みの対象とするイベントを指定します。例： 'metafields.facts.birth_date'
演算子 IS NULL：パラメーターは存在しません。
IS NOT NULL：パラメーターは存在します。

日付に使用できる演算子は、次のとおりです。
次と等しい： =
次と等しくない： !=
次の期間内： BETWEEN





値 date
形式 絶対日付： YYYY-MM-DD
日付オフセットの例： +4w、 +3m
指定された日付または期間：
  • 今日： = today
  • 今後7日間： BETWEEN today AND +7d
  • 今後30日間： BETWEEN today AND +30d


例 今後30日以内に誕生日を迎えるお客様を絞り込む場合：
anniversary ('metafields.facts.birth_date') BETWEEN today AND +30d
注
  • この anniversary フィルターでは年は考慮されません。
  • 日付の値は丸1日に基づいており、ストアのタイムゾーンによって異なります。
  • 生年月日で絞り込むには、 facts.birth_date 標準メタフィールドを有効にするか、独自のカスタムメタフィールドを作成する必要があります。標準メタフィールドの追加やカスタムメタフィールド定義の作成について、詳しくはこちらをご覧ください。

利用額

名前： amount_spent

お客様がストアで利用した金額に基づいて、お客様を絞り込みます。

演算子 次と等しい： =
次と等しくない： !=
次より大きい： >
次より小さい： <
以下： <=
以上： >=
次の期間内： BETWEEN





値
形式 数値範囲： # AND #
数値： #
小数：小数点 (ピリオド) は、小数点記号として使用されます。
カンマやスペースなどの桁区切りは使用できません。
言語固有の形式の数字は使用できません。



例 ストアでの利用額が 1～999.99 のお客様を絞り込む場合：
amount_spent BETWEEN 1 AND 999.99
注
  • 使用される通貨は、ストアで選択されている通貨に基づきます。通貨記号を入力して使用する通貨を指定しないでください。
  • BETWEEN には、開始値と終了値の両方が含まれます。例えば、 amount_spent BETWEEN 1 AND 100 には、1以上100以下を利用したお客様が含まれます。

市区町村

名前： customer_cities

指定された市区町村に住所があるお客様を絞り込みます。複数の住所を持つお客様は、このフィルターを使用する複数の顧客セグメントに含まれる場合があります。

演算子 この市区町村を正確に含む： CONTAINS
この市区町村を正確に含まない： NOT CONTAINS
存在しない： IS NULL
存在する： IS NOT NULL


値
形式 countryCode-regionCode-cityCode
例 ニューヨーク市に住所があるお客様を絞り込む場合：
customer_cities CONTAINS 'US-NY-NewYorkCity'
注 市区町村を検索するには、市区町村名を入力し始め、表示されるリストから適切な値を選択します。

会社

名前： companies

B2Bのお客様として設定されている会社のお客様が含まれます。

演算子 この会社IDと完全に一致する： CONTAINS
この会社IDと完全に一致しない： NOT CONTAINS
存在しない： IS NULL
存在する： IS NOT NULL


値会社ID
形式
例 B2Bのお客様である：
companies IS NOT NULL
B2Bのお客様ではない：
companies IS NULL
特定の会社に所属するお客様を含む：
companies CONTAINS 3778915041302






注
  • 顧客セグメントを作成する際に、表示されるリストから会社を名前で選択できます。または、会社の名前の入力を開始してからリストから選択することもできます。
  • コードには会社名ではなく会社 IDが入力されます。会社 IDにカーソルを合わせると、会社名が表示されます。

国または地域

名前： customer_countries

指定した国または地域に住所があるお客様が含まれます。複数の住所を持つお客様は、このフィルターを使用する複数の顧客セグメントに含まれる可能性があります。

演算子 この国/地域と完全に一致する： CONTAINS
この国/地域と完全に一致しない： NOT CONTAINS
存在しない： IS NULL
存在する： IS NOT NULL


値 ISO 2文字の国コードを使用します。
形式
例 アメリカ合衆国に住所があるお客様を含める：
customer_countries CONTAINS 'US'
注 国を検索するには、国名の入力を開始してから、表示されるリストで該当する値を選択します。

作成元のアプリ ID

名前： created_by_app_id

指定したアプリで作成されたお客様が含まれます。

演算子 次と等しい： =
次と等しくない： !=
値セグメント化の対象となるアプリのID。
形式アプリID
例 Shopifyの管理画面で作成されたお客様を含める：
created_by_app_id = 1830279
注
  • 顧客セグメントを作成する際に、表示されるリストからアプリを名前で選択できます。または、アプリの名前の入力を開始してからリストから選択することもできます。
  • コードにはアプリ名ではなくアプリ IDが入力されます。アプリ IDにカーソルを合わせると、アプリ名が表示されます。

お客様アカウントのステータス

名前： customer_account_status

指定したお客様アカウントのステータスを持つお客様が含まれます。

演算子 次と等しい： =
次と等しくない： !=
値 辞退： 'DECLINED' お客様はアカウント作成の招待を受けましたが、辞退しました。
無効： 'DISABLED' お客様はアカウントを作成していないか、ストアで新しいお客様アカウントを使用しています。
有効： 'ENABLED' お客様はアカウントを作成しました。
招待済み： 'INVITED' お客様はアカウント作成の招待を受けましたが、まだ承諾も辞退もしていません。


形式
例 アカウント作成の招待を受けたが、辞退したお客様を含める：
customer_account_status = 'DECLINED'
注

顧客追加日

名前： customer_added_date

ストアにお客様が追加された日付に基づいて、お客様が含まれます。

演算子 特定の日付に等しい： =
特定の日付に等しくない： !=
特定の日付以前： <=
特定の日付より前： <
特定の日付以降： >=
特定の日付より後： >
期間指定： BETWEEN {date1} AND {date2}





値
形式 絶対日付： YYYY-MM-DD
日付オフセットの例： -4w、 -10y
指定された日付：
  • 今日： = today
  • 昨日： = yesterday
指定された日付はデフォルト値であり、変更することはできません。カスタムの日付を使用するには、日付オフセットを使用します。

例 過去1週間以内に追加されたお客様を含める：
customer_added_date >= -7d

過去8か月以内に追加されたお客様を含める：
customer_added_date > -8m

特定の日付範囲内に追加されたお客様を含める：
customer_added_date BETWEEN 2022-12-01 AND 2022-12-31






注 日付の値は丸1日に基づいており、ストアのタイムゾーンによって異なります。

お客様のメールのドメイン

名前： customer_email_domain

メールアドレスが指定したドメインに属しているお客様が含まれます。ドメイン名とは、メールアドレスの @ 記号より後の部分 (例：gmail.com) のことです。

演算子 次と等しい： =
次と等しくない： !=
存在しない： IS NULL
存在する： IS NOT NULL


値 以下のドメイン名は候補として提案されます。これらのドメイン名に限定されるわけではありません。他の有効なドメイン名も手動で入力できます。
  • Gmail： 'gmail.com'
  • Yahoo： 'yahoo.com' または 'yahoo.ca'
  • Hotmail： 'hotmail.com'
  • AOL： 'aol.com'
  • MSN： 'msn.com'
  • Live： 'live.com'
  • Outlook： 'outlook.com'
形式
例 メールのドメインが shopify.com のお客様を含める：
customer_email_domain = 'shopify.com'
注

お客様の言語

名前： customer_language

お客様がストアとのコミュニケーションで使用する言語に基づいて、お客様が含まれます。

演算子 次と等しい： =
次と等しくない： !=
存在しない： IS NULL
存在する： IS NOT NULL


値 ISO 639-1の2文字の言語コードを使用します。
形式 以下の値は、一般的なISO言語コードの例です。お客様のデータはこれらの言語コードに限定されません。他の有効な言語コードも手動で入力できますが、エディタで候補値として提案される値は、お客様のデータで利用可能な値のみです。
  • 英語： 'en'
  • フランス語： 'fr'
  • スペイン語： 'es'
  • ドイツ語： 'de'
  • イタリア語： 'it'
  • 日本語： 'ja'
  • ロシア語： 'ru'
例 ストアとのコミュニケーションで英語を使用するお客様を含める：
customer_language = 'en'

ストアとのコミュニケーションでカナダ英語を使用するお客様を除外する：
customer_language != 'en-CA'



注
  • ロケールのISOコードを値に追加して、その言語の方言を指定できます。たとえば、 'en-US' をアメリカ合衆国に、 'en-GB' をイギリスに使用するか、 'pt-PT' をポルトガルに、 'pt-BR' をブラジルに使用できます。
  • 言語のプレフィックスのみが指定されている場合、フィルター値はワイルドカードとして機能します。たとえば、フィルター値が 'en'の場合、結果には言語が 'en' に設定されているお客様と、言語が 'en-GB'、 'en-CA'に設定されているお客様などが含まれます。

顧客タグ

名前： customer_tags

タグに基づいてお客様を絞り込みます。

演算子 このタグと完全に一致する： CONTAINS
このタグと完全に一致しない： NOT CONTAINS
存在しない： IS NULL
存在する： IS NOT NULL


値顧客タグの名前。
形式
例 GoldStatus タグを持つお客様を絞り込む：
customer_tags CONTAINS 'GoldStatus'
注 タグでは、大文字と小文字は区別されません。
タグとその考慮事項に関する詳細情報。

指定距離内のお客様

名前： customer_within_distance

保存済みのロケーションから指定された距離内にいるお客様を絞り込みます。

関数パラメーター 各フィルターで使用できる距離パラメーターは 1 つのみです。
coordinates (必須)：このパラメーターを使用して、セグメントの作成に使用するピンのロケーションを指定します。
distance_km (必須)：このパラメーターを使用して、お客様を検索する半径距離を指定します。
distance_mi (必須)：このパラメーターを使用して、お客様を検索する半径距離を指定します。




演算子 MATCHES：パラメーターが true です。
NOT_MATCHES：パラメーターが false です。
IS NULL：パラメーターは存在しません。
IS NOT NULL：パラメーターが存在します。






値
形式 対応形式 coordinatesでサポートされている形式：
  • 数字 (緯度), 数字 (経度)

    • 座標 (緯度、経度) でサポートされている形式：
  • 数字：#

    • 対応形式 distance_mi、 distance_kmでサポートされている形式：
  • 数字：#




    • 例 このフィルターが有効であるためには、座標と 1 つの距離パラメーターが必要です。

    座標 (45.419190, -75.696727) から 10 マイル以内に住所があるお客様を絞り込む：
    customer_within_distance MATCHES (coordinates = (45.419190, -75.696727), distance_mi = 10 )

    このフィルターは他のフィルターと組み合わせて使用することで、顧客リストをさらに絞り込むことができます。例：
    座標 (43.634,-79.412) から 20 キロメートル以内に住所があり、1 件以上の注文をしたことがあるお客様を絞り込む：
    customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0






    注
    • このフィルターを使用すると、Shopify セグメンテーションによって保存済みのロケーションが座標ペアに自動変換され、選択可能な値として表示されます。
    • ストアに保存済みのロケーションがある場合、Shopify Magic は、Magic 翻訳で座標ペアをロケーション名に自動で翻訳します。例：「ロケーション 'Salt Lake City Store' から 10 マイル以内に住所があるお客様」

    メールイベント

    名前： shopify_email.EVENT

    選択したメールイベントに基づいてお客様を絞り込みます。サポートされているイベント (EVENT) は以下のとおりです。

    • バウンス済み：bounced
    • クリック済み：clicked
    • 配信済み：delivered
    • スパムとしてマーク済み：marked_as_spam
    • 開封済み：opened
    • サブスクリプション登録解除済み：unsubscribed
    関数パラメーター activity_id (任意)：このパラメーターを使用して、絞り込むマーケティングアクティビティ ID を選択します。
    count (任意)：このパラメーターを使用して、メールイベントが発生した回数を指定します。
    date (任意)：このパラメーターを使用して、イベントの日付を指定します。



    演算子 MATCHES：イベントが発生した場合に使用します。
    NOT_MATCHES：イベントが発生しなかった場合に使用します。
    IS NULL：パラメーターは存在しません。
    IS NOT NULL：パラメーターは存在します。

    日付に使用できる演算子は、次のとおりです。
    次と等しい： =
    次と等しくない： !=
    次より大きい： >
    次より小さい： <
    以下： <=
    以上： >=
    次の期間内： BETWEEN











    値
    形式対応形式 activity_idでサポートされている形式：
  • = (単一の値)
  • IN ：暗黙的な「OR」を含む、かっこで囲まれた、コンマ区切りの値のセット。例：(activity_id IN (1, 2, 3))。1 つのセットには、最大 500 個のアクティビティ ID を含めることができます。

    date でサポートされている日付形式：
  • 絶対日付： YYYY-MM-DD
  • 日付オフセットの例：
    • 7 日前： -7d
    • 4 週間前： -4w
    • 3 か月前： -3m
    • 1 年前： -1y
    • 名前付きの日付： today、 yesterday


    • 名前付きの日付はデフォルト値であり、変更することはできません。カスタムの日付を指定するには、日付オフセットを使用します。

    メールイベントは 2022 年 3 月以降のデータが対象となり、過去 26 か月分を利用できます。

    対応形式 countでサポートされている形式：
  • 数字： #











    • 例 メールイベントが発生したかどうかを指定するには、MATCHES または NOT MATCHES 演算子を使用します。
    shopify_email.opened MATCHES (activity_id = 135195754518)
    shopify_email.opened NOT MATCHES (activity_id = 135195754518)

    絞り込みたいマーケティングアクティビティ ID を指定するには、activity_id パラメーターを使用します。
    shopify_email.delivered MATCHES (activity_id = 135195754518)

    メールイベントの開始日を指定するには、date パラメーターと >= 演算子を使用します。
    shopify_email.delivered NOT MATCHES (activity_id = 135195754518, date >= 2022-01-01)

    メールイベントの終了日を指定するには、date パラメーターと <= 演算子を使用します。
    shopify_email.delivered MATCHES (activity_id = 135195754518, date <= 2022-01-01)

    メールイベントの開始日と終了日の両方を指定するには、date パラメーターと BETWEEN 演算子を使用します。
    shopify_email.bounced NOT MATCHES (activity_id = 135195754518, date BETWEEN -12m AND today)













    注
    • activity_id パラメーターを使用して顧客セグメントを作成すると、表示されるリストからマーケティングアクティビティを名前で選択できます。
    • データ保持のため、date パラメーターがない場合、結果は開始日と終了日が設定されずに、過去 26 か月間を対象に絞り込まれます。
    • activity_id がない場合、フィルターにはすべての Shopify メールアクティビティが含まれます。

    メールサブスクリプションのステータス

    名前： email_subscription_status

    お客様がマーケティングメールを購読しているかどうかに基づいて、お客様をセグメントに含めます。

    演算子 次と等しい： =
    次と等しくない： !=
    存在しない： IS NULL
    存在する： IS NOT NULL


    値 未購読： 'NOT_SUBSCRIBED' お客様はマーケティングメールを購読していません。
    購読済み： 'SUBSCRIBED' お客様はマーケティングメールを購読しています。
    保留中： 'PENDING' お客様はマーケティングメールの購読手続き中です。
    無効： 'INVALID' お客様のメールアドレスのマーケティングステータスが無効です。
    購読解除済み： 'UNSUBSCRIBED' お客様はマーケティングメールの購読を解除しています。
    編集済み： 'REDACTED' お客様のメールアドレスは編集されています。




    形式
    例 メールマーケティングを購読しているお客様を含めます。
    email_subscription_status = 'SUBSCRIBED'
    注

    初回注文日

    名前： first_order_date

    指定された日付に初回注文を行ったお客様を含めます。

    演算子 特定の日付に等しい： =
    特定の日付に等しくない： !=
    特定の日付以前： <=
    特定の日付より前： <
    特定の日付以降： >=
    特定の日付より後： >
    期間指定： BETWEEN {date1} AND {date2}
    存在しない： IS NULL
    存在する： IS NOT NULL







    値
    形式 絶対日付： YYYY-MM-DD
    日付オフセットの例： -4w、 -10y
    指定された日付：
    • 今日： = today
    • 昨日： = yesterday
    指定された日付はデフォルト値であり、変更することはできません。カスタムの日付を使用するには、日付オフセットを使用します。

    例 先週以降に初回注文を行ったお客様を含めます。
    first_order_date >= -7d

    8 か月前以降に初回注文を行ったお客様を含めます。
    first_order_date > -8m



    注 日付の値は丸1日に基づいており、ストアのタイムゾーンによって異なります。

    最終注文日

    名前： last_order_date

    指定された日付に最終注文を行ったお客様を含めます。

    演算子 特定の日付に等しい： =
    特定の日付に等しくない： !=
    特定の日付以前： <=
    特定の日付より前： <
    特定の日付以降： >=
    特定の日付より後： >
    期間指定： BETWEEN {date1} AND {date2}
    存在しない： IS NULL
    存在する： IS NOT NULL







    値
    形式 絶対日付： YYYY-MM-DD
    日付オフセットの例： -4w、 -10y
    指定された日付：
    • 今日： = today
    • 昨日： = yesterday
    指定された日付はデフォルト値であり、変更することはできません。カスタムの日付を使用するには、日付オフセットを使用します。

    例 先週以降に最終注文を行ったお客様を含めます。
    last_order_date >= -7d

    8 か月前以降に最終注文を行ったお客様を含めます。
    last_order_date > -8m



    注 日付の値は丸1日に基づいており、ストアのタイムゾーンによって異なります。

    注文数

    名前： number_of_orders

    ストアで行われた注文数に基づいてお客様を含めます。

    演算子 次と等しい： =
    次と等しくない： !=
    次より大きい： >
    次より小さい： <
    以下： <=
    以上： >=
    次の期間内： BETWEEN





    値入力する値は整数である必要があります。
    形式 数値範囲： # AND #
    数値： #
    例 10 回を超えて注文したお客様を含めます。
    number_of_orders > 10
    注 BETWEEN には、開始値と終了値の両方が含まれます。例えば、 number_of_orders BETWEEN 1 AND 100 1 回以上 100 回以下の注文をしたお客様が含まれます。

    行われた注文

    名前： orders_placed

    指定した期間内に注文した、または一定の金額を支払ったお客様を含めます。

    関数パラメーター app_id (任意)：このパラメーターを使用して、注文を作成したアプリを指定します。これには、アプリ ID が 129785 の Shopify POS などのアプリが含まれます。
    location_id (任意)：このパラメーターを使用して、注文が行われたロケーションを指定します。ロケーションでロケーションの詳細に移動すると、Shopify 管理画面の URL でロケーションの ID を確認できます。
    count (任意)：このパラメーターを使用して、注文が行われた正確な回数を指定します。
    amount (任意)：このパラメーターを使用して、1 回の注文で支払われた正確な金額を指定します。
    sum_amount (任意)：このパラメーターを使用して、すべての注文で支払われた合計金額を指定します。
    date (任意)：このパラメーターを使用して、イベントの日付を指定します。






    演算子 MATCHES：パラメーターが true です。
    NOT_MATCHES：パラメーターが false です。
    IS NULL：パラメーターは存在しません。
    IS NOT NULL：パラメーターは存在します。

    日付に使用できる演算子は、次のとおりです。
    次と等しい： =
    次と等しくない： !=
    次より大きい： >
    次より小さい： <
    以下： <=
    以上： >=
    次の期間内： BETWEEN











    値
    形式 対応形式： count、 amount、および sum_amountでサポートされている形式：
    数字： #

    対応形式： dateでサポートされている形式：
    絶対日付： YYYY-MM-DD
    日付オフセットの例：
    • 7 日前： -7d
    • 4 週間前： -4w
    • 3 か月前： -3m
    • 1 年前： -1y
    指定の日付：
    • 今日： today
    • 昨日： yesterday
    指定の日付はデフォルト値であり、変更することはできません。




    例 注文が行われたかどうかを MATCHES または NOT_MATCHES 演算子を使用して指定します。
    orders_placed MATCHES ()
    orders_placed NOT MATCHES ()

    過去 6 か月間に 3 回以上の注文をしたお客様を絞り込みます。
    orders_placed MATCHES (count >= 3, date >= -6m)

    過去 90 日間に 1000 ドル以上を支払ったお客様を絞り込みます。
    orders_placed MATCHES (sum_amount >= 1000, date >= -90d)

    過去 7 日間に 100 ドル以下を支払ったお客様を絞り込みます。
    orders_placed MATCHES (sum_amount <= 100, date >= -7d)

    2023年1月1日以降に 1000 ドル以上を支払い、かつ 3 回以上の注文をしたお客様を絞り込みます。
    orders_placed MATCHES (sum_amount >= 1000, count >= 3, date >= 2023-01-01)

    パラメーター date と演算子 BETWEEN を使用して、特定の日付範囲を指定します。2023年1月1日から2023年6月1日までの期間 (両日を含む) は、次のように表現できます。
    orders_placed MATCHES (count >= 3, date BETWEEN 2023-01-01 AND 2023-06-01)

    HQ Gift Shop ロケーション (1122334455) または Main Street ロケーション (6677889900) のいずれかから注文したお客様を絞り込みます。
    orders_placed MATCHES (location_id IN (1122334455,6677889900))

    Shopify POS から合計で 500 ドル超を支払ったお客様を絞り込みます。
    orders_placed MATCHES (app_id = 129785, sum_amount >= 500)






















    注
    • 金額にカーソルを合わせると、お客様の絞り込みに使用される通貨が表示されます。
    • 次の構文にカーソルを合わせると、
      amount、 sum_amount 構文の説明が表示されます。
    • ない場合、 parameters フィルターには、すべての期間に行われたすべての注文が含まれます。

    予測される購入額の階層

    名前： predicted_spend_tier

    指定された予測される購入額の階層内にいるお客様が含まれます。予測される購入額の階層について、詳しくはこちら。

    演算子 次と等しい： =
    次と等しくない： !=
    存在しない： IS NULL
    存在する： IS NOT NULL


    値 'HIGH'
    'MEDIUM'
    'LOW'



    形式
    例 HIGH 階層にいるお客様を含めるには、以下のようにします。
    predicted_spend_tier = 'HIGH'
    注

    商品の定期購入のステータス

    名前： product_subscription_status

    指定した商品の定期購入のステータスを持つお客様が含まれます。

    演算子 次と等しい： =
    次と等しくない： !=
    存在しない： IS NULL
    存在する： IS NOT NULL


    値 有効： 'SUBSCRIBED' お客様には有効な商品の定期購入があります。
    キャンセル済み： 'CANCELLED' お客様は商品の定期購入をキャンセルしました。
    期限切れ： 'EXPIRED' お客様の商品の定期購入の有効期限が切れています。
    失敗： 'FAILED' お客様の決済は失敗しました。
    未登録： 'NEVER_SUBSCRIBED' お客様は一度も定期購入していません。
    一時停止中： 'PAUSED' お客様は商品の定期購入を一時停止しています。




    形式
    例 有効な商品の定期購入を行っているお客様を含めるには、以下のようにします。
    product_subscription_status = 'SUBSCRIBED'
    注

    購入した商品

    名前： products_purchased

    特定の商品を購入したお客様が含まれます。さらに、指定した期間中に商品を購入したお客様を含めることもできます。

    関数パラメーター id (任意)：このパラメーターを使用して、絞り込み対象のお客様が購入した商品を指定します。
    quantity (任意)：このパラメーターを使用して、注文ごとに購入された商品の数量を指定します。
    sum_quantity (任意)：このパラメーターを使用して、すべての注文で購入された商品の数量を指定します。
    date (任意)：このパラメーターを使用して、イベントの日付を指定します。
    tag (任意)：このパラメーターを使用して、絞り込み対象の購入済み商品の商品タグを指定します。



    演算子 MATCHES：パラメーターは true です。
    NOT_MATCHES：パラメーターは false です。
    IS NULL：パラメーターが存在しません。
    IS NOT NULL：パラメーターが存在します。

    日付の場合、使用可能な演算子は次のとおりです。
    次と等しい： =
    次と等しくない： !=
    次より大きい： >
    次より小さい： <
    以下： <=
    以上： >=
    次の期間内： BETWEEN











    値
    形式 対応形式： tagでサポートされている形式：
    文字列 (単一の値)

    対応形式 id：
  • = (単一の値)
  • IN ：括弧で囲まれた、暗黙的な「OR」を含むカンマ区切りの値のセット。例： (id IN (1012132033639, 2012162031638, 32421429314657))。セットには、商品 ID が 500 件までという上限があります。

    サポートされている date の形式：
    絶対日付： YYYY-MM-DD
    日付オフセットの例：
    • 7 日前： -7d
    • 4 週間前： -4w
    • 3 か月前： -3m
    • 1 年前： -1y
    • 名前付きの日付： today、 yesterday
    名前付きの日付はデフォルト値であり、変更できません。

    対応形式 quantity と sum_quantityでサポートされている形式：
    数字： #










    • 例 MATCHES または NOT_MATCHES 演算子を使用して、商品が購入されたかどうかを指定します。
    products_purchased MATCHES (id = 2012162031638)
    products_purchased NOT MATCHES (id IN (2012162031638, 1012132033639)) products_purchased MATCHES (tag = 'red')

    2022年1月1日から今日までに特定の商品を購入したお客様を絞り込みます。
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND today)

    2022年1月1日から今日までに 'red' タグの付いた商品を購入したお客様を絞り込みます。
    products_purchased MATCHES (tag = 'red', date BETWEEN 2022-01-01 AND today)

    過去30日以内：
    products_purchased MATCHES (date >= -30d)

    2022年1月1日まで：
    products_purchased MATCHES (date <= 2022-01-01)

    パラメーター「 date と演算子 BETWEEN 」を使用して、特定の日付範囲を指定します。2022年1月1日から2022年6月1日までの期間 (両端を含む) は、次のように表すことができます。
    products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND 2022-06-01)

    最近、特定のタグが付いた商品を多数購入したお客様を絞り込みます。
    products_purchased MATCHES (tag = 'product_tag', sum_quantity >= 3, date >= -90d)



















    注
    • id パラメーターを使用して顧客セグメントを作成する場合、表示されるリストから名前または画像で商品を選択できます。あるいは、商品名を入力し始めてから、リストで選択することもできます。
    • コードには商品名ではなく商品 ID が入力されます。商品 ID にカーソルを合わせると、商品名と画像が表示されます。
    • 両方がない場合、 date パラメーターがない場合は、開始日と終了日が設定されず、すべての期間の結果が絞り込まれます。
    • パラメーターがない場合、フィルターにはすべての期間に購入されたすべての商品が含まれます。

    RFM グループ

    名前： rfm_group

    お客様が分類されているRFM グループに基づいて、お客様を絞り込みます。RFM の顧客分析について、詳しくはこちら。

    使用可能な RFM グループの演算子と値のリスト (例を含む)。
    演算子 次と等しい： =
    次と等しくない： !=
    存在しない： IS NULL
    存在する： IS NOT NULL


    値 休眠顧客： 'DORMANT'
    離反リスクのある顧客： 'AT_RISK'
    以前のロイヤル顧客： 'PREVIOUSLY_LOYAL'
    要注意顧客： 'NEEDS_ATTENTION'
    離反寸前の顧客： 'ALMOST_LOST'
    ロイヤル顧客： 'LOYAL'
    有望顧客： 'PROMISING'
    アクティブな顧客： 'ACTIVE'
    新規顧客： 'NEW'
    優良顧客： 'CHAMPIONS'
    見込み客： 'PROSPECTS'









    形式
    例 RFM グループの [要注意顧客] にお客様を含める：
    rfm_group = 'NEEDS_ATTENTION'
    注

    SMS のサブスクリプションステータス

    名前： sms_subscription_status

    お客様がマーケティング SMS テキストメッセージをサブスクリプション登録しているかどうかに基づいてお客様を含めます。お客様の連絡先情報を収集することについて、詳しくはこちら。

    演算子 次と等しい： =
    次と等しくない： !=
    存在しない： IS NULL
    存在する： IS NOT NULL


    値 サブスクリプション登録済み： 'SUBSCRIBED' お客様はマーケティング SMS テキストメッセージにサブスクリプション登録しています。
    保留： 'PENDING' お客様はマーケティング SMS テキストメッセージへのサブスクリプション登録処理中です。
    伏字化済み： 'REDACTED' お客様には、GDPR の消去リクエストにより保留中の伏字化があります。
    サブスクリプション登録を解除済み： 'UNSUBSCRIBED' お客様はマーケティング SMS テキストメッセージのサブスクリプション登録を解除しました。
    サブスクリプション未登録： 'NOT_SUBSCRIBED' お客様はマーケティング SMS テキストメッセージに一度もサブスクリプション登録していません。



    形式
    例 マーケティング SMS テキストメッセージをサブスクリプション登録しているお客様を含める：
    sms_subscription_status = 'SUBSCRIBED'
    注

    都道府県

    名前： customer_regions

    指定した国内の地域に住所があるお客様を含めます。複数の住所を持つお客様は、このフィルターを使用する複数の顧客セグメントに含まれる場合があります。

    演算子 この国/地域と完全に一致する： CONTAINS
    この国/地域と完全に一致しない： NOT CONTAINS
    存在しない： IS NULL
    存在する： IS NOT NULL


    値ISO 国コードと ISO 3166-2 サブディビジョンコードを使用します。
    形式
    例 ニューヨーク州に住所があるお客様を含める：
    customer_regions CONTAINS 'US-NY'
    注 地域を検索するには、地域名を入力し始め、表示されるリストから適切な値を選択します。

    ストアクレジットアカウント

    名前： store_credit_accounts

    ストアにストアクレジット残高があるお客様を含めます。

    関数パラメーター balance (任意)：このパラメーターを使用して、お客様の現在のストアクレジットアカウントの残高を指定します。
    currency (任意)：このパラメーターを使用して、お客様のストアクレジット残高の通貨を指定します。
    next_expiry_date (任意)：このパラメーターを使用して、未使用のストアクレジットのうち、最も早く有効期限が切れる日付を指定します。
    last_credit_date (任意)：このパラメーターを使用して、お客様が最後にストアクレジットを受け取った日付を指定します。


    演算子 MATCHES：パラメーターが true です。
    NOT_MATCHES：パラメーターが false です。
    IS NULL：パラメーターは存在しません。
    IS NOT NULL：パラメーターは存在します。

    日付に使用できる演算子は、次のとおりです。
    次と等しい： =
    次と等しくない： !=
    次より大きい： >
    次より小さい： <
    以下： <=
    以上： >=
    次の期間内： BETWEEN











    値
    形式 対応形式 currencyでサポートされている形式：
    通貨コード：例 USD

    対応形式 balanceでサポートされている形式：
    数字： #

    対応形式 next_expiry_date と last_credit_dateでサポートされている形式：
    絶対日付： YYY-MM-DD
    日付オフセットの例：
    7 日前： -7d
    4 週間前： -4w
    3 か月前： -3m
    1 年前： -1y
    指定の日付：
  • 今日： today
  • 昨日： yesterday
    • 指定の日付はデフォルト値であり、変更することはできません。












    例 いずれかの通貨でストアクレジットアカウントの残高が 1 以上の顧客を絞り込む：
    store_credit_accounts MATCHES (balance >= 1)

    ストアクレジットアカウントの残高が 1 米ドル以上のお客様を絞り込む：
    store_credit_accounts MATCHES (balance >= 1, currency: 'USD')

    今後 7 日以内に有効期限が切れるストアクレジットを持つお客様を絞り込む：
    store_credit_accounts MATCHES (next_expiry_date <= +7d)

    最後にストアクレジットを受け取ってから 1 か月以上経過しているが、まだ利用可能な残高があるお客様を絞り込む：
    store_credit_accounts MATCHES (last_credit_date <= -1m, balance >= 1)









    注
    • お客様にストアクレジットを発行したことがある場合、そのお客様はストアクレジットアカウントを所有しています。お客様のストアクレジット残高は 0 以上になることがあります。
    • ストアクレジットアカウントは通貨に固有です。セグメントに currency パラメーターを含めない場合、フィルターは通貨の種類に関係なくすべてのストアクレジットアカウントを返します。
    • サポートしている通貨の数に応じて、お客様は 0 個以上のストアクレジットアカウントを持つことができます。たとえば、お客様に CAD と USD の両方でストアクレジットを発行した場合、そのお客様は 2 つのストアクレジットアカウントを持つことになります。

    ストアフロントイベント

    名前： storefront.EVENT

    ストアフロントイベントに基づいてお客様を含めます。サポートされているイベント (EVENT) には、以下が含まれます。

    • 表示された商品：product_viewed
    • 表示されたコレクション：collection_viewed
    関数パラメーター id (任意)：このパラメーターを使用して、絞り込む商品またはコレクションを指定します。
    date (任意)：このパラメーターを使用して、イベントの日付を指定します。
    count (任意)：このパラメーターを使用して、商品またはコレクションが表示された正確な回数を指定します。

    商品イベント固有のパラメーター：
    tag (任意)：このパラメーターを使用して、絞り込む商品タグを指定します。これは、そのタグを持つすべての商品 ID を絞り込むのと同じように動作します。






    演算子 MATCHES：パラメーターは true です。
    NOT_MATCHES：パラメーターは false です。
    IS NULL：パラメーターが存在しません。
    IS NOT NULL：パラメーターが存在します。

    日付の場合、使用可能な演算子は次のとおりです。
    次と等しい： =
    次と等しくない： !=
    次より大きい： >
    次より小さい： <
    以下： <=
    以上： >=
    次の期間内： BETWEEN











    値
    形式 対応形式 id：
  • = (単一の値)
  • IN ：括弧で囲まれた、暗黙的な「OR」を含むカンマ区切りの値のセット。例： (id IN (1012132033639, 2012162031638, 32421429314657))セット内の商品またはコレクションの ID には 500 件の上限があります。

    対応形式 tag： 文字列 (単一の値)

    サポートされている date 形式： 絶対日付： YYYY-MM-DD
    日付オフセットの例：
    • 7 日前： -7d
    • 4 週間前： -4w
    • 3 か月前： -3m
    • 1 年前： -1y
    指定の日付：
    • 今日： today
    • 昨日： yesterday
    ストアフロントイベントは、2023 年 5 月以降のデータで、過去 26 か月間利用可能です。

    指定された日付はデフォルト値であり、変更することはできません。カスタムの日付を使用するには、日付オフセットを使用します。






    • 例 ストアフロントイベントが発生したかどうかを指定するには、MATCHES または NOT_MATCHES 演算子を使用します。 storefront.product_viewed MATCHES()
    storefront.collection_viewed NOT MATCHES ()

    絞り込み対象の商品を指定するには、id パラメータを使用します。
    storefront.product_viewed MATCHES (id = 2012162031638)
    storefront.collection_viewed MATCHES (id IN (2012162031638, 456, 789))

    絞り込み対象の商品タグを指定するには、tag パラメータを使用します。
    storefront.product_viewed MATCHES (tag CONTAINS 'jeans')

    ストアフロントイベントの開始日を指定するには、date パラメータと >= 演算子を使用します。
    storefront.product_viewed MATCHES (id = 2012162031638, date >= 2023-04-03)
    storefront.collection_viewed MATCHES (id = 2012162031638, date >= -30d)

    ストアフロントイベントの終了日を指定するには、date パラメータと <= 演算子を使用します。
    storefront.product_viewed MATCHES (id = 2012162031638, date <= 2023-04-30)
    storefront.collection_viewed MATCHES (id = 2012162031638, date <= -7d)

    ストアフロントイベントの開始日と終了日の両方を指定するには、date パラメータと BETWEEN 演算子を使用します。
    storefront.product_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-04-03 AND 2023-04-30)
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN -90d AND -30d)

    過去 30 日以内に特定の商品を閲覧したお客様を絞り込みます。
    storefront.product_viewed MATCHES (id = 2012162031638, date >= -30d)

    2023 年 1 月 1 日から今日までに特定のコレクションを閲覧したお客様を絞り込みます。
    storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-01-01 AND today)

























    注
    • id パラメータを使用して顧客セグメントを作成する場合、表示されるリストから、名前または画像で商品やコレクションを選択できます。または、商品やコレクションのタイトルを入力し始め、リストから選択することもできます。
    • コードには、タイトルではなく商品またはコレクションの ID が入力されます。ID にカーソルを合わせると、商品またはコレクションのタイトルと画像が表示されます。
    • コレクションでは、該当する場合、コレクションのサムネイルとして保存されている画像が使用されます。サムネイルがない場合は、一般的な画像のプレースホルダーが表示されます。
    • データ保持のため、date パラメーターがない場合、結果は開始日と終了日が設定されずに、過去 26 か月間を対象に絞り込まれます。
    • id を指定しない場合、絞り込みにはすべての商品が含まれます。