shopify-admin-customer-cohort-analysis

用途

该技能按客户首次购买所在月份将其分组（即群组/cohort），并追踪每个群组随时间推移的表现：有多少客户复购、下了多少订单、以及每个群组在后续月份产生了多少收入。群组分析是衡量留存率以及订阅或忠诚度计划健康度的常用方法。该技能为只读操作，不执行任何数据变更。

主要能力

• 按首次购买月份对客户进行群组划分。
• 计算每个群组的复购率（repeat purchase rate）与总收入。
• 追踪群组在获取后第 1、2、3 个月（可配置）的复购情况。
• 输出 CSV 文件，包含 cohort_month、customers_acquired、repeat_purchasers、repeat_rate_pct、total_revenue、revenue_per_customer、month_offset 等列。
• 支持 human 与 json 两种输出格式。

前置条件

• 已认证的 Shopify CLI 会话：shopify store auth --store <domain> --scopes read_customers,read_orders
• API 权限范围：read_customers、read_orders

参数

• store（string，必填）：店铺域名，例如 mystore.myshopify.com。
• cohort_months（integer，可选，默认 6）：要分析的群组月份数。
• follow_months（integer，可选，默认 3）：每个群组在获取后需要追踪的月份数。
• format（string，可选，默认 human）：输出格式，human 或 json。

使用方式

该技能通过 Shopify Admin GraphQL API（api_version 2025-01）执行两类查询：

1. customers 查询：按 created_at:>='<NOW - cohort_months months>' 筛选群组窗口内获取的客户，读取 id、createdAt、numberOfOrders、amountSpent、defaultEmailAddress 等字段，每页 250 条并使用游标分页。
2. orders 查询：按 created_at:>='<NOW - cohort_months + follow_months months>' 筛选订单，读取 customer { id }、createdAt、totalPriceSet 等字段，用于构建每个客户的购买时间线。

随后按首次订单月份将客户归入群组，并为每个群组计算第 1、2、3+ 个月的复购率和总收入。

运行过程中会输出会话跟踪信息：开始时输出技能名称、店铺域名和启动时间；每步之后输出步骤编号、操作类型、操作名称、参数摘要和结果；完成时输出群组分析表格（human 格式）或 JSON（json 格式），并生成 CSV 文件 cohort_analysis_<date>.csv。

适用场景

• 衡量客户留存与复购表现。
• 评估订阅或忠诚度计划的健康度。
• 对比不同获取月份群组的表现趋势。
• 为高复购群组客户识别升级到 Gold/Platinum 层级的候选（可搭配 customer-spend-tier-tagger）。

限制与错误处理

• 只读技能，不执行任何变更，可随时安全运行。
• THROTTLED：API 速率超限时，等待 2 秒并最多重试 3 次。
• Insufficient history：店铺历史短于群组窗口时，仅分析可用月份。
• Guest checkout orders：无客户记录的访客结账订单会被排除在群组追踪之外。

最佳实践

• 健康的电商业务通常在 90 天内约有 20–40% 的首月客户会复购，可作为基准参考。
• 近期群组复购率下降可能意味着产品质量问题、客户体验摩擦或竞争加剧。
• 对于复购窗口较长的订阅型业务，可使用 follow_months: 6。

暂未提供

关于该技能的收费、价格、平台支持范围、具体效果数据等信息，资料中暂未提供。