以 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

備註 日期值會以整天計算,並依您商店所在時區而定。

消費金額

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 NOT NULL
不屬於 B2B 顧客:
companies NULL
包含與特定公司相關聯的顧客:
companies CONTAINS 3778915041302
備註
  • 建立顧客群時,您可以透過畫面顯示的名稱清單來選取公司。或者,您可以自行輸入公司名稱,然後從清單中選取。
  • 程式碼會輸入公司 ID,而非公司名稱。當您將游標停留在公司 ID 上時,系統會顯示公司名稱。

國家或地區

customer_countries

將在某個特定國家/地區擁有地址的顧客納入其中。系統可能會將擁有多個地址的顧客納入一個以上同樣使用此篩選條件的顧客群中。

運算子 包含此確切地點:CONTAINS
不包含此確切地點:NOT CONTAINS
不存在:IS NULL
存在: IS NOT NULL
使用由 2 個字母組成的 ISO 國家/地區代碼。
格式
範例 包含在美國擁有地址的顧客:
customer_countries CONTAINS 'US'
備註 如要尋找特定國家/地區,您可以開始輸入國家/地區的名稱,然後從顯示的清單中選擇適當的值。

顧客帳號狀態

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'
備註

標籤不區分大小寫。

深入瞭解標籤及其考量事項

電子郵件事件

shopify_email.EVENT()

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

  • 已退回:bounced
  • 已點擊:clicked
  • 已傳送:delivered
  • 已標示為垃圾郵件:marked_as_spam
  • 已開啟:opened
  • 已取消訂閱:unsubscribed
函數參數 activity_id (選擇性):使用此參數來選取要篩選的行銷活動 ID。
since (選擇性):使用此參數指定事件的開始日期。
until (選擇性):使用此參數指定事件的結束日期。
運算子 等於:=
不等於:!=
數值 truefalse
格式 activity_id 支援的格式:
  • ID (單一數值)
  • List <ID>:隱含「OR」的一組值。List 是一組括入圓括號中以逗號分隔的值。例如:(1, 2, 3)。清單中的活動 ID 數量上限為 500。

    sinceuntil 支援的 Date 格式:
    • 絕對日期: YYYY-MM-DD
    • 日期位移範例:-4w-10y
    • 指定日期:
      • 今天: = today
      • 昨天: = yesterday
      • 過去 7 天內: >= 7_days_ago
      • 過去 30 天內: >= 30_days_ago
      • 過去 90 天: >= 90_days_ago
      • 過去 12 個月: >= 12_months_ago
  • 範例 使用運算子 =!= 說明電子郵件事件是否有發生:
    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

    使用參數 sinceuntil 同時指定電子郵件事件的開始與結束日期:
    shopify_email.bounced(activity_id: 135195754518, since: 12_months_ago, until: today) = false
    備註
    • 使用參數 activity_id 建立顧客群時,您可從顯示的清單中按其名稱選擇行銷活動。
    • 若同時缺少 sinceuntil 參數,即表示會在沒有設定開始或結束日期的情況下篩選所有時間。
    • 若缺少 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 次的顧客。

    預期消費等級

    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 (選用):使用此參數指定顧客已購買且您要篩選的商品。
    tag (選用):使用此參數為顧客已購買且您要篩選的商品指定商品標籤。
    since (選用):使用此參數指定事件的開始日期。
    until (選用):使用此參數指定事件的結束日期。
    運算子 等於:=
    不等於:!=
    數值 truefalse
    格式 id 支援的格式:
  • ID (單一數值)
  • List <ID>:作為清單提供的一組值。例如:(1012132033639, 2012162031638, 32421429314657)。清單 ID 數量上限為 500 個商品 ID。

    支援的 tag 格式:
  • String (單一值)

    sinceuntil 支援的 Date 格式:

    絕對日期:YYYY-MM-DD
    日期位移範例:-4w-10y
    指定日期:
    • 今天: = today
    • 昨天: = yesterday
    • 過去 7 天內: >= 7_days_ago
    • 過去 30 天內: >= 30_days_ago
    • 過去 90 天: >= 90_days_ago
    • 過去 12 個月: >= 12_months_ago
    已命名的日期為預設值,無法加以變更。針對自訂日期,請使用日期位移。
  • 範例 使用運算子 =!= 說明是否有購買商品: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: 30_days_ago) = true
    到 2022 年 1 月 1 日為止:
    products_purchased(until: 2022-01-01) = true

    在日期範圍內,sinceuntil 參數的順序皆無關緊要。您可以使用下列任一方式表達「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
    備註
    • 使用 id 參數建立顧客群時,您可以從顯示產品名稱或產品圖片的清單來選取產品。或者,您可以開始輸入產品標題,然後從清單中選擇。
    • 產品 ID (而非產品名稱) 會輸入到程式碼中。將游標停留在產品 ID 上時,會顯示產品標題和圖片。
    • 若同時缺少 sinceuntil 參數,即表示會在沒有設定開始或結束日期的情況下篩選所有時間。
    • 若缺少 id 即表示您的篩選條件會包含所有商品。

    簡訊訂閱狀態

    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'
    備註 如要尋找特定地區,您可以開始輸入地區的名稱,然後從顯示的清單中選擇適當的值。

    準備好開始透過 Shopify 銷售商品了嗎?

    免費試用