使用 GenderAPI 应用为 Shopify 客户数据补充信息

使用原生应用为客户补充数据

GenderAPI Shopify 应用可以处理现有客户和新客户，添加性别预测，并根据电子邮箱地址推断缺失的名字。请从正确的 Shopify 店铺开始，并选择与您想要更新的客户字段相匹配的设置。

这是一个原生 Shopify 应用，有自己的处理和方案设置。2026年9月27日审核的实现不会调用公开的 V2 预测端点。不要默认您的 API 密钥余额、V2 的 AI 选项或 V2 的响应字段适用于此应用。

在 Shopify App Store 中打开 Gender API - Determine gender。安装之前，请核实开发者 Ozan Soft、目标店铺、当前权限和方案。
查看应用的余额及其客户处理设置。决定是处理现有客户、启用对新客户的自动处理，还是两者都要。
检查一小组客户记录，其中包括已填写名字、缺少名字以及输入含义不明确的记录。复核结果时，请保持现有的名字和标签可见。
只有当需要把从电子邮箱地址推断出的候选值写入客户的名字字段时，才启用缺失名字补全。性别预测和名字修改是两个独立的决定。
在把创建的标签和客户元字段用于细分之前，请先检查它们。确认客户的其他信息保持不变。

下面的映射描述的是审核过的应用源代码。在连接后续工作流之前，请在已安装的应用中并用受控的样本核实这些映射。

客户字段或设置	方向	行为
名字	输入	存在名字时优先使用的输入。
电子邮箱	输入	在缺少名字时用于推断候选名字。没有可用名字的地址可能仍然无法解析。
地址中的国家/地区	可选背景	处理时可能会把客户地址中可用的国家/地区作为姓名查询的背景信息。
客户标签	输出	审核的实现使用 male、female 或 gender_null，并保留无关的标签。
custom.gender	输出	一个客户元字段，以单行文本值的形式存放推断出的标签。
名字更新	可选输出	启用该功能时，从电子邮箱地址推断出的候选值可能会填入缺失的名字。实现会添加 first_name_found_from_email。
自动补充数据	应用设置	控制对新客户事件的处理。是否可用取决于方案和应用设置。

在 Shopify 中打开一位已处理的客户，并将其标签、custom.gender 和名字与原始记录进行比较。在细分中，请使用实际保存的字段和标签，而不要默认可以使用某个 API 的 JSON 路径。

审核的流程会跳过已带有 male、female 或 gender_null 标签的客户。因此，一条未发生变化的记录可能是已有的分类，而不是新的查询。在开始重新运行之前，请决定如何复核之前的分类。

请把 gender_null 视为未解析的结果。原生映射不提供 V2 的置信度值、来源字段或每个请求的 usage 记录。不要在表格导出中编造这些值，也不要把未知结果转换为二元分类。

结果	建议的下一步
预期的标签和元字段	核实源客户 ID，并只允许计划中的细分或后续更新。
gender_null	把该情况保留为未解析，并将其排除在需要 identified 结果的规则之外。
已有的性别标签	在决定重新处理之前，检查应用是否跳过了该客户。
更新缺失或不一致	在重新运行整组客户之前，先在应用中检查处理状态。

请在 Shopify 应用当前的方案和余额界面中查看客户处理的限制。审核的应用为每个店铺维护一个积分余额，并通过 Shopify 处理购买。它不使用公开的 GenderAPI 密钥进行配置。请在应用页面上查看当前价格，而不要套用 V2 的积分费率。

该应用需要访问客户数据，并且可能会修改客户记录。处理过程包含一个应用端的队列。因此，有关电子邮箱请求保留期限的信息，不应被理解为该工作流从不存储任何客户数据的承诺。请查看应用的权限以及适用于您店铺的已发布政策。

推断出的标签是数据中的概率性信号。请把它与本人提供的信息分开保存，不要把它作为资格、访问权限、价格或其他有重大影响的决策的唯一依据。

对于自定义集成，GenderAPI V2 接受姓名、电子邮箱地址和用户名，并返回明确的结果、置信度、来源和用量字段。请单独配置这一连接：阅读 V2 指南并不会改变已安装的应用或其输出列。

Python 和 Node.js 示例涵盖单个请求、批量请求、unknown 结果和运行错误。请先阅读身份验证指南，并在发送计费请求之前选择 AI 模式。

需要用我的 V2 API 密钥配置 Shopify 应用吗？

审核的原生应用依赖于 Shopify 中的安装、自身的方案设置以及每个店铺的余额。自定义的 V2 HTTP 工作流是一个单独的集成，不能取代原生应用的设置。

在哪里可以找到客户的推断标签？

审核的应用会写入客户标签和客户元字段 custom.gender。在基于这些值创建细分之前，请先检查已安装的应用和一位示例客户。

gender_null 是什么意思？

该值表示审核的原生应用中一个未解析的标签。请把该客户保留在未知结果组中，而不要把该值转换为 male 或 female。

可以让客户的名字保持不变吗？

请把缺失名字补全的设置与性别处理分开检查。只有当应用需要用从电子邮箱地址推断出的候选值填入缺失的名字时，才启用该设置。

本指南最近一次审核于 2026年9月29日。请在平台文档中确认安装方式；如需单独构建 V2 集成，请使用下列 API 文档。