klaviyo-analyst

Klaviyo 营销分析师

从营销运营和分析师视角，为 Klaviyo 邮件和 SMS 营销提供专家级指导——审核、构建和优化流程、细分群体、营销活动和集成。

如需了解 API 集成、SDK 使用、事件跟踪实现、webhook 和开发者模式，请参阅 klaviyo-developer 技能。

安装

步骤 1 — 安装技能

git clone https://github.com/thatrebeccarae/claude-marketing.git && cp -r claude-marketing/skills/klaviyo-analyst ~/.claude/skills/

步骤 2 — 连接 Klaviyo MCP（推荐）

此技能围绕 Klaviyo 的官方 MCP 服务设计。通过 OAuth 将 Claude 连接到你的 Klaviyo 账户，无需本地 API 密钥，也无需安装 Python。设置方式取决于你使用的 Claude 产品。

对于 Claude Chat 或 Claude Cowork — 使用连接器目录

Klaviyo 已列入 Claude 的连接器目录（作为 2026-05-07 宣布的 Klaviyo + Anthropic 扩展集成的一部分）。设置约需两分钟：

1. 打开 Claude → 设置 → 连接器 → 浏览连接器
2. 搜索 Klaviyo
3. 点击连接并完成身份验证

套餐要求： Claude Pro、Max、Team 和 Enterprise 套餐均支持连接器。免费套餐用户需要使用 Claude Code 或下方的本地安装方式。

对于 Claude Code — 注册远程 MCP

claude mcp add klaviyo --transport http https://mcp.klaviyo.com/mcp

对于仅审核的会话，在末尾添加 ?read-only=true，即可在协议层禁用所有写入工具：

claude mcp add klaviyo --transport http "https://mcp.klaviyo.com/mcp?read-only=true"

对于本地安装（CI 容器、离线开发）

claude mcp add klaviyo -e PRIVATE_API_KEY=pk_... -e READ_ONLY=true -- uvx klaviyo-mcp-server@latest

Klaviyo 端的要求： 需要拥有者、管理员或经理角色，才能授权连接。

MCP 提供 40 多种工具，涵盖账户、营销活动、目录、事件、流程、群组、个人资料、报告、模板和翻译。完整工具清单请参阅 REFERENCE.md。

步骤 3 — 后备方案：本地 CLI 脚本（可选）

如果你需要通过脚本使用 CLI，以便在 CI、cron 或无头报告场景中使用，请安装 Python 依赖并提供 KLAVIYO_API_KEY。请参阅下方的脚本（后备方案）部分。

核心功能

流程审核与优化

• 根据最佳实践审核现有流程（欢迎系列、弃购、购后、唤回、浏览放弃、沉寂用户）
• 找出因流程缺失或表现不佳造成的收入流失
• 建议拆分测试、调整时间安排并改进条件逻辑
• 检查流程筛选条件和触发条件是否准确

细分策略

• 构建基于 RFM 的细分群体（最近一次消费时间、消费频率、消费金额）
• 设计互动层级：活跃（0–30 天）、温热（31–90 天）、有流失风险（91–180 天）、已流失（180 天以上）
• 使用 Klaviyo 的预测分析创建预测型细分群体（客户终身价值、流失风险、下次下单日期）
• 排除未互动的联系人，以保护送达率

营销活动策略

• 规划营销活动日历，平衡促销内容与价值内容
• 为主题行、发送时间和内容区块制定 A/B 测试框架
• 使用个人资料属性和目录数据进行动态内容个性化
• 确保 SMS 营销活动符合相关要求（TCPA、安静时段、选择加入要求）

送达率管理

• 监控并诊断送达率问题（退信率、垃圾邮件投诉、收件箱投递情况）
• 制定新发送域名/IP 的预热策略
• 配置身份验证：SPF、DKIM、DMARC
• 实施列表清理实践并设计沉寂用户流程

收入归因与报告

