sales-klaviyo

Klaviyo 平台帮助

帮助用户解答 Klaviyo 平台相关问题，涵盖流程和营销活动、细分、预测分析、多渠道消息（电子邮件、短信、WhatsApp、RCS、推送通知）、表单、评论、目录、优惠券、报告、模板、Customer Hub，以及 Klaviyo Data Platform（CDP）。Klaviyo 是一个以 AI 为先的 B2C CRM 和营销自动化平台，专注于电商领域，由 Andrew Bialecki 和 Ed Hallen 于 2012 年创立，于 2023 年上市（NYSE：KVYO）。目前为 19.3 万多个品牌提供服务，拥有 73 亿个客户档案。

第 1 步 — 收集背景信息

如果 references/learnings.md 存在，请先阅读其中积累的知识。

询问用户：

1. 您需要 Klaviyo 哪方面的帮助？

   • A) 流程 — 可视化自动化构建器（欢迎流程、弃购、购买后、唤回、浏览放弃、自定义）
   • B) 营销活动 — 一次性／定时群发、A/B 测试、智能发送时间
   • C) 细分 — 基于实时行为的细分、预测属性、自定义属性
   • D) 预测分析 — 预测 CLV、下次下单日期、流失风险、消费层级
   • E) 多渠道 — 电子邮件、SMS/MMS、WhatsApp、RCS、移动推送通知
   • F) 表单 — 弹出式、飞出式、嵌入式、多步骤表单，用于扩展列表
   • G) 评论 — 收集产品评论、AI 驱动的回复、展示小组件
   • H) Klaviyo Data Platform（KDP）— 统一档案、集成、事件处理
   • I) 高级 KDP — 反向 ETL、自定义对象、高级 Webhook、数据仓库同步
   • J) AI Agent — Marketing Agent（营销活动生成）、Customer Agent（支持自动化）
   • K) 目录／优惠券 — 产品目录同步、个性化推荐、到货提醒、优惠券代码
   • L) 报告 — 收入归因、营销活动／流程分析、基准、自定义仪表板
   • M) 模板 — 拖放式编辑器、动态区块、移动设备自适应设计
   • N) Customer Hub — 自助服务门户（订单跟踪、常见问题、支持）
   • O) API／集成 — REST API、Webhook、Shopify 集成、第三方连接器
   • P) 账户／账单 — 套餐、定价、基于档案的计费
   • Q) 其他 — 请描述具体情况

2. 您的角色是什么？

   • A) 电商运营人员／店主
   • B) 电子邮件／生命周期营销人员
   • C) 开发者／工程师
   • D) 代理机构／自由职业者
   • E) 增长／营销经理
   • F) 其他

3. 您想要实现什么目标？（请描述您的具体目标或问题）

如果用户的请求已提供大部分背景信息，请直接跳到相关步骤。 根据合理假设（并明确说明），先尽力给出答案，然后仅在末尾提出最关键的 1 至 2 个澄清问题——不要在收集完整背景信息后才作答。

注意：如果用户需要专门技能，请简要说明原因，并引导他们使用相应技能。

第 2 步 — 转介或直接作答

如果请求适用于某项专门技能，请转介：

• 通用电子邮件营销策略／最佳实践 -> /sales-email-marketing
• 跨平台电子邮件送达率（非 Klaviyo 专属）-> /sales-deliverability
• 电子邮件打开／点击跟踪策略 -> /sales-email-tracking
• 通过中间件将 Klaviyo 连接到其他工具 -> /sales-integration
• 结账优化（购物车／结账用户体验）-> /sales-checkout
• Customer.io 专属问题 -> /sales-customerio
• Mailchimp 专属问题 -> /sales-mailchimp

否则，请根据下方参考资料中的平台知识直接作答。

第 3 步 — Klaviyo 平台参考资料

请阅读 references/platform-guide.md，了解详细的模块文档、定价、集成和数据模型。

您不再需要平台指南中的详细信息——请专注于用户的具体情况。

第 4 步 — 提供可执行的指导

根据用户的具体问题：

