以 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` 包含過去 8 個月內未完成結帳作業的顧客： `abandoned_checkout_date > -8m`
備註	日期值會以整天計算，並依您商店所在時區而定。

週年

anniversary()

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

函數參數	`date` (必要)：使用此參數指定您要篩選的活動。
運算子	確切日期：`=` 介於日期之間：`BETWEEN <date1> AND <date2>`
值
格式	絕對日期：`YYYY-MM-DD` 日期位移範例：`+4w`、`+3m` 指定日期：今天： `= today` 未來 7 天： `BETWEEN today AND +7d` 未來 30 天： `BETWEEN today AND +30d`
範例	包括未來 30 天內生日的顧客： `anniversary(date: 'metafields.facts.birth_date') BETWEEN today AND +30d`
備註	使用絕對日期時，不會使用年份來建立顧客群。日期值會以整天計算，並依您商店所在時區而定。若要按出生日期篩選，您需要啟用 `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` 包含過去 8 個月內新增的顧客： `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.com：`'gmail.com'` yahoo.com：`'yahoo.com'` hotmail.com：`'hotmail.com'` aol.com：`'aol.com'` msn.com：`'msn.com'` live.com： `'live.com'` outlook.com：`'outlook.com'` yahoo.ca： `'yahoo.ca'`
格式
範例	包含電子郵件網域為 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'`
備註	標籤不區分大小寫。深入瞭解標籤及其考量事項。

距離內的顧客

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

函數參數	您只能對每個篩選條件使用一個距離參數。 `coordinates` (必要)：使用此參數指定用於建立顧客群的標記地點。 `distance_km` (必要)：使用此參數指定用於搜尋顧客的距離半徑。 `distance_mi` (必要)：使用此參數指定用於搜尋顧客的距離半徑。
運算子	等於：`=`
數值	`true` 或 `false`
格式	座標 (`coordinates`) 的支援格式：數字 (經度), 數字 (緯度) 座標 (經度, 緯度) 的支援格式：數字：`#` `distance_mi`、`distance_km` 的支援格式：數字：`#`
範例	此篩選條件需要座標和一個距離參數才有效。篩選地址位於座標 (40.624940, -111.833060) 10 英里範圍內的顧客： `customer_within_distance(coordinates: (40.624940, -111.833060), distance_mi: 10 ) = true` 如果您的商店已儲存地點，Shopify Magic 會在魔術翻譯 (magic translation) 中將座標對自動翻譯為您的地點名稱。地址位於地點「鹽湖城商店」10 英里內的顧客。您可以搭配使用多個篩選條件，進一步縮小顧客清單的範圍。篩選地址位於座標 (43.634,-79.412) 20 英里範圍內且至少下過一次訂單的顧客： `customer_within_distance ( coordinates: (43.634,-79.412), distance_km: 20 ) = true AND number_of_orders > 0` 篩選地址不在座標 (45.502,-73.563) 50 公里範圍內的顧客： `customer_within_distance ( coordinates: (45.502,-73.563), distance_km: 50 ) = false`
備註	Shopify Segmentation 會自動將已儲存的地點轉換為座標對，並在使用此篩選條件時顯示為一個可選值。

電子郵件事件

shopify_email.EVENT()

根據所選電子郵件事件加入顧客。支援的事件 (EVENT) 包括下列內容：

已退回：bounced
已點擊：clicked
已傳送：delivered
已標示為垃圾郵件：marked_as_spam
已開啟：opened
已取消訂閱：unsubscribed

