帮助
登录

获取客户数据

在使用客户数据的工作流中，您可以使用获取客户数据操作从您的商店中检索客户信息。

在此页面上

配置

字段

获取客户数据操作包含以下字段，这些字段用于构建查询：

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

查询字符串

以下是获取在过去一天内已更新的客户的查询示例：

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

updated_at 变量是客户查询上可用的一个筛选条件，可以多次使用或与其他变量结合使用。`scheduledAt` Liquid 变量适用于使用计划时间触发器的工作流。date_minus Liquid 标记是一个特殊的 Flow 标记，可用于从日期中减去时间。

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

  • 可用客户筛选条件列表
  • 查询必须遵循特定语法
  • 查询字段值并未始终记录在文档中。在某些情况下，可通过查看 API 文档来查找这些值。或者，您通常可以在后台中进行筛选时在 URL 中找到字段值。例如，若要查找某些订单查询值，请在后台中筛选“订单”页面，然后检查 URL。
  • 您可以使用 Shopify GraphiQL 应用在您的商店中运行或测试查询。
  • 请注意查询失败时的情况。API 通常会返回所有结果（而不是不返回任何结果）。

返回的数据

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

  • 如果您需要单独处理每个列表项（例如为每个列表项添加标记），则可以使用 For each 操作。
  • 如果您需要聚合数据（例如统计返回的结果数），则可以使用 Count 或 Sum 操作。
  • 如果您需要输出列表（例如发送包含所有商品的电子邮件），则可以在后续操作中直接使用返回的数据。

若要在此操作之后的步骤中访问返回的数据，请使用名为获取客户数据的变量，它是一个客户列表。您可以在条件和操作中都使用此变量。例如，您可以像下面这样在发送内部电子邮件操作中发送订单列表：

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

触发器

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

API 详细信息

模板

将所有客户的客户元字段转换为标记

此工作流将根据元字段值为您的所有客户回填标记。它每小时运行一次，并获取最多 100 名没有“processed”标记的客户。对于每位客户，它会查看 custom.test 元字段的值，并将其添加为标记。该工作流还会添加“processed”标记，这样在下一次计划的工作流运行时就不会返回该客户。若要使用此工作流，您需要更改元字段命名空间和密钥，以匹配您商店中的元字段。查看模板

删除不活跃客户

删除超过 5 年且从未下达任何订单的客户。查看模板