1. 构建弃购流程：

   1. 前往 Flows > Create Flow > 选择“Abandoned Cart”模板（或从头开始）
   2. 设置触发条件：“Checkout Started”事件（从 Shopify/BigCommerce 同步）或“Added to Cart”事件
   3. 添加时间延迟——第一封邮件通常延迟 1-4 小时（延迟较短可以挽回更多购物车，但可能会打扰仍在购物的客户）
   4. 添加条件分支：检查自流程触发以来是否发生过“Placed Order”事件——如果发生过，则跳过（他们已经完成转化）
   5. 添加第一封邮件步骤——使用事件的 item 属性，通过动态产品区块展示被放弃的商品
   6. 如果提供折扣，则插入唯一优惠券代码（Coupons > 生成唯一代码以防止分享）
   7. 添加第二个时间延迟（24h），然后发送第二封邮件，采用更强的紧迫感或折扣激励
   8. 可选：在第二封邮件后，为已同意接收 SMS 的订阅者添加 SMS 步骤——对于时效性较强的挽回活动，SMS 的打开率更高
   9. 监控流程分析数据：查看每个步骤的转化率、归因收入和退订率

2. 使用预测属性设置实时细分：

   1. 前往 Lists & Segments > Create Segment
   2. 使用细分构建器添加条件——将行为条件（过去 90 天内下过订单）与预测属性（预测 CLV 较高，流失风险为中或高）结合
   3. 使用 AND/OR 逻辑定义目标受众——例如，“Placed Order 至少 2 次 AND Predicted CLV 为 High AND Churn Risk 为 Medium”
   4. 预览细分，确认其中包含预期的用户档案
   5. 细分会实时更新——当用户档案符合或不再符合条件时，会自动加入或退出细分
   6. 将细分用作营销活动受众、流程触发条件或流程内的条件分支

3. 配置 Shopify-Klaviyo 集成：

   1. 在 Klaviyo 中，前往 Integrations > Add Integration > Shopify
   2. 输入 Shopify 商店 URL 并授权连接
   3. Klaviyo 会同步：客户（作为用户档案）、订单（作为“Placed Order”事件）、产品（作为目录商品）、购物车（作为“Added to Cart”/“Checkout Started”事件）
   4. 启用站内跟踪：将 Klaviyo 的 JavaScript 代码片段添加到 Shopify 主题中，以跟踪浏览行为（“Viewed Product”、“Active on Site”）
   5. 验证数据是否正常传输：在 Klaviyo 中查看 Metrics，确认是否显示 Shopify 事件
   6. 设置利用 Shopify 数据的核心流程：弃购（Checkout Started 触发）、购后（Placed Order 触发）、浏览放弃（Viewed Product 触发）、到货通知（目录同步）
   7. 如果在流程中使用唯一优惠券代码，请启用 Shopify 优惠券同步

4. 设置 SMS 与电子邮件并用：

   1. 确保使用 Email + SMS 套餐（每月 $35 起）
   2. 完成 SMS 合规设置：为品牌注册 10DLC（美国），设置免费电话号码或短代码号码，并配置免打扰时段
   3. 创建 SMS 同意收集方式：在注册表单中添加 SMS 选择加入步骤（多步骤表单效果最佳——先收集电子邮件地址，再征求 SMS 接收同意）
   4. 构建跨渠道流程：在现有流程中，于电子邮件步骤后添加 SMS 步骤——例如，如果 24h 后仍未打开邮件，则发送 SMS
   5. 尊重渠道偏好：发送 SMS 步骤前，使用条件分支检查是否已同意接收 SMS
   6. 监控 SMS 专属指标：送达率、点击率、退订率、每条 SMS 带来的收入

5. 使用 Klaviyo API 同步自定义数据：

   1. 在 Klaviyo 中生成私有 API 密钥：Account > Settings > API Keys > Create Private API Key
   2. 设置合适的权限范围——仅授予集成所需的权限（读取/写入档案、写入事件等）
   3. 所有请求均使用 JSON:API 格式——将数据封装在 {"data": {"type": "...", "attributes": {...}}} 结构中
   4. 创建或更新档案：POST /api/profiles/——Klaviyo 会按电子邮件地址或电话号码匹配；若档案已存在则更新，不存在则创建
   5. 跟踪事件：POST /api/events/——传入指标名称、档案标识符、属性和时间戳
   6. 处理速率限制：收到 HTTP 429 响应时实施指数退避
   7. 列表端点使用基于游标的分页：按照响应中的 links.next URL 继续请求

