对 WooCommerce 集成进行故障排除
你将会学到
了解如何按照下述相关故障排除方案解决 WooCommerce 集成设置的问题。如果您遇到的问题不在此列表中,请通过社区或我们的支持团队联系。
开始之前
如果您还没有阅读我们的WooCommerce 入门 指南,了解有关集成的分步说明。如果您想升级插件,请查看我们关于如何升级 WooCommerce 插件 的文章。
故障排除场景
根据应用内收到的错误消息,参考以下方案来解决您的问题。请注意,如果您选择删除集成然后重新集成,您的 WooCommerce 数据将不会从 Klaviyo 中删除。 ###“为了避免功能中断,您可能需要禁用以下插件:插件名称”
如果您在 WordPress 中有活动的缓存插件或重定向插件,这些插件可能会干扰 Klaviyo 的集成并导致连接问题。我们建议在集成设置过程中禁用这些插件。
###“我们无法完成您的设置”
此消息意味着您的防火墙阻止了 Klaviyo 的请求,或者您在 Cloudflare 中启用了 Bot Fight 模式,或者两者兼而有之。要解决此问题,我们建议将 Klaviyo 集成流量列入白名单并禁用 Bot Fight 模式(如果您已启用)。
- 了解如何将 Klaviyo 集成流量 IP 地址列入白名单。
- 要在 Cloudflare 中禁用 Bot Fight 模式:
- 登录Cloudflare仪表板。
- 选择您的帐户和域。
- 转到安全 > 机器人。
- 对于机器人战斗模式,选择 关闭。
“确保您的 WooCommerce 商店启用了 https 和 SSL”
Klaviyo 希望您的商店 URL 遵守 HTTPS 协议,这意味着该网站具有有效的 SSL 证书。如果您的网站使用 HTTP 而不是 HTTPS,您可能会遇到问题。您可以在SSL服务器测试(由Qualys SSL Labs提供支持)检查您的SSL证书是否有效。 Klaviyo 要求测试以 A 级通过。
“无法使用提供的凭据访问 API”
如果您进行了自定义以阻止非登录用户访问 API,则可能会收到此错误。通常,这是 functions.php WordPress 文件中的一个函数,它会触发 401 状态代码响应。如果您有这样的自定义,请将其删除或注释掉以消除错误。有关此错误的更多信息,请查看 WooCommerce REST API 常见问题解答。 ###“无法访问订单 API,请检查连接设置并重试”
此错误意味着当 Klaviyo 尝试验证 WooCommerce 集成并获取订单计数时,他们的 API 不会返回 Klaviyo 期望的值,或者根本不返回任何内容。由于集成尚未正式连接到 Klaviyo,这意味着它需要在 WooCommerce 内解决。要获取有关此错误的更多信息,您需要对订单计数端点进行 API 调用,这将更深入地了解传递给 Klaviyo 的内容。下面是一个 cURL 请求示例。要使用它,请填写您的商店 URL、消费者密钥和消费者秘密:
卷曲 https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET
“您的 Klaviyo 插件已过时”
有时,Webhook 到达 Klaviyo 时会出现延迟,导致您暂时看到旧的设置页面。几分钟后此问题应该会自行解决。
从 WordPress 连接到 Klaviyo 时出现 404
要解决此问题,您应该确认您已为 WordPress 网站启用了永久链接。除非启用永久链接,否则 WooCommerce 身份验证将无法工作。
- 导航到您的 WordPress 网站并转到 设置 > 永久链接。
- 在 通用设置 下,选择除 普通 之外的任何链接结构。
- 单击保存更改进行确认。
- 完成后,重新与 Klaviyo 集成。
安装失败 – 我们无法安装您的扩展
尝试通过 [WooCommerce 安装集成] 时,您可能会遇到“安装失败”错误市场](https://woocommerce.com/products/klaviyo-for-woocommerce/?utm_source=extensionsscreen&utm_medium=product&utm_campaign=wcaddons&in_app_label=promoted&wccom-site=https%3A%2F%2Fvoluntory-plat ypus.jurassic.ninja&wccom-back=%252Fwp-admin%252Fadmin.php%253Fpage%253Dwc-admin%2526path%253D%25252F扩展&wccom-woo-version=10.3.5&wccom-connect-nonce=48111ee6ce&utm_group=发现我们的最爱)。
如果您无法从 WooCommerce Marketplace 成功安装,您还可以从 WordPress 插件管理员安装该插件。
- 导航到您的 WordPress 管理员并转到插件。
- 选择添加插件。
- 在搜索插件中搜索Klaviyo。
- 选择立即安装。
- 选择激活。
- 从左侧导航中选择营销,然后单击Klaviyo。
- 单击 连接帐户 开始,然后继续在 [入门] 中的 启用 WooCommerce 集成 WooCommerce](https://help.klaviyo.com/hc/en-us/articles/115005255808) 文章。