說明
登入

以 Shopify 為基礎的顧客群篩選條件

本參考指南說明如何使用 Shopify 預設篩選條件來建立顧客群，並列出可用的篩選條件名稱、運算子與值。

本頁內容

未完成結帳作業日期

名稱： abandoned_checkout_date

依顧客最近未完成結帳作業的日期篩選。

運算子 等於指定日期： =
不等於指定日期： !=
為指定日期或更早： <=
早於指定日期： <
為指定日期或更晚： >=
晚於指定日期： >
介於兩個日期之間： BETWEEN {date1} AND {date2}
不存在： IS NULL
存在： IS NOT NULL







值
格式 絕對日期： YYYY-MM-DD
日期偏移範例： -4w、 -10y
命名日期：
  • 今天： = today
  • 昨天： = yesterday
命名日期為預設值，無法變更。若要使用自訂日期，請使用日期偏移。

範例 包含最近一次未完成結帳作業在過去一週內的顧客：
abandoned_checkout_date >= -7d

包含最近一次未完成結帳作業在過去八個月內的顧客：
abandoned_checkout_date > -8m



注意事項日期值以整天為準，並視您的商店所屬時區而定。

週年紀念

名稱： 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 」篩選不會考量年份。
  • 日期值以整天為準，並視您的商店所屬時區而定。
  • 若要依出生日期篩選，您需要啟用 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
範例 包含地址位於 New York City 的顧客：
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 兩碼國家代碼。
格式
範例 包含地址位於美國的顧客：
customer_countries CONTAINS 'US'
注意事項 若要尋找國家/地區，您可以開始輸入其名稱，然後從顯示的清單中選取正確的值。

建立來源 app ID

名稱： created_by_app_id

包含由指定 app 建立的顧客。

運算子 等於： =
不等於： !=
值用於區隔的 app ID。
格式app ID
範例 包含在 Shopify 後台建立的顧客：
created_by_app_id = 1830279
注意事項
  • 建立顧客區隔時，您可以從顯示的清單中依名稱選取 app。或者，先輸入 app 名稱，再從清單中選取。
  • 輸入到程式碼中的是 app ID，而非 app 名稱。當您將游標停留在 app ID 上方時，會顯示 app 名稱。

顧客帳號狀態

名稱： 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
命名日期為預設值，無法變更。若要使用自訂日期，請使用日期偏移。

範例 包含過去一週內新增的顧客：
customer_added_date >= -7d

包含過去八個月內新增的顧客：
customer_added_date > -8m

包含在特定日期範圍內新增的顧客：
customer_added_date BETWEEN 2022-12-01 AND 2022-12-31






注意事項 日期值以整天計算，且取決於您的商店所屬的時區。

顧客電子郵件網域

名稱： 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 兩碼語言代碼。
格式 以下為常見 ISO 語言代碼的範例。您的資料不僅限於這些代碼，您也可以手動輸入其他有效的語言代碼；但編輯器提供的建議值，才是您的顧客資料中可用的值。
  • 英文： 'en'
  • 法文： 'fr'
  • 西班牙文： 'es'
  • 德文： 'de'
  • 義大利文： 'it'
  • 日文： 'ja'
  • 俄文： 'ru'
範例 包含以英文與您的商店溝通的顧客：
customer_language = 'en'

排除以加拿大英文與您的商店溝通的顧客：
customer_language != 'en-CA'



注意事項
  • 您可以在該值中加入地區語言代碼，以指定該語言的方言。例如，您可以使用 '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'
注意事項 標籤不區分大小寫。
Learn more about tags and their considerations。

距離指定地點一定範圍內的顧客

名稱： customer_within_distance

將位於已儲存地點指定距離內的顧客納入結果。

函式參數 每個篩選條件僅能使用一個距離參數。
coordinates (必填)：使用此參數指定您要用來建立分群的定位點。
distance_km (必填)：使用此參數指定您要搜尋顧客的距離半徑。
distance_mi (必填)：使用此參數指定您要搜尋顧客的距離半徑。




運算子 MATCHES：參數為 true。
NOT_MATCHES：參數為 false。
IS NULL：參數不存在。
IS NOT NULL：參數存在。