• 解读 Klaviyo 的归因模型（基于点击；默认窗口为邮件 5 天 / SMS 24 小时）
• 构建用于分析流程收入、营销活动 ROI 和列表增长的自定义仪表板
• 根据行业标准对 KPI 进行基准比较

事件架构审核

• 按来源盘点所有跟踪的指标（内置集成、自定义 API、Klaviyo 内部、表单）
• 找出重复或冗余事件、未使用事件以及缺失的标准事件
• 评估事件属性结构，确保可用于细分和个性化
• 诊断阻碍流程拆分和细分条件使用的嵌套对象限制

集成健康状况审查

• 审核活跃集成（电商、评论平台、忠诚度计划、广告）
• 识别过时或失效的集成以及孤立的事件来源
• 评估流程触发架构：直接指标触发（稳健）与通过 API 同步属性触发分群进入（脆弱）
• 评估商品目录同步状况：商品覆盖率、变体处理、数据新鲜度

个人资料数据利用分析

• 梳理个人资料属性：收集了哪些数据，以及哪些数据用于分群和个性化
• 识别过时的计算属性（仅设置一次，从不更新）
• 标记存在于事件中但未同步到个人资料的属性（限制分群）
• 针对嵌套数据的可访问性，提出属性扁平化策略

关键基准

指标	良好	优秀	警告
打开率（电子邮件）	20-25%	30%+	<15%
点击率（电子邮件）	2-3%	4%+	<1.5%
退订率	<0.3%	<0.1%	>0.5%
垃圾邮件投诉率	<0.05%	<0.02%	>0.1%
流程收入占总收入比例	30-40%	50%+	<20%
短信点击率	8-12%	15%+	<5%
列表增长率（每月）	3-5%	8%+	<1%

必备流程检查清单

1. 欢迎系列（3-5 封电子邮件 + 可选短信）——由订阅列表触发
2. 弃购挽回（2-3 封电子邮件 + 1 条短信）——由 Started Checkout 触发
3. 浏览未购买挽回（1-2 封电子邮件）——由 Viewed Product 触发，排除近期购买者
4. 购后流程（2-4 封电子邮件）——由 Placed Order 触发，按首次购买与重复购买进行分流
5. 唤回流程（2-3 封电子邮件）——根据距上次购买的时间触发（60-90 天）
6. 休眠/重新互动流程（2 封电子邮件）——面向 90-180 天未互动的用户，之后抑制发送
7. 评论请求——在配送后触发，并与评论平台集成
8. 补货提醒（如适用）——根据预期的复购周期触发
9. 生日/周年纪念——由日期属性触发
10. VIP/忠诚度——由进入高 CLV 分群触发

工作流：完整 Klaviyo 审计（4 阶段深度框架）

**适用于 Cowork：**这套 4 阶段审计专为无人值守执行而设计。在 Cowork 中启用 Klaviyo 连接器（只读模式）后，描述预期结果——“审计我的 Klaviyo 流程，并告诉我缺少什么，” “提取上周的营销活动和流程表现数据，并为我撰写一份周一摘要，” “标记所有打开率低于 20% 的流程，并撰写一份按优先级排序的修复清单”——然后就可以离开了。Cowork 会提取数据、运行分析、撰写文档，并将其保存到正确的文件夹，同时你可以参加其他会议。

收到审计 Klaviyo 账户的请求时，请遵循以下 4 阶段框架：

阶段 1：状态清查

1. 列表/分群/流程/营销活动清查——按状态（已上线、草稿、非活跃）统计并分类所有对象
2. 事件架构清查——提取所有指标，按来源分类（内置、自定义 API、Klaviyo 内部、表单），标记事件量为零的事件
3. 集成清查——列出所有活跃集成，识别过时的连接
4. 自定义个人资料属性清查——记录所有自定义属性及其类型和用途

阶段 2：配置审计

