說明
登入

取得未完成結帳作業資料

在需要未完成結帳作業資料的工作流程中，您可以使用 取得未完成結帳作業資料動作從您的商店擷取未完成結帳作業資訊。未完成結帳作業代表顧客已開始但尚未完成的結帳頁面工作階段。

頁面導覽

設定

欄位

取得未完成結帳作業資料動作包含下列欄位：

取得資料動作中使用的欄位。
欄位說明
資料排序方式必填。做為搜尋查詢傳回資料的排序依據參數。
結果數量上限必填。您選取的搜尋查詢可傳回的結果數量上限。一次最多可傳回 100 筆。
查詢必填。從常見查詢中選擇，或選取「進階」以建立自訂查詢。

查詢字串

以下是取得過去一天內建立的未完成結帳作業的查詢範例：

created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

created_at 變數是未完成結帳作業查詢中可用的篩選條件，並且可重複使用或與其他變數結合使用。scheduledAt Liquid 變數可用於採用排程時間觸發條件的工作流程。date_minus Liquid 標籤是特殊的 Flow 標籤，可讓您從日期中減去時間。

查詢資料時，建議您瞭解以下資訊：

  • 可用的未完成結帳作業篩選條件清單

  • 查詢必須遵循特定的語法

  • 查詢欄位值不一定會有相關記錄。在某些情況下，查看 API 文件可以找到這些值。此外，當您進行篩選時，通常可以在管理介面的網址中找到欄位值。例如，若要尋找某些「訂單」查詢值，可以篩選管理介面中的「訂單」頁面，然後查看其網址。

  • 您可以使用 Shopify GraphiQL app在您的商店中執行或測試查詢。

  • 請留意查詢失敗時會發生的情況。通常 API 會傳回所有結果 (而不是不傳回任何結果)。

傳回資料

所有取得資料動作都會傳回 0 到 100 項資源的清單。視您的使用案例而定，您可能希望以各種方式使用此資料：

  • 若您需要分別處理每個清單品項，例如為每個品項新增標籤，則可以使用 For each 動作。
  • 若您需要彙整資料，例如計算傳回多少結果，則可以使用 Count 或 Sum 動作。
  • 若您需要輸出清單 (例如寄送包含所有品項的電子郵件)，您可以直接在後續動作中使用傳回資料。

若要在此動作後的步驟中存取傳回資料，請使用名為取得未完成結帳作業資料的變數，此變數代表未完成結帳作業的清單。您可以在條件和動作中皆使用此變數。例如，您可以在類似下列的寄送內部電子郵件動作中，寄送未完成結帳作業的清單：

{% for single_checkout in getAbandonedCheckoutData %}
  * {{ single_checkout.email }} - {{ single_checkout.totalPrice }}
{% endfor %}

觸發條件

您可以在任何工作流程中使用此動作，包括排程時間觸發條件。在使用排程時間觸發條件的工作流程中，工作流程會在您指定的時間開始，而不是因事件而觸發。由於您的商店或 app 沒有開始此工作流程的特定事件，因此系統不會自動包含任何資料。

API 參考資料

如需此動作中所用 API 的詳細資訊，請參閱未完成結帳作業查詢。