技能介绍

要解决的问题

转化漏斗分析最常见的做法是手动拼报表：从 AA 里逐个找出每个步骤的页面或事件，分别建 segment，导出数字再对齐到同一根基准线上。步骤超过五个之后，Excel 里的公式很容易对不上——哪个 step 少了访客、流失率是按哪一步算的，往往要反复核对。

这个技能把这件事自动化：只要给出一个漏斗（例如商品页浏览 → 加购 → 发起结账 → 填写支付信息 → 下单成功），它会帮你完成 segment 的发现或创建、逐个 step 的 visits 计数、流失率计算，最终生成一份可直接打开的 HTML 报告。

核心思路

AA 没有原生的 sequential fallout API 能通过 MCP 调用，所以技能用 visit-level segment 近似模拟漏斗：每个 step 定义为一个访问级 segment，对该 segment 运行 runReport 得到 step visits，再和无 segment 的总 visits 基准对比。

Step 转化率 = Step visits / Total visits × 100
Step-to-step 转化率 = Step N visits / Step N-1 visits × 100

工作流程大致如下：

Phase 0–2｜准备与定义：确认 report suite，向用户确认漏斗是 visit-level（单次访问内完成，适合结账漏斗）还是 visitor-level（跨多次访问，适合生命周期漏斗）；让用户用自然语言描述每个 step，并逐个确认用页面（variables/page）、自定义事件还是两者组合来定义。
Phase 3｜发现或创建 segment：先 findSegments 找已有的 step segment，找不到再用 upsertSegment 创建新的 visit-level segment。
Phase 4｜逐 step 跑数：每个 step 一次 runReport，外加一次无 segment 的 total visits 作为 100% 基准。
Phase 5–6｜计算与下钻：算出每个 step 的绝对流失人数和流失率，找出最大流失 step，再针对该 step 跑维度拆分（如设备类型、流量来源、新老访客），对比继续转化与中途流失的访客构成差异。
Phase 7｜生成报告：输出到 /tmp/aa_funnel_analysis_report_.html 并直接打开。

关键注意点

近似而非严格 fallout：因为基于 visit segment，统计的是“该次访问内出现过此 step”的访问数，而不是严格的顺序漏损（上一步完成且下一步未完成）。结果只能作为流失趋势的近似参考。
创建 segment 前必须确认：技能在调用 upsertSegment 前会列出待创建的 segment 清单，等用户明确同意后才执行。
步骤数上限 8 个：每多一个 step 就多一次 runReport 调用，考虑到 API 预算，超过 8 步的漏斗建议拆分。
字段命名与取值：runReport 使用 metricIds / segmentIds（复数形式），日期用 startDate / endDate 的 ISO 8601 格式，总数要从 summaryData.totals[0] 读取，而不是从 rows 里找。
历史数据限制：searchDimensionItems 找不到数据时，先放宽日期范围，部分 report suite 只保留有限的历史数据。