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

標籤不區分大小寫。

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

電子郵件事件

shopify_email.EVENT()

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

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

    sinceuntil 支援的 Date 格式:
    絕對日期:YYYY-MM-DD
    日期位移範例:
    7 天前::-7d
    4 週前::-4w
    3 個月前::-3m
    1 年前::-1y

    指定日期::today:yesterday
    已命名的日期為預設值,無法變更。針對自訂日期,請使用日期位移。

    提供過去 26 個月內的電子郵件活動,資料從 2022 年 3 月開始。

    支援 count_at_leastcount_at_mostcount 格式:
    編號:#
  • 範例 使用運算子 =!= 說明電子郵件事件是否有發生:
    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 參數,即表示會在過去 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 (選用):使用此參數指定事件的結束日期。

    運算子

    等於:=

    不等於:!=

    truefalse
    格式

    支援 count_at_leastcount_at_mostcount 格式:
    編號:#

    支援 amount_at_leastamount_at_mostamount 格式:
    編號:#

    支援 sum_amount_at_leastsum_amount_at_mostsum_amount 格式:
    編號:#

    支援 Datesinceuntil 格式:
    絕對日期: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

    在日期範圍內,sinceuntil 參數的順序皆無關緊要。您可以使用下列任一方式表達「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_leastamount_at_most amountsum_amount_at_leastsum_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 (選用):使用此參數指定事件的結束日期。
    運算子 等於:=
    不等於:!=
    數值 truefalse
    格式 支援的 tag 格式:
    String (單一值)
    支援的 ID 格式:ID (單一值)
    List <ID>:作為清單提供的一組值。例如:(1012132033639, 2012162031638, 32421429314657。清單中的商品 ID 數量上限為 500 個。
    sinceuntil 支援的 Date 格式:
    絕對日期:YYYY-MM-DD
    日期位移範例:
    7 天前::-7d
    4 週前::-4w
    3 個月前::-3m
    1 年前::-1y

    指定日期::today:yesterday
    已命名的日期為預設值,無法加以變更。
    支援 quantity_at_leastquantity_at_mostquantity 格式:
    編號:#
    支援 sum_quantity_at_leastsum_quantity_at_mostsum_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

    在日期範圍內,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
    篩選最近購買大量具有特定標籤商品的顧客:
    products_purchased(tag: 'product_tag', sum_quantity_at_least: 3, since: -90d) = true
    備註
    • 使用 id 參數建立顧客群時,您可以從顯示產品名稱或產品圖片的清單來選取產品。或者,您可以開始輸入產品標題,然後從清單中選擇。
    • 產品 ID (而非產品名稱) 會輸入到程式碼中。將游標停留在產品 ID 上時,會顯示產品標題和圖片。
    • 若同時缺少 sinceuntil 參數,即表示會在沒有設定開始或結束日期的情況下篩選所有時間。
    • 若缺少 parameters 即表示您的篩選條件會包含將包含所有時間所購買的商品

    簡訊訂閱狀態

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

    店面事件

    storefront.EVENT()

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

    • 商品已查看:product_viewed
    • 商品系列已查看:collection_viewed


    函數參數 id (選用):使用此參數指定您要篩選的商品或商品系列。
    since (選用):使用此參數指定事件的開始日期。
    until (選用):使用此參數指定事件的結束日期。
    count_at_least (選用):使用此參數指定商品或商品系列的最低檢視次數。
    count_at_most (選用):使用此參數指定商品或商品系列的最高檢視次數。
    count (選用):使用此參數指定商品或商品系列的確切檢視次數。
    事件專用的參數 tag (可選):使用此參數指定要篩選的商品標籤。 這與篩選帶有該標籤的每種商品 ID 的作用相同。
    運算子 等於:=
    不等於:!=
    數值 truefalse
    格式 id 支援的格式:
  • ID (單一數值)
  • List <ID>:作為清單提供的一組值。例如:(1012132033639, 2012162031638, 32421429314657)。清單 ID 數量上限為 500 個商品 ID。

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

    sinceuntil 支援的 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

    使用參數 sinceuntil 指定店面事件的開始日期和結束日期:
    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

    在日期範圍內,sinceuntil 參數的順序皆無關緊要。您可以使用下列任一方式表達「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 上時,會顯示商品或商品系列標題和圖片。
    • 商品系列會使用儲存為商品系列縮圖的圖片 (如適用)。若不適用,系統將顯示一般圖片預留位置。
    • 由於資料留存,若在沒有設定開始或結束日期的情況下,因缺少 sinceuntil 參數,即表示會在過去 26 個月的資料中篩選結果。
    • 若缺少 id 即表示您的篩選條件會包含所有商品。

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

    免費試用