帮助
登录

获取弃单数据

在需要弃单数据的工作流中，您可以使用获取弃单数据操作从您的商店检索弃单信息。弃单是指已开始但未完成的客户结账访问。

本页面的内容

配置

字段

获取弃单数据操作包含以下字段：

在“获取数据”操作中使用的字段。
字段描述
数据排序方式必填。作为搜索查询返回的数据排序依据的参数。
最大结果数必填。您选择的搜索查询可返回的最大结果数。您一次最多可返回 100 个结果。
查询必填。从常见查询中进行选择，或选择高级以自行创建查询。

查询字符串

以下为获取过去一天内创建的弃单的示例查询：

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

created_at 变量是弃单查询中的可用筛选条件，可以多次使用或与其他变量结合使用。scheduledAt 动态占位符可用于使用了预定时间触发器的工作流。date_minus Liquid 标记是一种特殊的 Flow 标记，允许您从日期中减去时间。

查询数据时，了解以下信息对您很有帮助：

  • 可用弃单筛选条件列表

  • 查询必须遵循特定语法

  • 查询字段值不一定都有相应的文档记录。在某些情况下，您可以通过查看 API 文档来找到这些值。另外，进行筛选时，您通常可以在后台的 URL 中找到字段值。例如，若要查找某些订单查询值，请在后台的“订单”页面中进行筛选，然后检查 URL。

  • 您可以使用 Shopify GraphiQL 应用在您的商店中运行或测试查询。

  • 请留意查询失败时的后果。通常，API 会返回所有结果（而不是完全不返回结果）。

返回的数据

所有获取数据操作都会返回包含 0 到 100 个资源的列表。根据用例，您可以通过多种方式使用此数据：

  • 如果您需要单独处理每个列表项（例如为每个列表项添加标记），您可以使用遍历操作。
  • 如果您需要聚合数据（例如对返回的结果数进行计数），您可以使用计数或求和操作。
  • 如果您需要输出该列表（例如发送一封包含所有项目的电子邮件），您可以直接在后续操作中使用返回的数据。

若要在执行此操作之后的步骤中访问返回的数据，请使用名为 Get abandoned checkout data 的变量（它是一个弃单列表）。您可以在条件和操作中使用此变量。例如，您可以在 Send internal email 操作中发送弃单列表，示例如下：

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

触发器

您可以在任何工作流中使用此操作，包括具有预定时间触发器的工作流。在具有预定时间触发器的工作流中，工作流会在您指定的时间启动，而不是由于某个事件而启动。由于您的商店或应用中没有任何会导致该工作流启动的特定事件，因此不会自动包含任何数据。

API 参考

有关此操作中使用的 API 的详细信息，请参阅弃单查询。