5. 逐个拆解流程配置——针对每个活跃流程：
   • 触发类型和条件
   • Smart Send 设置（开启/关闭及其影响）
   • 排除筛选条件（分群成员资格、事件条件）
   • 消息间隔时间（与基准进行比较）
   • 分支逻辑（条件分流、A/B 分流）
   • 流程持续时间（从第一条消息到最后一条消息）
6. 营销活动定向审计——分群互斥、发送频率限制、发送时间优化
7. A/B 测试方法审计——单变量与多变量、KPI 对齐、统计显著性实践
8. 送达能力配置——身份验证（SPF/DKIM/DMARC）、专用 IP、预热状态

Phase 3：数据结构审计

9. 事件架构健康度 — 检查重复事件、缺失的标准事件，以及阻碍细分的嵌套对象
10. 用户资料数据利用情况 — 对比已收集的数据与用于细分／个性化的数据
11. 商品目录同步健康度 — 商品数据源的新鲜度、覆盖范围、变体处理

Phase 4：战略建议

12. 三层建议 — 针对每项发现：
    • 发现：问题所在，以及审计数据提供的证据
    • 建议：应采取的措施（面向客户的通俗表述）
    • 实施规范：如何构建（内部工作说明书，包含触发条件、筛选条件、内容简报、时间安排、测试计划）
13. 顺序测试计划 — 采用统计显著性框架的单变量 A/B 测试
14. 量化投资回报率 — 预期提升百分比 × 当前营收基线
15. 实施路线图 — 划分阶段的时间表，并梳理依赖关系

行业专属基准

B2B／批发电商

指标	良好	优秀	警示	备注
打开率	25-35%	40%+	<20%	专业相关性更强，因此高于 DTC
点击率	3-5%	6%+	<2%	以商品为重点的 CTA 效果良好
CTOR	10-15%	18%+	<8%	关键诊断指标——内容相关性信号
自动化流程营收占比	25-35%	40%+	<15%	在 B2B 中，补货流程具有较高价值
平均订单金额	不定	—	—	按细分群体（行业、公司规模）跟踪
复购率	60-70%	80%+	<50%	对消耗品类别至关重要

DTC（直面消费者）

指标	良好	优秀	警示
打开率	20-25%	30%+	<15%
点击率	2-3%	4%+	<1.5%
自动化流程营收占比	30-40%	50%+	<20%
欢迎系列转化率	3-5%	8%+	<2%
购物车挽回率	5-10%	15%+	<3%

订阅／经常性收入

指标	良好	优秀	警示
流失率（月）	<5%	<3%	>8%
重新激活率	5-10%	15%+	<3%
补货流程转化率	8-12%	15%+	<5%
订阅升级率	3-5%	8%+	<1%

短信平台比较框架

评估 Klaviyo SMS 与 Attentive 时（审计中常见）：

功能	Klaviyo SMS	Attentive
邮件 + 短信统一管理	是（原生支持）	否（独立平台）
共享细分群体	是	需要同步
统一归因	是	报告分开
对话式短信	有限	强
注册组件	基础（弹窗、表单）	高级（两步点击、基于链接）
AI 功能	预测分析、智能发送时间	AI 工作流、智能发送
合规性	内置 TCPA、静默时段	内置 + 合规团队
成本	包含在 Klaviyo 套餐中（按短信计费）	独立平台费用 + 按短信计费
最适合	统一管理邮件和短信、追求简便	以短信为先的策略、短信量大

建议框架：当邮件是主要渠道、短信为辅助渠道时使用 Klaviyo SMS（适用于大多数 B2B 和中端市场 DTC）。当短信是主要营收渠道时（高频 DTC、移动优先品牌），可考虑 Attentive。

可重复的审计工作流（Klaviyo MCP 工具调用顺序）

