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

使用本參考指南，瞭解根據預設 Shopify 篩選條件以打造客戶群的篩選條件名稱、運算子和值。

此頁面上

未完成結帳作業日期

名稱： abandoned_checkout_date

將於特定日期未能完成結帳作業的顧客納入其中。

運算子	指定日期當天：`=` 非指定日期當天：`!=` 指定日期當天或之前：`<=` 指定日期之前：`<` 指定日期當天或之後：`>=` 指定日期之後：`>` 日期範圍：`BETWEEN {date1} AND {date2}` 不存在：`IS NULL` 存在： `IS NOT NULL`
值
格式	絕對日期：`YYYY-MM-DD` 日期位移範例：`-4w`、`-10y` 指定日期：今天： `= today` 昨天： `= yesterday` 過去 7 天內： `>= 7_days_ago` 過去 30 天內： `>= 30_days_ago` 過去 90 天： `>= 90_days_ago` 過去 12 個月： `>= 12_months_ago` 已命名的日期為預設值，無法變更。針對自訂日期，請使用日期位移。
範例	包含最近一週內最後一次放棄購物車的顧客： `abandoned_checkout_date >= 7_days_ago` 包含最近八個月內最後一次放棄購物車的顧客： `abandoned_checkout_date > -8m`
備註	日期值會以整天計算，並依您商店所在時區而定。

週年

名稱： anniversary

按與日期參數相關的活動日期加入顧客。

函數參數	請指定您要篩選的事件。例如： `'metafields.facts.birth_date'`
運算子	`MATCHES`：參數為真。 `NOT_MATCHES`：參數為假。 `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 MATCHES ('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`
範例	包含在紐約市擁有地址的顧客： `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`
值	使用由 2 個字母組成的 ISO 國家/地區代碼。
格式
範例	包含在美國擁有地址的顧客： `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` 過去 7 天內： `>= 7_days_ago` 過去 30 天內： `>= 30_days_ago` 過去 90 天： `>= 90_days_ago` 過去 12 個月： `>= 12_months_ago` 已命名的日期為預設值，無法變更。針對自訂日期，請使用日期位移。
範例	包含最近一週內新增的顧客： `customer_added_date >= 7_days_ago` 包含最近八個月內新增的顧客： `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`
值	使用由 2 個字母組成的 ISO 639-1 語言代碼。
格式	下列的值為一些常見的 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

涵蓋位於已儲存地點指定距離內的顧客。

函數參數	您只能對每個篩選條件使用一個距離參數。`coordinates` (必要)：使用此參數指定用於建立顧客群的標記地點。 `distance_km` (必要)：使用此參數指定用於搜尋顧客的距離半徑。 `distance_mi` (必要)：使用此參數指定用於搜尋顧客的距離半徑。
運算子	`MATCHES`：參數為真。 `NOT_MATCHES`：參數為假。 `IS NULL`參數不存在。 `IS NOT NULL` ：參數存在。
數值
格式	座標 (`coordinates`) 的支援格式：數字 (經度), 數字 (緯度) 座標 (經度, 緯度) 的支援格式：數字：`#` `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 公里範圍內的顧客且至少下過一筆訂單： `customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0`
備註	Shopify 分群功能會自動將您儲存的地點轉換為座標配對，並在使用此篩選器時將其顯示為可選擇的值。如果您的商店已儲存地點，則 Shopify Magic 會在魔法翻譯中自動將座標對轉換為您的地點名稱。例如：「顧客的地址位於『鹽湖城商店』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` ：以括號包住的一組以逗號分隔的值，隱含「或」的關係。例如：`(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` 建立顧客群時，您可從顯示的清單中按其名稱選擇行銷活動。由於資料保留機制，若未設定`日期`參數，系統將會篩選過去 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` 過去 7 天內： `>= 7_days_ago` 過去 30 天內： `>= 30_days_ago` 過去 90 天： `>= 90_days_ago` 過去 12 個月： `>= 12_months_ago` 已命名的日期為預設值，無法變更。針對自訂日期，請使用日期位移。
範例	包括上週以來首次下單的顧客： `first_order_date >= 7_days_ago` 包括八個月前首次下單的顧客： `first_order_date > -8m`
備註	日期值會以整天計算，並依您商店所在時區而定。

最後一筆訂單日期

名稱： last_order_date

包含於指定日期進行最後一次下單的顧客。

運算子	指定日期當天：`=` 非指定日期當天：`!=` 指定日期當天或之前：`<=` 指定日期之前：`<` 指定日期當天或之後：`>=` 指定日期之後：`>` 日期範圍：`BETWEEN {date1} AND {date2}` 不存在：`IS NULL` 存在： `IS NOT NULL`
值
格式	絕對日期：`YYYY-MM-DD` 日期位移範例：`-4w`、`-10y` 指定日期：今天： `= today` 昨天： `= yesterday` 過去 7 天內： `>= 7_days_ago` 過去 30 天內： `>= 30_days_ago` 過去 90 天： `>= 90_days_ago` 過去 12 個月： `>= 12_months_ago` 已命名的日期為預設值，無法變更。針對自訂日期，請使用日期位移。
範例	包含自上週起最後一次下訂單的顧客： `last_order_date >= 7_days_ago` 包含自八個月前起最後一次下訂單的顧客： `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` （選用）：使用此參數來指定建立訂單的應用程式。 `location_id`（選用）：使用此參數來指定訂單的下單地點。 `count`（選用）：使用此參數指定訂單的確切下訂次數。 `amount`（選用）：使用此參數指定訂單上的確切消費金額。 `sum_amount`（選用）：使用此參數指定所有訂單上的消費金額。 `date` （選用）：使用此參數來指定事件的日期。
運算子	`MATCHES`：參數為真。 `NOT_MATCHES`：參數為假。 `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)`
備註	將游標停留在金額上時，系統會顯示用於篩選顧客的幣別。當您將游標停留在以下語法上時： `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`：參數為真。 `NOT_MATCHES`：參數為假。 `IS NULL`參數不存在。 `IS NOT NULL`：參數存在。日期可使用的運算子包含：等於：`=` 不等於：`!=` 大於：`>` 小於：`<` 小於或等於：`<=` 大於或等於：`>=` 介於： `BETWEEN`
數值
格式	支援的 `tag` 格式： `string`（單一值）支援的 `id` 格式： `=` (單一數值) `IN` ：以括號包住的一組以逗號分隔的值，隱含「或」的關係。例如：`(id IN (1012132033639, 2012162031638, 32421429314657))`。每套商品 ID 限制為 500 個。支援的`日期`格式：絕對日期：`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_subscription_status