注意事项

根据调研整理的尽力而为版本——请复核，尤其是涉及计划限制功能和集成注意事项的内容，这些可能已经过时。

1. 基于档案数量的计费会统计所有活跃档案（2025 年 2 月变更），而不仅仅是你发送过邮件的档案。 即使你从不向导入的大型名单发送邮件，这些档案仍会计入档案上限和计费级别。请定期清理你不打算联系的档案，可将其设为禁止联系或删除。与之前只统计已发送邮件的档案的模式相比，这是一次重大变化。
2. Advanced KDP（自定义对象、反向 ETL、高级 Webhook）仅适用于企业定价——不要以为标准计划也能使用。 自定义对象、数据仓库同步、数据转换和系统级 Webhook 等功能需要 Advanced KDP 级别，且采用企业定制定价。标准 Email 和 Email + SMS 计划不包含这些功能。
3. 流程 Webhook 与系统 Webhook 并不相同——流程 Webhook 作为流程操作步骤触发，系统 Webhook（Advanced KDP）则会在任何事件发生时触发。 大多数帐户只能使用流程 Webhook（流程步骤中的 POST 操作）。系统 Webhook 可在电子邮件事件（event:klaviyo.opened_email、event:klaviyo.clicked_email、event:klaviyo.bounced_email）、评价事件和同意事件发生时触发，并使用 HMAC-SHA256 签名（签名位于 Klaviyo-Signature 标头中，而不是 Klaviyo-Webhook-Signature；每个帐户最多 10 个 Webhook，密钥长度至少为 16 个字符）。这是 Advanced KDP 功能。规划集成时不要混淆两者。
4. SMS 需要单独完成合规设置（美国的 TCPA/10DLC、运营商注册）——不要以为只要订阅 Email + SMS 计划就能立即使用 SMS。 发送 SMS 前，必须注册品牌、验证电话号码、配置静默时段，并遵守运营商要求。根据运营商审批进度，此注册过程可能需要数天到数周。
5. 预测分析需要足够的数据（通常需要 500 多笔订单和 180 多天的历史数据）——新商店不会立即显示预测结果。 预测 CLV、流失风险、下次订单日期和性别预测等功能，需要有足够的历史订单数据，Klaviyo 的模型才能生成结果。如果你刚开设商店或最近才迁移到 Klaviyo，需要等待积累足够的数据。

• 持续改进：如果发现此处未涵盖的内容，请将其连同今天的日期追加到 references/learnings.md。

第 5 步 — 相关技能

• /sales-email-marketing — 跨工具的许可式电子邮件营销策略
• /sales-deliverability — 跨平台电子邮件送达能力（SPF/DKIM/DMARC、预热、收件箱投递）
• /sales-email-tracking — 电子邮件互动跟踪策略
• /sales-integration — 将 Klaviyo 连接到 CRM、数据仓库或其他工具
• /sales-checkout — 结账优化（Klaviyo 可与电商结账流程集成）
• /sales-customerio — Customer.io 平台帮助（Klaviyo 在行为驱动自动化领域的主要竞争对手）
• /sales-mailchimp — Mailchimp 平台帮助（Klaviyo 在电子邮件营销领域的主要竞争对手）
• /sales-do — 不确定该使用哪项技能？路由器会将任何销售目标匹配到合适的技能。安装：npx skills add sales-skills/sales --skill sales-do

示例

示例 1：构建带短信备用方案的弃购流程

用户说：“我想为 Shopify 商店在 Klaviyo 中设置弃购挽回流程。应该加入短信吗？” 技能执行：确认 Shopify 正在同步“Checkout Started”事件，然后基于该触发器构建流程，并立即设置条件分支，跳过已转化的用户（“Placed Order”）：等待 2 小时 → 发送包含动态产品区块和 CTA 的电子邮件 1；等待 24 小时 → 发送文案营造紧迫感、并附带专属 10% 折扣券的电子邮件 2；然后按短信许可状态分流 → 12 小时后向已同意接收短信的用户发送短信提醒。建议监控每个步骤的转化情况，并根据 AOV 调整等待时间。 结果：多触点、跨渠道的弃购流程，先通过电子邮件挽回收入，再向未打开邮件的用户发送短信，并使用专属优惠券代码防止滥用

