帮助
登录

Checkout Blocks 内容故障排除

出于多种原因，您的 Checkout Blocks 内容可能无法按预期显示，导致元素消失或无法正常运行。常见问题包括未满足显示规则、权限配置错误，或区块本身的设置与将区块添加到结账和账户编辑器中的方式之间存在差异。

本指南可帮助您自行排查和解决常见的 Checkout Blocks 问题。如果在查看本指南中的步骤后仍有问题，请联系 Shopify 支持以获取帮助。

在本页面

区块故障排除

区块是在结账页面中显示内容的自定义元素，例如自定义字段、动态内容和横幅。如果某个区块未按预期运行，请使用以下部分来确定并解决问题。

区块未在结账页面中显示

区块未添加到编辑器

在 Checkout Blocks 应用中创建内容块不会自动将其添加到结账页面。您需要使用结账和账户编辑器将内容块添加到您的结账配置中。

步骤：

  1. 在 Shopify 后台中，转至设置 > 结账。
  • 在配置部分，点击您要修改的配置旁边的自定义。
  • 导航到您希望在其中显示该区块的结账页面。
  • 点击 ⊕ 添加区块，然后选择相应的区块类型。
  • 配置区块 ID，使其与您在 Checkout Blocks 中创建的区块的 ID 匹配。
  • 点击保存。
    • 区块未设置为“激活”状态

    区块必须设置为激活状态才能在结账页面中显示。草稿区块不会向客户显示。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击区块。
  • 点击您想激活的区块。
  • 在状态部分，选择激活。
  • 点击保存。
    • 区块未发布到市场或页面

    如果您的区块配置了特定于市场的发布设置，则它只会在您选择的市场中显示。如果该区块仅发布到特定的结账页面，则它不会在其他页面上显示。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击区块。
  • 点击您要查看的区块。
  • 在发布部分，确认该区块已发布到所有适用的市场。
  • 在结账页面部分，确认该区块设置为在所有适用的结账页面上显示。
  • 点击保存。
    • 未满足显示规则

    显示规则定义了内容块要在结账时显示所必须满足的条件。如果客户在结账流程中未满足这些条件，则不会显示该内容块。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击区块。
  • 点击未显示的区块。
  • 查看为该区块配置的显示规则。
  • 验证您的测试结账是否满足所有必需的条件，例如购物车总额阈值、产品类型或客户登录状态。
  • 如果您已设置为仅当满足所有规则时显示，请确保满足每项规则。如果您已设置为仅当满足任一规则时显示，请确保至少满足一项规则。
    • 区块 ID 不匹配

    结账和账户编辑器中的每种区块类型都有一个 区块 ID 设置。编辑器中的区块 ID 必须与您在 Checkout Blocks 应用中创建的区块的区块 ID 匹配。如果 ID 不匹配，则不会显示该区块。

    例如，如果您的区块在 Checkout Blocks 应用中的区块 ID 为 4，那么结账和账户编辑器中的区块也必须将其区块 ID 设置为 4。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击区块。
  • 点击未显示的区块，并记下其区块 ID。
  • 转至设置 > 结账。
  • 在配置部分，点击您要检查的配置旁边的自定义。
  • 点击编辑器中应显示您内容的区块。
  • 在区块设置中，确认区块 ID 与第 3 步中的 ID 匹配。
  • 如果 ID 不匹配，则更新区块 ID 使其匹配。
  • 点击保存。
    • “预览区块 ID（用于测试）”字段包含值

    结账和账户编辑器中的 预览区块 ID (用于测试) 字段仅用于测试。如果在保存结账后此字段仍包含值，则它可能会覆盖区块的显示规则并导致意外行为。

    步骤：

    1. 在 Shopify 后台中，转至设置 > 结账。
  • 在配置部分，点击您要检查的配置旁边的自定义。
  • 点击未正确显示的区块。
  • 在预览区块 ID (用于测试) 字段中，删除所有值，使该字段为空。
  • 点击保存。
    • 显示了优先级更高的区块

    如果您有多个具有重叠显示规则的同类型内容块，则只会显示优先级最高的内容块。详细了解内容块优先级。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击区块。
  • 点击 ⇅ 编辑优先级。
  • 选择未显示的区块类型。
  • 查看优先级顺序。数字越小的区块优先级越高。
  • 调整优先级数字以更改首先显示的区块。
  • 点击保存。
    • 对已达到有效区块数量上限的问题进行故障排除

    Checkout Blocks 每种区块类型最多支持 30 个有效区块。如果您有超过 30 个单一类型的有效区块（例如 35 个有效的自定义字段区块），那么结账时只能显示前 30 个区块。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击区块。
  • 按您正在进行故障排除的区块类型进行筛选。
  • 计算有效区块的数量。
  • 如果您有超过 30 个有效区块，请停用或删除任何不再需要的区块。

    • 区块在结账时多次显示

    对添加到共享分区的区块进行故障排除

    根据您在结账和账户编辑器中添加区块的位置，它可能会在结账的每个步骤中都显示。订单摘要分区和附加到“继续”或“返回”按钮的区域在所有结账页面上都保持一致。

    若要使区块仅在特定步骤中显示，请将该区块添加到该步骤的主要内容区域。

    步骤：

    1. 在 Shopify 后台中，转至设置 > 结账。
  • 在“配置”分区中，点击您要修改的配置旁边的“自定义”。
  • 点击多次显示的区块。
  • 请注意该区块所在的分区。如果它位于订单摘要分区或附加到“继续”或“返回”按钮，则该区块会显示在每个结账页面上。
  • 若要使区块仅在特定页面上显示，请从当前分区中删除该区块，并将其添加到所需结账页面的主要内容区域。
  • 点击保存。
    • 对添加了多个区块实例的问题进行故障排除

    某些区块类型（例如订单项目编辑区块）通常只需添加到结账一次。该区块依赖于显示规则在不同场景下显示不同内容。如果区块内容重复，则说明您可能无意中添加了多次该区块，超出了所需次数。

    步骤：

    1. 在 Shopify 后台中，转至设置 > 结账。
  • 在配置部分，点击您要检查的配置旁边的自定义。
  • 导航到结账的每个页面并查看已添加的区块。
  • 如果您发现类型和区块 ID 相同的重复区块，请点击该区块并选择删除区块以删除多余的区块。
  • 点击保存。

    • 对创建或保存区块时的错误进行故障排除

    如果您在尝试创建或保存区块时收到错误，请查看以下部分。

    对“您的表单提交存在一些问题”错误进行故障排除

    此错误通常表示您的员工账户缺少在 Checkout Blocks 中创建区块所需的权限。

    所需权限：

    • 商店权限 > 内容：员工必须拥有查看和创建和编辑元对象定义以及查看和创建和编辑条目的权限。
    • 商店权限 > 商店设置：员工必须拥有管理设置权限。
    • 应用权限：员工必须至少拥有 Checkout Blocks 的权限。

    步骤：

    1. 在 Shopify 后台中，转至设置 > 用户和权限。
    2. 点击遇到错误的员工账户。
    3. 在商店权限下，展开内容分区。
    4. 确认已为元对象定义选择查看和创建和编辑权限。
    5. 确认已为条目选择查看和创建和编辑权限。
    6. 在商店设置下，请确认已选中管理设置。
    7. 在应用权限下，确认已选择 Checkout Blocks。
    8. 点击保存。

    如果您没有修改员工权限的权限，请联系店主或拥有用户管理权限的员工。

    对自定义折扣进行故障排除

    由于多种因素，在 Checkout Blocks 中创建的自定义折扣可能无法按预期应用。

    对已达到有效自动折扣数量上限的问题进行故障排除

    Shopify 一次最多允许 25 个有效的自动折扣，包括来自所有已安装应用且基于应用的折扣。此限制适用于您的整个商店，而不仅限于 Checkout Blocks。

    如果您尝试激活第 26 个自动折扣，那么它将不会在结账时应用。

    步骤：

    1. 在 Shopify 后台中，转至折扣。
    2. 进行筛选以仅显示自动折扣。
    3. 计算当前有多少个有效的自动折扣。
    4. 如果您有 25 个或更多有效的自动折扣，请在激活新折扣前，先停用或删除不再需要的折扣。

    详细了解组合折扣时的限制。

    对折扣未生效的问题进行故障排除

    自定义折扣必须设置为有效才能在结账时应用。此外，根据其配置的开始和结束日期，该折扣也不得过期。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击折扣。
  • 点击未应用的折扣。
  • 在状态分区中，确认折扣设置为有效。
  • 在有效日期分区中，确认当前日期在配置的开始和结束日期之内。
  • 点击保存。
    • 对未满足折扣规则的问题进行故障排除

    Checkout Blocks 中的自定义折扣可以有详细的条件规则，用于确定折扣的应用时间。如果客户在结账期间未满足这些条件，则折扣将不适用。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击折扣。
  • 点击未应用的折扣。
  • 查看为折扣配置的规则和条件。
  • 验证您的测试结账是否满足所有必要条件，例如最低订单价值、特定产品或产品系列，或客户资格要求。
  • 根据需要调整折扣规则。
  • 点击保存。

    • 配送和付款方式自定义的故障排除

    如果配送或付款方式未按预期隐藏、重命名或重新排序，请查看以下部分。

    对未激活的自定义进行故障排除

    配送或付款方式自定义必须设置为激活状态，才能在结账时应用。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击 Functions。
  • 点击不起作用的自定义。
  • 在状态部分，确认自定义已设置为激活。
  • 点击保存。
    • 对已达到激活的 Functions 数量上限问题进行故障排除

    Shopify Functions 对每种类型的可启用函数数量设有限制。您最多可在每个商店激活 25 个支付自定义函数。如果您超出此限制，则可能会收到以下错误：无法启用自定义。请重试或联系支持人员。

    这些上限有助于确保结账流程保持高性能。您需要合并或删除自定义以确保不超过上限。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击 Functions。
  • 统计您有多少个已激活的配送方式自定义（如果正在对配送问题进行故障排除），或多少个已激活的付款方式自定义（如果正在对付款问题进行故障排除）。
  • 如果已达到该类型的上限，请停用或删除不再需要的自定义。
  • 请再次尝试激活您的新自定义。
    • 对未满足自定义规则的问题进行故障排除

    配送和付款方式自定义依赖于确定自定义应用时间的规则。如果在客户结账期间未满足这些条件，则自定义将不会生效。

    步骤：

    1. 在 Shopify 后台中，转至应用 > Checkout Blocks。
  • 点击 Functions。
  • 点击不起作用的自定义。
  • 查看为自定义配置的规则。
  • 验证您的测试结账是否满足所有必要条件。
  • 根据需要调整规则。
  • 点击保存。

    • 通过测试结账验证您的更改

    在实时环境中依赖您的 Checkout Blocks 自定义之前，您应通过测试结账来验证它们是否按预期工作。

    步骤：

    1. 在您的在线商店中，将与您想测试的块、折扣或自定义的条件相匹配的产品添加到购物车。
    2. 继续结账，但不要完成购买。
    3. 查看结账的每个步骤并验证以下各项：
      • 块在正确的位置以正确的内容显示。
      • 满足资格要求时，自定义折扣会应用。
      • 配送和付款方式自定义按预期运行。
    4. 如果您要测试基于购物车总额的显示规则，请尝试不同的购物车金额以确认块在正确的阈值时显示和消失。
    5. 如果您正在测试基于客户的显示规则，请同时测试已登录客户结账和游客结账两种场景。

    常见问题

    我可以同时激活多少个块？

    每种类型的块最多可以有 30 个处于激活状态。例如，您可以同时拥有 30 个激活的自定义字段、30 个激活的动态内容块和 30 个激活的订单项目编辑块。您可以创建超过 30 个同类型的块，但只有前 30 个激活的块才能在结账时显示。

    为什么我需要特定的员工权限才能使用 Checkout Blocks？

    Checkout Blocks 会创建元对象定义来存储内容块配置。员工成员需要拥有创建和编辑元对象定义及条目的权限才能在应用中保存内容块。此外，员工还需要商店设置下的管理设置权限以及 Checkout Blocks 的显式应用权限。

    如果我未订阅 Shopify Plus，是否可以使用 Checkout Blocks？

    订阅 Basic 套餐或更高级别套餐的商家只能在其“感谢惠顾”页面和“订单状态”页面上使用动态内容和静态内容块。所有其他 Checkout Blocks 功能（包括自定义字段、自定义折扣以及配送/付款方式自定义）都需要 Shopify Plus 套餐。

    我如何知道要使用哪个块 ID？

    在 Checkout Blocks 应用中创建内容块时，系统会为其分配一个内容块 ID（默认为 0）。在编辑器中将该内容块类型添加到结账页面时，您需要设置相同的内容块 ID，以便编辑器知道要显示哪个特定内容块。如果要在不同位置显示同一类型的不同内容块，则需要为每个内容块分配唯一的内容块 ID，并在编辑器中匹配这些 ID。详细了解内容块 ID。

    我可以将 Checkout Blocks 折扣与其他折扣组合使用吗？

    在 Checkout Blocks 中创建的自定义折扣是由 Shopify Functions 提供支持的自动折扣。它们遵循与其他自动折扣相同的折扣组合规则。您的商店中最多可以有 25 个有效的自动折扣，包括在 Checkout Blocks 和其他应用中创建的折扣。

    就 Checkout Blocks 相关问题联系 Shopify 支持之前

    如果您已尝试上述故障排除步骤，但您的 Checkout Blocks 问题仍然存在，则可以联系 Shopify 支持以获取帮助。在联系 Shopify 支持之前，请收集以下特定于 Checkout Blocks 的信息，以帮助更快地解决您的问题：

    • 块详细信息：不起作用的块的名称、类型（例如自定义字段、动态内容或订单项目编辑）和块 ID
    • 配置屏幕截图：Checkout Blocks 应用中块设置的屏幕截图，包括任何显示规则、发布设置和状态
    • 编辑器屏幕截图：关于如何在结账和账户编辑器中配置块的屏幕截图，包括块 ID 和预览块 ID 字段
    • 错误消息：在创建、保存或预览块时收到的任何错误消息的屏幕截图或确切文本
    • 测试结账 URL：可重现问题的测试结账或弃单的链接，以及用于触发显示规则的购物车内容
    • 预期行为与实际行为：清楚地描述您预期的结账流程行为与实际发生的行为
    • 已完成的故障排除步骤：您已查看本指南中的哪些部分以及您已尝试了哪些操作
    • 员工权限：确认您的账户拥有以下各项的所需权限：内容（元对象定义和条目）、商店设置（管理设置）以及应用权限 (Checkout Blocks)

    准备好这些 Checkout Blocks 专属信息有助于 Shopify 支持更高效地诊断并解决您的问题。