通过官方 Klaviyo MCP 服务（https://mcp.klaviyo.com/mcp）审计账户时，请按以下顺序调用工具。下列所有工具均为只读工具，设置 ?read-only=true URL 参数后，可安全地用于生产环境。

步骤	MCP 工具	用途
1	get_account_details	账户配置、时区、集成
2	get_metrics	完整事件清单（所有指标名称和 ID）
3	get_metric（每项指标调用一次）	关键事件（Placed Order、Started Checkout、Viewed Product）的属性结构
4	get_flows	所有流程及其状态
5	get_flow（每个启用的流程调用一次）	触发器详情、操作、筛选条件
6	get_flow_report（每个流程调用一次）	每个流程的收入、转化、互动情况
7	get_campaigns	最近的营销活动及发送日期
8	get_campaign_report（每个营销活动调用一次）	打开、点击、退订和收入指标
9	get_segments + get_segment	分群清单和条件定义
10	get_lists + get_list	列表清单
11	get_catalog_items	目录同步健康检查
12	query_metric_aggregates	时间序列汇总（与应用内的 Metric Reporting 一致），用于分析送达能力和收入趋势
13	get_events（筛选后）	查看近期事件载荷样本，以检查属性结构和嵌套对象的用法

提取数据后，使用上文的四阶段深度框架进行分析。

关于写入工具的说明： MCP 还提供写入工具（create_campaign、create_profile、update_profile、create_email_template、subscribe_profile_to_marketing、assign_template_to_campaign_message、upload_image_from_file、upload_image_from_url、create_event，以及翻译工具）。对于纯审计工作，请通过使用 ?read-only=true 连接来禁用这些工具。只有在执行已确认的建议时才启用写入功能（例如，为你与用户共同创建的营销活动指定模板）。

集成背景

电商平台

• Shopify：原生集成，可自动同步订单、产品和客户。使用 Shopify 专属指标（Placed Order、Started Checkout、Viewed Product）。
• WooCommerce / BigCommerce / Magento：事件同步方式类似，可能需要配置插件。
• 自定义平台：使用 klaviyo-developer 技能与开发者协作，进行 API 事件跟踪和客户资料管理。

常见集成点

• 购买后评价流程所用的评价平台（Yotpo、Judge.me、Stamped）
• 基于积分进行分群的忠诚度计划（Smile.io、LoyaltyLion）
• 订阅生命周期流程所用的订阅平台（Recharge、Bold）
• 短信：使用内置的 Klaviyo 短信功能，或集成 Attentive / Postscript

如何使用此技能

你可以向我提出以下问题：

• “审计我的 Klaviyo 流程并找出缺漏”
• “为我的 DTC 品牌设计一系列欢迎邮件”
• “我的打开率下降了，帮我诊断送达能力问题”
• “制定 RFM 分群策略”
• “我应该对弃购流程进行哪些 A/B 测试？”
• “帮我设置一个沉睡用户流程来清理列表”
• “规划黑色星期五的邮件 / 短信营销活动日历”
• “审计我的事件架构——我们是否跟踪了所需的所有内容？”
• “为提升点击率提供三档建议”

分析示例

如需查看完整的分析模式、包含示例输出的演练示例和用例，请参阅 EXAMPLES.md。

脚本（备用方案：本地命令行）

**适用场景：**通过脚本访问命令行，以用于 CI / cron、无头报告任务，或无法连接 Klaviyo MCP 的环境（例如，使用 KLAVIYO_API_KEY 环境变量的自动化流水线）。在 Claude Code / Chat / Cowork 中进行交互式分析时，优先使用上文的 MCP 方式——它速度更快，通过 OAuth 进行身份验证，且可提供相同的数据。

此技能包含用于数据获取和分析的实用脚本：

获取 Klaviyo 数据

# List all flows
python scripts/klaviyo_client.py --resource flows

# List campaigns as table
python scripts/klaviyo_client.py --resource campaigns --format table

# Get flow performance report
python scripts/klaviyo_client.py --resource report --report-type flow --id FLOW_ID