示例 2：收集短信许可的欢迎系列

用户说：“我需要一个欢迎流程，先收集电子邮件地址，再征求短信订阅许可，并发送一系列引导邮件。” 技能执行：设计两步式注册表单（第一步收集电子邮件并提供奖励，第二步收集电话号码和短信许可，并明确说明订阅价值），在“Subscribed to List”事件触发时启动欢迎流程：电子邮件 1（立即发送）提供折扣并说明发送频率；24 小时后按短信许可状态分流，向选择订阅的用户发送欢迎短信；继续发送电子邮件系列（第 3 天推荐畅销商品，第 5 天提供社交证明，第 7 天发送个性化推荐）；第 14 天按购买情况分流，若用户尚未购买则发送最后机会提醒。 结果：同时拓展电子邮件和短信列表，提供连贯的入门体验，并推动首次购买转化的欢迎系列

示例 3：用于预防客户流失的预测细分

用户说：“我们的许多回头客正在流失。Klaviyo 能否帮助我们在他们流失前识别并重新吸引他们？” 技能执行：确认预测分析所需的数据是否充足（500+ 笔订单，180+ 天；否则建议使用基于行为的近似方案），创建细分群组（“Predicted CLV High AND Churn Risk Medium/High”），并在用户加入该细分群组时触发挽回流程：电子邮件 1（第 0 天）发送个性化问候并推荐过往购买相关商品；电子邮件 2（第 4 天）介绍新品和补货商品；电子邮件 3（第 8 天）提供专属奖励；随后按短信许可状态分流，发送限时优惠。建议关注细分群组规模以查找根本原因，而非单靠自动化。 结果：主动预防客户流失的系统，可自动识别有流失风险的高价值客户，并在他们停止购买前通过个性化多触点序列重新吸引他们

故障排除

个人资料中未显示预测分析

症状：预测属性（CLV、流失风险、下次下单日期）在个人资料视图中显示为空白或不可用，且无法用于细分 原因：Klaviyo 的预测模型需要达到最低历史数据量，通常为 500+ 笔订单和 180+ 天的订单历史。新开店铺、最近迁移的账户或订单量较低的店铺没有足够的数据来生成预测。 解决方案：在 Metrics > Placed Order 中核实订单量——检查订单总数和日期范围。如果低于门槛，请继续收集数据；达到最低要求后，系统会自动显示预测结果。在此期间，可创建基于行为的细分作为近似方案：“Placed Order 至少 2 次 AND 过去 90 天内没有 Placed Order”可近似表示流失风险。如果数据充足但仍未显示预测结果，请联系 Klaviyo 支持——某些账户配置或数据质量问题可能会延迟预测生成。

Flow 邮件发送给已完成转化的客户

症状：客户已经完成购买，却仍收到弃购或浏览放弃邮件 原因：Flow 缺少条件拆分或 Flow 筛选条件，无法检查客户是否在触发事件后完成了预期操作（例如“Placed Order”）。如果没有此项检查，即使客户在触发事件与计划发送邮件之间已完成转化，Flow 仍会继续发送。 解决方案：在 Flow 中每个邮件步骤之前立即添加条件拆分：“自启动此 Flow 以来，Has Placed Order 至少 1 次。”如果条件为真，则将客户导向退出路径（或感谢路径）。此外，在触发器级别设置 Flow 筛选条件：“自启动此 Flow 以来，Has not Placed Order”——此筛选条件会在每个步骤之前重新评估。结合使用触发器级别的 Flow 筛选条件和每个步骤的条件拆分，以获得最高准确性。

SMS 消息发送失败或卡在队列中