函數參數	`activity_id` (選用)：使用此參數來選取要篩選的行銷活動 ID。 `count_at_least` (選用)：使用此參數指定電子郵件事件發生的最低次數。 `count_at_most` (選用)：使用此參數指定電子郵件事件發生的最高次數。 `count` (選用)：使用此參數指定電子郵件事件發生的確切次數。 `since` (選用)：使用此參數指定事件的開始日期。 `until` (選用)：使用此參數指定事件的結束日期。
運算子	等於：`=` 不等於：`!=`
數值	`true` 或 `false`
格式	`activity_id` 支援的格式： `ID` (單一數值) `List <ID>`：隱含「OR」的一組值。`List` 是一組括入圓括號中以逗號分隔的值。例如：`(1, 2, 3)`。清單中的活動 ID 數量上限為 500。 `since` 和 `until` 支援的 `Date` 格式：絕對日期：`YYYY-MM-DD` 日期位移範例： 7 天前：`:-7d` 4 週前：`:-4w` 3 個月前：`:-3m` 1 年前：`:-1y` 指定日期：`:today`、`:yesterday` 已命名的日期為預設值，無法變更。針對自訂日期，請使用日期位移。提供過去 26 個月內的電子郵件活動，資料從 2022 年 3 月開始。支援 `count_at_least`、`count_at_most`、`count` 格式：編號：`#`
範例	使用運算子 `=` 或 `!=` 說明電子郵件事件是否有發生： `shopify_email.opened(activity_id: 135195754518) = false` `shopify_email.opened(activity_id: 135195754518) != true` 使用參數 `activity_id` 指定要篩選的行銷活動 ID： `shopify_email.delivered(activity_id: 135195754518) = true` 使用參數 `since` 指定電子郵件事件的開始日期： `shopify_email.delivered(activity_id: 135195754518, since: 2022-01-01) = false` 使用參數 `until` 指定電子郵件事件的結束日期： `shopify_email.delivered(activity_id: 135195754518, until: 2022-01-01) = true` 使用參數 `since` 及 `until` 同時指定電子郵件事件的開始與結束日期： `shopify_email.bounced(activity_id: 135195754518, since: 12_months_ago, until: today) = false`
備註	使用參數 `activity_id` 建立顧客群時，您可從顯示的清單中按其名稱選擇行銷活動。由於資料留存，若在沒有設定開始或結束日期的情況下，因缺少 `since` 和 `until` 參數，即表示會在過去 26 個月的資料中篩選結果。若缺少 `activity_id` 即表示您的篩選會包含所有 Shopify 電子郵件事件。

電子郵件訂閱狀態

email_subscription_status

根據顧客是否訂閱您的行銷電子郵件來包含顧客。

運算子	等於：`=` 不等於：`!=` 不存在： `IS NULL` 存在： `IS NOT NULL`
值	未訂閱：`'NOT_SUBSCRIBED'` 尚未訂閱行銷電子郵件的顧客。已訂閱：`'SUBSCRIBED'` 已訂閱行銷電子郵件的顧客。處理中：`'PENDING'` 正在訂閱您行銷電子郵件的顧客。無效：`'INVALID'` 電子郵件地址之行銷狀態為無效的顧客。
格式
範例	包含已訂閱您的電子郵件行銷的顧客： `email_subscription_status = 'SUBSCRIBED'`
備註