# Export metrics to file
python scripts/klaviyo_client.py --resource metrics --output metrics.json

分析并生成报告

# Full account audit
python scripts/analyze.py --analysis-type full-audit

# Flow gap analysis
python scripts/analyze.py --analysis-type flow-audit

# Segment health check
python scripts/analyze.py --analysis-type segment-health

# Campaign performance comparison
python scripts/analyze.py --analysis-type campaign-comparison --days 30

# Deliverability diagnostic
python scripts/analyze.py --analysis-type deliverability

# Revenue attribution
python scripts/analyze.py --analysis-type revenue-attribution

这些脚本负责 API 身份验证、数据获取和分析。我会解读结果并提供可执行的建议。

故障排除

MCP 连接问题

Claude 中未显示 MCP： 确认已在客户端中配置 MCP 并完成身份验证。对于 Claude Code，请检查 ~/.claude.json 或项目级 MCP 配置。对于 Claude Chat，请检查“设置”→“连接器”。

OAuth 权限被拒绝： 你的 Klaviyo 用户角色必须是 Owner、Admin 或 Manager。权限较低的用户无法授权 MCP。

写入工具失败： 确认连接 URL 未设置 ?read-only=true。如果已设置，写入工具将按设计禁用；请改用读写 URL 来执行写入操作。

多账户混淆： MCP 支持多账户设置。如果 Claude 从错误的账户提取数据，请重新进行身份验证，或在 Klaviyo 界面中检查当前账户。

脚本（备用方案）错误

身份验证错误：请确认：

• 已将 KLAVIYO_API_KEY 设为环境变量或添加到 .env 文件中
• 密钥以 pk_ 开头（私有 API 密钥，而非公开密钥）
• 密钥具有读取权限范围：profiles:read、flows:read、campaigns:read、segments:read、lists:read、metrics:read

未返回数据：请检查：

• API 密钥关联的是正确的 Klaviyo 账户
• 账户中有可供分析的活跃流程、营销活动或细分群体
• 过滤条件格式正确（例如，equals(status,"live")）

速率限制错误：SDK 会自动重试（最多重试 3 次，最长延迟 60s）。如果仍然遇到限制：

• 减少并发请求
• 在连续调用之间增加延迟
• 检查 RateLimit-Remaining 标头

导入错误：安装所需的软件包：

pip install klaviyo-api python-dotenv pandas

安全说明

使用 Klaviyo MCP 时（推荐）

• MCP 使用 OAuth——无需提交、轮换或泄露 API 密钥
• 对于仅审计的工作，可在连接 URL 中添加 ?read-only=true，以禁用所有写入工具
• 授权范围取决于你的 Klaviyo 用户角色（Owner / Admin / Manager）——上游会强制执行最小权限原则
• 如果你的角色发生变化或 OAuth 令牌过期，则需要重新进行身份验证
• 多账户设置：在运行包含写入操作的工具之前，请确认当前账户

使用脚本备用方案时

• 切勿硬编码 API 密钥，或将其提交到版本控制系统
• 将密钥存储在环境变量或 .env 文件中
• 将 .env 添加到 .gitignore
• 分析任务使用只读权限范围——无需写入权限
• 定期在 Klaviyo 设置中轮换 API 密钥

数据隐私

此技能仅访问汇总后的营销数据。它不会：

• 访问超出电子邮件/资料汇总范围的个人身份信息（PII）
• 持久化存储 Klaviyo 数据
• 与外部服务共享数据
• 修改你的 Klaviyo 配置（只读操作）

所有数据都在本地处理，仅用于在对话期间生成建议。

有关 Klaviyo 数据模型、流程构建器参考、细分条件、送达能力和 SMS 参考的详细信息，请参阅 REFERENCE.md。

有关 API 集成、SDK 用法和开发者实践，请使用 klaviyo-developer 技能。