值
格式 支援的格式為 座標：
  • 數字 (緯度)、數字 (經度)

    • 座標 (緯度、經度) 的支援格式：
  • 數字：#

    • 支援的格式為 distance_mi、 distance_km：
  • 數字：#




    • 範例 此篩選條件必須提供座標並搭配一個距離參數，方可生效。

    篩選地址位於座標 (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 會在魔術翻譯中自動將座標配對轉換為您的地點名稱。例如：「地址位於地點『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))。同一集合最多可包含 500 個活動 ID。

    date 的支援日期格式：
  • 絕對日期： YYYY-MM-DD
  • 日期偏移範例：
    • 7 天前： -7d
    • 4 週前： -4w
    • 3 個月前： -3m
    • 1 年前： -1y
    • 命名日期： today、 yesterday


    • 命名日期為預設值，無法更改。若需自訂日期，請使用日期偏移。

    電子郵件事件僅提供最近 26 個月的資料，資料自 2022 年 3 月開始。

    支援的格式為 count：
  • 數字： #











    • 範例 使用 MATCHES 或 NOT MATCHES 運算子，指定電子郵件事件是否發生：
    shopify_email.opened MATCHES (activity_id = 135195754518)
    shopify_email.opened NOT MATCHES (activity_id = 135195754518)

    使用參數 activity_id 指定要篩選的行銷活動 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



    注意事項 日期值以整天計算，且取決於您的商店所屬的時區。

    最後訂單日期

    名稱： 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



    注意事項 日期值以整天計算，且取決於您的商店所屬的時區。

    訂單筆數

    名稱： number_of_orders

    依顧客在您商店的下單筆數來包含顧客。

    運算子 等於： =
    不等於： !=
    大於： >
    小於： <
    小於或等於： <=
    大於或等於： >=
    介於： BETWEEN





    值您輸入的值必須為整數。
    格式 數值範圍： # AND #
    數字： #
    範例 包含下單超過 10 次的顧客：
    number_of_orders > 10
    注意事項 BETWEEN 同時包含起始與結束值。例如， number_of_orders BETWEEN 1 AND 100 會包含至少下單 1 次、至多 100 次的顧客。

    下單紀錄

    名稱： orders_placed

    包含在指定日期範圍內有下單或消費達到特定金額的顧客。

    函式參數 app_id (選用)：使用此參數可指定由哪個 app 建立訂單。這包括像 Shopify POS 這類 app，其 app ID 為 129785。
    location_id (選用)：使用此參數可指定訂單是從哪個地點產生。當您在 Shopify 後台的 Locations 前往某個地點的詳細資料時，可以在網址中找到該地點的 ID。
    count (選用)：使用此參數可指定下單的確切次數。
    amount (選用)：使用此參數可指定單筆訂單的確切消費金額。
    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

    包含屬於指定預測消費等級的顧客。瞭解詳情：predicted spend tier。

    運算子 等於： =
    不等於： !=
    不存在： IS NULL
    存在： IS NOT NULL


    值 'HIGH'
    'MEDIUM'
    'LOW'



    格式
    範例 包含屬於 HIGH 等級的顧客：
    predicted_spend_tier = 'HIGH'
    注意事項

    商品訂閱狀態

    名稱： product_subscription_status

    包含具有指定 product subscription 狀態的顧客。

    運算子 等於： =
    不等於： !=
    不存在： 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











    值
    格式 適用於 標籤：
    字串 (單一值)

    支援的格式為 id：
  • = (單一值)
  • IN ：以逗號分隔的一組值，隱含「OR」，並以括號包住。範例： (id IN (1012132033639, 2012162031638, 32421429314657))。一組最多可包含 500 個產品 ID。

    支援的 日期 格式：
    絕對日期： 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 group 的顧客。瞭解詳情：RFM customer analysis。

    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_subscription_status

    根據顧客是否訂閱您的行銷簡訊來包含顧客。瞭解詳情：collecting customer contact information。

    運算子 等於： =
    不等於： !=
    不存在： IS NULL
    存在： IS NOT NULL


    值 已訂閱： 'SUBSCRIBED' 顧客已訂閱您的行銷簡訊。
    待處理： 'PENDING' 顧客正在完成您的行銷簡訊訂閱。
    已遮蓋： 'REDACTED' 顧客因一般資料保護規範 (GDPR) 的刪除要求而處於待處理的刪改狀態。
    已退訂： 'UNSUBSCRIBED' 顧客已退訂您的行銷簡訊。
    未訂閱： 'NOT_SUBSCRIBED' 顧客從未訂閱您的行銷簡訊。



    格式
    範例 包含已訂閱您行銷簡訊的顧客：
    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

    包含在您的商店擁有 store credit 餘額的顧客。

    函式參數 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))。一組最多可包含 500 個商品或商品系列 ID。

    支援的格式為 標籤： 字串 (單一值)

    支援的 日期 格式： 絕對日期： YYYY-MM-DD
    日期偏移範例：
    • 7 天前： -7d
    • 4 週前： -4w
    • 3 個月前： -3m
    • 1 年前： -1y
    命名日期：
    • 今天： today
    • 昨天： yesterday
    線上店面事件僅保留最近 26 個月的資料，資料自 2023 年 5 月開始。

    命名日期為預設值，無法變更。若要使用自訂日期，請使用日期偏移。






    • 範例 使用運算子 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 表示您的篩選條件包含所有商品。