最後一筆訂單日期

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` 包含 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()

納入特定日期範圍內下訂單或消費達特定金額的顧客。

函數參數	`count_at_least` (選用)：使用此參數指定訂單的最小下訂次數。 `count_at_most` (選用)：使用此參數指定訂單的最大下訂次數。 `count` (選用)：使用此參數指定訂單的確切下訂次數。 `amount_at_least` (選用)：使用此參數指定訂單上的最小消費金額。 `amount_at_most` (選用)：使用此參數指定訂單上的最大消費金額。 `amount` (選用)：使用此參數指定訂單上的確切消費金額。 `sum_amount_at_least` (選用)：使用此參數指定所有訂單上的最小消費金額。 `sum_amount_at_most` (選用)：使用此參數指定所有訂單上的最大消費金額。 `sum_amount` (選用)：使用此參數指定所有訂單上的消費金額。 `since` (選用)：使用此參數指定事件的開始日期。 `until` (選用)：使用此參數指定事件的結束日期。
運算子	等於：`=` 不等於：`!=`
值	`true` 或 `false`
格式	支援 `count_at_least`、`count_at_most`、`count` 格式：編號：`#` 支援 `amount_at_least`、`amount_at_most`、`amount` 格式：編號：`#` 支援 `sum_amount_at_least`、`sum_amount_at_most`、`sum_amount` 格式：編號：`#` 支援 `Date` 和 `since` 的 `until` 格式：絕對日期：`YYY-MM-DD` 日期位移範例： 7 天前：`:-7d` 4 週前：`:-4w` 3 個月前：`:-3m` 1 年前：`:-1y` 指定日期：今天： `:today` 昨天： `:yesterday` 已命名的日期為預設值，無法加以變更。
範例	請指明是否使用 `=` 或 `!=` 運算子來下訂單： `orders_placed() = true` `orders_placed() = false` 篩選過去 6 個月內訂單數量超過 3 個　(含) 的顧客： `orders_placed(count_at_least:3, since:-6m) = true` 篩選過去 3 個月內花費超過 1000 美元　(含) 的顧客： `orders_placed(sum_amount_at_least: 1000, since:-90d) = true` 篩選上週花費金額低於 100 美元　(含) 的顧客： `orders_placed(sum_amount_at_most: 100, since:-7d) = true` 篩選自 2023 年 1 月 1 日起花費超過 1000 美元　(含)，且訂單數量超過 3 個　(含) 的顧客： `orders_placed(sum_amount_at_least: 1000, count_at_least: 3, since: 2023-01-01) = true` 在日期範圍內，`since` 和 `until` 參數的順序皆無關緊要。您可以使用下列任一方式表達「2023 年 1 月 1 日至 2023 年 6 月 1 日 (含) 期間」：從 2023 年 1 月 1 日到 2023 年 6 月 1 日　(含)： `orders_placed(count_at_least:3, since: 2023-01-01, until: 2023-06-01) = true` 從 2023 年 1 月 1 日到 2023 年 6 月 1 日　(含)： `orders_placed(count_at_least:3, until: 2023-06-01, since: 2023-01-01) = true`
備註	將游標停留在金額上時，系統會顯示用於篩選顧客的幣別。將游標停留在以下語法上時： `amount_at_least`、`amount_at_most` `amount`、`sum_amount_at_least`、`sum_amount_at_most` `sum_amount` 系統會顯示語法的描述。若缺少 `parameters` 即表示您的篩選條件會包含所有時間所下的訂單。

預期消費等級

predicted_spend_tier

包含位於指定預期消費等級內的顧客。

您的商店交易筆數超過 100 筆時，才能使用此篩選條件。

深入瞭解預期消費等級。