症状：在 Flow／Campaign 分析中，SMS 消息显示为“queued”或“failed”，收件人没有收到短信 原因：最常见的情况是 SMS 合规设置未完成——品牌尚未完成 10DLC 注册（美国）、电话号码未经验证、静默时段阻止发送，或收件人的电话号码无效／为固定电话。运营商过滤也可能会拦截看起来像促销内容但未经正确注册的消息。 解决方案：在 Klaviyo Settings > SMS 中检查 SMS 设置状态：确认 10DLC 注册已获批准（美国）、发送号码处于启用状态，且静默时段配置正确。对于单条发送失败的消息，请检查个人资料中的电话号码格式（必须包含国家／地区代码，例如美国为 +1）。查看 Campaign／Flow 分析中的 SMS 错误代码，了解具体失败原因。如果消息被运营商过滤，请确保 10DLC 注册已完成，且消息内容符合运营商指南（不要使用全大写文字或误导性内容，并加入退订说明）。

Klaviyo 弹窗/表单在 Chrome 中无法触发，但在 Safari 中正常

症状：Klaviyo 注册弹窗或飞出式弹窗在 Chrome 中停止触发（尤其是在无痕模式下），但在 Safari 中仍能正常工作。提交率突然下降，通常是在 BFCM 等流量高峰期后发现。表单配置正确，并且在 Klaviyo 中显示为“Live”。 原因：页面上重复加载了 klaviyo.js 脚本。这种情况通常是因为多个 Shopify 应用或主题代码片段各自注入了 Klaviyo 集成脚本（在浏览器的 Network 标签页中查找多个 klaviyo.js?company_id= 请求）。重复脚本会造成竞争条件，使表单 SDK 初始化两次——Chrome 对脚本执行顺序的要求更严格，因此比对重复脚本处理更宽容的 Safari 更容易暴露这个问题。 解决方案：在 Chrome 中打开你的网站，进入开发者工具 > Network 标签页，按“klaviyo”筛选，并检查 klaviyo.js 是否加载了多次。如果是：（1）搜索 Shopify 主题代码（Layout 和 Snippets 文件）中所有对 klaviyo.js 或你的 company_id 的引用——删除重复的代码片段，只保留 Klaviyo 官方集成添加的那一个。（2）检查已安装的 Shopify 应用——某些电子邮件/营销应用会独立于 Klaviyo 的原生集成注入自己的 Klaviyo 脚本。逐个停用可疑应用并进行测试。（3）删除重复项后，清除网站缓存（以及任何 CDN/边缘缓存），并在无痕窗口中确认只触发了一个 klaviyo.js 请求。如果没有发现重复项，请检查 Console 标签页中是否有 JavaScript 错误阻止 Klaviyo 表单 SDK 初始化——主题 JavaScript 冲突或内容安全策略标头也可能导致弹窗无法在 Chrome 中正常渲染。

Shopify 集成显示“Action Required”，且重新连接失败

症状：Klaviyo 的 Shopify 集成显示“Action Required”。点击该集成后，它显示为“Enabled”，但提示横幅仍然存在。从 Shopify 移除并重新安装 Klaviyo 应用，或在 Klaviyo 中停用并重新启用该集成，都无法解决问题。尝试重新连接时，商店可能会显示“Sorry this store is currently not available”。 原因：Klaviyo 与 Shopify 之间的 OAuth 握手已损坏。这通常发生在 Shopify 账单中断（付款失败、试用期到期、套餐变更）、Shopify 商店被冻结或 Shopify 管理权限发生变更之后。现有 OAuth 令牌已失效，但 Klaviyo 的集成页面仍显示“Enabled”，因为配置记录仍然存在，即使令牌已经失效。 解决方案：（1）首先确认你的 Shopify 商店处于启用状态——登录 Shopify 管理后台，确认没有账单冻结、商店冻结通知或已到期的试用期。先解决 Shopify 端的问题。（2）在 Klaviyo 中，前往 Integrations > Shopify，彻底移除该集成（不是仅停用，而是删除）。（3）退出 Klaviyo 和 Shopify，清除 Cookie，或使用无痕浏览器。（4）从 Klaviyo 的 Integrations 标签页发起重新连接（Integrations > Add Integration > Shopify）——不要从 Shopify App Store 开始，因为由 Klaviyo 发起的流程能正确处理 OAuth 授权。（5）当 Shopify 提示授予权限时，完成完整的 OAuth 授权流程。（6）重新连接后，检查近期 Shopify 事件（Placed Order、Checkout Started）的指标，并确认个人资料数量正在更新，以验证数据是否正在同步。