应用扩展和函数

一些应用会使用扩展和函数为您的商店添加功能。扩展和函数由应用开发者进行设置,在您安装并激活应用后即可使用。

扩展允许应用为在线商店、结账、客户账户或 POS 等区域添加功能。例如,应用可能会在您的结账页面中添加自定义字段,在您的在线商店中打开聊天机器人,或者在客户账户中显示忠诚度积分。

Functions 允许应用自定义商店的后端逻辑。例如,应用可能使用 function 来创建自定义折扣类型、在结账时调整配送选项或应用特定的付款规则。在您设置应用后,Functions 会作为商店操作的一部分自动运行。

您可以在 Shopify 后台的设置 > 应用中,查看和管理已安装应用的扩展和 Functions。在应用的关于页面上,扩展和 Functions 卡片会显示当前活跃的扩展和 Functions 数量,以及它们可用于商店的哪些区域。将鼠标悬停在区域文字上,即可查看它们在哪些区域处于活跃状态。例如,扩展可用于结账、客户账户、在线商店或 POS,Functions 可用于结账、折扣、付款或发货和配送。

点击扩展或 Functions,查看该应用的完整列表。在扩展或 Functions 页面上,您可以在活跃和非活跃标签之间切换,查看当前正在运行的扩展或 Functions。点击扩展或 Function 即可打开。根据扩展的不同,您会转到商店中可激活或管理该扩展的区域,或该扩展的运行状况详情。

如果您是应用开发者,请参阅关于扩展的 Shopify 开发人员文档和关于 functions 的 Shopify 开发人员文档以获取技术文档。

激活扩展和 functions

您可以在使用扩展和 functions 的 Shopify 后台区域中激活和停用它们。在应用设置的扩展或 Functions 页面中,点击扩展或 function 名称可导航至可对其进行管理的区域。激活扩展或 function 后,它将在应用的“关于”页面上显示为活动状态。

若您有权查看扩展的运行状况详情,点击结账或客户账户扩展时,打开的将是该扩展的运行状况详情。若要打开这类扩展的编辑器,请将鼠标悬停在扩展所在的行上,然后点击 在编辑器中打开 图标。

扩展

扩展可在 Shopify 后台的以下区域中激活:

Functions

Functions 可在 Shopify 后台的以下区域中激活:

来自扩展程序的应用事件

应用可以使用其结账和客户账户扩展程序将应用事件发送到 Shopify。应用事件记录扩展程序中的行动,例如客户查看优惠。Shopify 会使用应用事件在您的商店分析中显示客户如何使用该应用。应用开发者也可以查看这些事件,以监控和支持其应用,包括用于其分析目的。

只有在客户于您的客户隐私设置中允许进行分析后,系统才会发送有关结账和客户账户的应用事件。Shopify 可能会将与访客 ID 和访问 ID 相关的汇总信息(附加到开发者应用事件中)返回给商家,以便进行商家分析。如果您不希望应用在您的在线店面上发送应用事件,请卸载该应用。

了解扩展运行状况

扩展运行状况反映应用的结账或客户账户扩展在客户使用时能否稳定加载。若应用扩展加载失败,客户便无法使用该扩展为结账或客户账户添加的功能,例如自定义字段或忠诚度积分。

扩展运行状况的注意事项

查看应用的扩展运行状况前,请先了解以下注意事项:

  • 运行状况评估只适用于结账和客户账户中处于活跃状态的扩展。
  • 其他区域(例如在线商店或 POS)的扩展以及 Functions 不在运行状况评估范围内。
  • 失败率采用保守估算,因此加载次数较少的扩展不太容易因少量加载失败而被标记为异常。

扩展运行状况的显示方式

每个结账和客户账户扩展都会显示以下某一种运行状况:

  • 良好:未检测到扩展持续加载失败的情况。
  • 警告:过去 7 天内,扩展的加载失败率超过 5%,且失败率已连续 72 小时高于 5%。
  • 严重:过去 7 天内,扩展的加载失败率超过 50%,且失败率已连续 48 小时高于 50%。
  • 数据不足:没有足够的数据来评估扩展运行状况。若扩展在过去 7 天内的加载次数少于 10 次,或当前版本的历史数据尚不足,就会显示此状态。扩展的每个版本都会单独评估运行状况,因此,最近更新的扩展即使经常加载,也可能显示此状态,直到新版本积累至少 7 天的活动数据。

这些扩展还有详细信息页面,显示运行状况以及过去 7 天的以下指标:

  • 失败率:扩展加载失败的次数占总加载次数的比例。
  • 扩展错误数:扩展报告的错误数量。
  • 扩展加载次数:扩展的加载次数。

查看扩展运行状况

  1. 在 Shopify 后台中,转到设置 > 应用。

  2. 点击要查看的应用。

  3. 点击扩展。

  4. 在活跃标签中,查看各个结账和客户账户扩展的运行状况列。

  5. 可选:点击扩展名称,查看更多详细信息。

处理扩展加载失败问题

若扩展的状态为警告或严重,扩展详细信息页面上的横幅会说明加载失败是由应用问题导致的,并且已通知应用开发者。若要在编辑器中打开扩展,请点击在结账中打开或在客户账户中打开。如需有关扩展的帮助,请联系应用开发者。

若扩展的状态变为严重,有权查看扩展运行状况的员工会在商店的提醒信息流中收到提醒。点击该提醒即可打开扩展详细信息页面。

对 function 错误进行故障排除

如果 function 遇到错误,则应用的“关于”页面上的 Functions 卡片以及 functions 页面上会显示警告。该卡片将显示 [数量] 个区域出现错误,而不是通常显示的可用区域数,并且该警告会指示检测到最新错误的时间。

在函数页面上,出现错误的函数会以 Warning 图标突出显示。如果函数出现错误,请联系应用开发者寻求帮助。在某些情况下,错误可能已得到解决。您还可以共享函数日志,以帮助开发者排查问题。