運算子	等於：`=` 不等於：`!=` 不存在： `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_at_least` (選用)：使用此參數指定每筆訂單購買的最低商品數量。 `quantity_at_most` (選用)：使用此參數指定每筆訂單購買的最大商品數量。 `quantity` (選用)：使用此參數指定每筆訂單購買的商品數量。 `sum_quantity_at_least` (選用)：使用此參數指定所有訂單中購買的最低商品數量。 `sum_quantity_at_most` (選用)：使用此參數指定所有訂單中購買的最大商品數量。 `sum_quantity` (選用)：使用此參數指定所有訂單中購買的產品數量。 `since` (選用)：使用此參數指定事件的開始日期。 `tag` (選用)：使用此參數為顧客已購買且您要篩選的商品指定商品標籤。 `until` (選用)：使用此參數指定事件的結束日期。
運算子	等於：`=` 不等於：`!=`
數值	`true` 或 `false`
格式	支援的 `tag` 格式： `String` (單一值) 支援的 `ID` 格式：`ID` (單一值) `List <ID>`：作為清單提供的一組值。例如：`(1012132033639, 2012162031638, 32421429314657`。清單中的商品 ID 數量上限為 500 個。 `since` 和 `until` 支援的 `Date` 格式：絕對日期：`YYYY-MM-DD` 日期位移範例： 7 天前：`:-7d` 4 週前：`:-4w` 3 個月前：`:-3m` 1 年前：`:-1y` 指定日期：`:today`、`:yesterday` 已命名的日期為預設值，無法加以變更。支援 `quantity_at_least`、 `quantity_at_most`、 `quantity` 格式：編號：`#` 支援 `sum_quantity_at_least`、`sum_quantity_at_most`、`sum_quantity` 格式：編號：`#`
範例	使用運算子 `=` 或 `!=` 說明是否有購買商品：`products_purchased() != true` `products_purchased(id: 2012162031638) = true` `products_purchased(id: (2012162031638, 1012132033639)) = false` `products_purchased(tag: 'red') = true` 篩選從 2022 年 1 月 1 日至今購買特定商品的顧客： `products_purchased(id: 1012132033639, since: 2022-01-01, until: today) = true` 篩選從 2022 年 1 月 1 日至今購買商品含有標籤 `'red'` 的顧客： `products_purchased(tag: 'Red', since: 2022-01-01, until: today) = true` 過去 30 天內： `products_purchased(since: -30d) = true` 到 2022 年 1 月 1 日為止： `products_purchased(until: 2022-01-01) = true` 在日期範圍內，`since` 和 `until` 參數的順序皆無關緊要。您可以使用下列任一方式表達「2022 年 1 月 1 日至 2022 年 6 月 1 日 (含) 之間」： 2022 年 1 月 1 日到 2022 年 6 月 1 日 (含) 期間： `products_purchased(id: 1012132033639, since: 2022-01-01, until: 2022-06-01) = true` 2022 年 1 月 1 日到 2022 年 6 月 1 日 (含) 之間： `products_purchased(id: 1012132033639, until: 2022-06-01, since: 2022-01-01) = true` 篩選最近購買大量具有特定標籤商品的顧客： `products_purchased(tag: 'product_tag', sum_quantity_at_least: 3, since: -90d) = true`
備註	使用 `id` 參數建立顧客群時，您可以從顯示產品名稱或產品圖片的清單來選取產品。或者，您可以開始輸入產品標題，然後從清單中選擇。產品 ID (而非產品名稱) 會輸入到程式碼中。將游標停留在產品 ID 上時，會顯示產品標題和圖片。若同時缺少 `since` 和 `until` 參數，即表示會在沒有設定開始或結束日期的情況下篩選所有時間。若缺少 `parameters` 即表示您的篩選條件會包含將包含所有時間所購買的商品

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` (選用)：使用此參數指定顧客目前的商店抵用金餘額。 `balance_at_least` (選用)：使用此參數指定顧客的最低商店抵用金餘額。 `balance_at_most` (選用)：使用此參數指定顧客的最高商店抵用金帳戶餘額。 `currency` (選用)：使用此參數指定顧客的商店抵用金餘額幣別。 `next_expiry_date` (選用)：使用此參數指定未花費的商店抵用金中即將到期的日期。 `next_expiry_date_at_least` (選用)：使用此參數指定未花費的商店抵用金中即將到期的最早日期。 `next_expiry_date_at_most` (選用)：使用此參數指定未花費的商店抵用金中即將到期的最晚日期。 `last_credit_date` (選用)：使用此參數指定顧客上次收到商店抵用金的日期。 `last_credit_date_at_least` (選用)：使用此參數指定顧客上次收到商店抵用金的最早日期。 `last_credit_date_at_most` (選用)：使用此參數指定顧客上次收到商店抵用金的最晚日期。
運算子	等於：`=` 不等於：`!=`
值	`true` 或 `false`
格式	`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(balance_at_least: 1) = true` 篩選商店抵用金帳戶餘額大於或等於 $1 美元的顧客： `store_credit_accounts(balance_at_least: 1, currency: 'USD') = true` 篩選商店抵用金將於 7 天內到期的顧客： `store_credit_accounts(next_expiry_date_at_most: +7d) = true` 篩選上次收到商店抵用金已超過 1 個月但仍有可用餘額的顧客： `store_credit_accounts(last_credit_date_at_most: -1m, balance_at_least: 1) = true`
備註	如果您曾經核發商店抵用金給顧客，他們就有商店抵用金帳戶。顧客的商店抵用金餘額可能大於或等於 0。每個商店抵用金帳戶只能使用一種特定幣別。如果您未在顧客群中加入 `currency` 參數，則篩選條件會不分幣別類型傳回所有商店抵用金帳戶。視您支援的幣別數量而定，顧客可能擁有 0 到多個商店抵用金帳戶。例如，若您使用加幣和美元核發商店抵用金給顧客，該顧客便會有 2 個商店抵用金帳戶。

店面事件

storefront.EVENT()

根據店面事件加入顧客。支援的事件 (EVENT) 包括下列內容：

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

函數參數	`id` (選用)：使用此參數指定您要篩選的商品或商品系列。 `since` (選用)：使用此參數指定事件的開始日期。 `until` (選用)：使用此參數指定事件的結束日期。 `count_at_least` (選用)：使用此參數指定商品或商品系列的最低檢視次數。 `count_at_most` (選用)：使用此參數指定商品或商品系列的最高檢視次數。 `count` (選用)：使用此參數指定商品或商品系列的確切檢視次數。
事件專用的參數	`tag` (可選)：使用此參數指定要篩選的商品標籤。這與篩選帶有該標籤的每種商品 ID 的作用相同。
運算子	等於：`=` 不等於：`!=`
數值	`true` 或 `false`
格式	`id` 支援的格式： `ID` (單一數值) `List <ID>`：作為清單提供的一組值。例如：`(1012132033639, 2012162031638, 32421429314657)`。清單 ID 數量上限為 500 個商品 ID。支援的 `tag` 格式： `String` (單一值) `since` 和 `until` 支援的 `Date` 格式：絕對日期：`YYYY-MM-DD` 日期位移範例： 7 天前： `:-7d` 4 週前： `:-4w` 3 個月前： `:-3m` 1 年前： `:-1y` 過去 90 天： `>= 90_days_ago` 指定日期：今天： `:today` 昨天： `:yesterday` 提供過去 26 個月內的店面活動，資料從 2023 年 5 月開始。已命名的日期為預設值，無法更改。針對自訂日期，請使用日期位移。
範例	使用 `=` 或 `!=` 運算子來指定是否發生店面事件：`storefront.product_viewed() = true` `storefront.collection_viewed() = false` 使用參數 `id` 指定要篩選的商品： `storefront.product_viewed(id: 2012162031638) = true` `storefront.collection_viewed(id: (2012162031638, 456, 789)) = true` 將參數 `tag` 用於要篩選的商品標籤： `storefront.product_viewed(tag: 'jeans') = true` 使用參數 `since` 為店面事件指定開始日期： `storefront.product_viewed(id: 2012162031638, since: 2023-04-03) = true` `storefront.collection_viewed(id: 2012162031638, since:-30d) = true` 使用參數 `until` 為店面事件指定結束日期： `storefront.product_viewed(id: 2012162031638, until: 2023-04-30) = true` `storefront.collection_viewed(id: 2012162031638, until:-7d) = true` 使用參數 `since` 和 `until` 指定店面事件的開始日期和結束日期： `storefront.product_viewed(id: 2012162031638, since: 2023-04-03, until: 2023-04-30) = true` `storefront.collection_viewed(id: 2012162031638, since: -90d, until: -30d) = true` 篩選過去 30 天內查看特定商品的顧客： `storefront.product_viewed(id: 2012162031638, since: -30d) = true` 篩選 2023 年 1 月 1 日至今查看過特定商品系列的顧客： `storefront.collection_viewed(id: 2012162031638, since: 2023-01-01, until: today) = true` 在日期範圍內，`since` 和 `until` 參數的順序皆無關緊要。您可以使用下列任一方式表達「2023 年 1 月 1 日至 2023 年 6 月 1 日 (含) 期間」： 2023 年 1 月 1 日到 2023 年 6 月 1 日 (含) 之間： `storefront.collection_viewed(id: 2012162031638, since: 2023-01-01, until: 2023-06-01) = true` 2023 年 1 月 1 日到當日 (含) 之間： `storefront.collection_viewed(id: 2012162031638, until: today, since: 2023-01-01,) = true`
備註	使用 `id` 參數建立顧客群時，您可以從顯示商品名稱或商品圖片的清單來選取商品或商品系列。或者，您可以開始輸入商品或商品系列的標題，然後從清單中選擇。商品或商品系列 ID (而非名稱) 會輸入到程式碼中。將游標懸停在 ID 上時，會顯示商品或商品系列標題和圖片。商品系列會使用儲存為商品系列縮圖的圖片 (如適用)。若不適用，系統將顯示一般圖片預留位置。由於資料留存，若在沒有設定開始或結束日期的情況下，因缺少 `since` 和 `until` 參數，即表示會在過去 26 個月的資料中篩選結果。若缺少 `id` 即表示您的篩選條件會包含所有商品。