根據顧客是否訂閱了您的行銷簡訊來篩選顧客。深入瞭解如何收集顧客聯絡資訊。

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

包含在您商店中有商店抵用金餘額的顧客。

函數參數	`balance` （選用）：使用此參數指定顧客目前的商店抵用金餘額。 `currency`（選用）：使用此參數指定顧客的商店抵用金餘額幣別。 `next_expiry_date`（選用）：使用此參數指定未花費的商店抵用金中即將到期的日期。 `last_credit_date`（選用）：使用此參數指定顧客上次收到商店抵用金的日期。
運算子	`MATCHES`：參數為真。 `NOT_MATCHES`：參數為假。 `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 到多個商店抵用金帳戶。例如，若您使用加幣和美元核發商店抵用金給顧客，該顧客便會有 2 個商店抵用金帳戶。

店面事件

名稱： storefront.EVENT

根據店面事件篩選顧客。支援的事件（EVENT）包含以下項目：

商品已查看：product_viewed
商品系列已查看：collection_viewed

函數參數	`id` （選用）：使用此參數指定您要篩選的商品或商品系列。 `date`（選用）：使用此參數來指定事件的日期。 `count` （選用）：使用此參數指定商品或商品系列的確切檢視次數。商品事件專用參數： `tag`（選用）：使用此參數來指定您要篩選的產品標籤。這與篩選帶有該標籤的每種商品 ID 的作用相同。
運算子	`MATCHES`：參數為真。 `NOT_MATCHES`：參數為假。 `IS NULL`參數不存在。 `IS NOT NULL`：參數存在。日期可使用的運算子包含：等於：`=` 不等於：`!=` 大於：`>` 小於：`<` 小於或等於：`<=` 大於或等於：`>=` 介於： `BETWEEN`
數值
格式	`id` 支援的格式： `=` (單一數值) `IN` ：以括號包住的一組以逗號分隔的值，隱含「或」的關係。例如：`(id IN (1012132033639, 2012162031638, 32421429314657))`。一個商品系列中的商品或商品系列 ID 數量上限為 500 個。支援的 `tag` 格式：`string`（單一值）支援的 `date` 格式：絕對日期：`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 上時，會顯示商品或商品系列標題和圖片。若適用，商品系列會使用儲存為縮圖的圖片。若不適用，系統會顯示一般圖片預留位置。由於資料保留機制，若未設定`日期`參數，系統將會篩選過去 26 個月的結果，不設定起始或結束日期。若缺少 `id` 即表示您的篩選條件會包含所有商品。