funnel-tracking
"给产品做埋点和推广漏斗统计的完整打法:先定「要用数据做哪几个决定」,从访问到付费画出漏斗,一步一个事件,逐个事件过一遍留 / 删 / 加;身份分三级(单次打开的临时编号、同意后才有的访客编号、后端核对过的账号);数据进自己的后端,收集接口有白名单、限流、防伪造、防刷爆;报表按漏斗、来源、落地页、访客路线、产品使用、留存来看,并能一键导出给 AI 分析;要投广告时只把一两个真实结果回传给广告平台。当用户说 '埋点'、'打点'、'统计'、'漏斗'、'转化率'、'看用户从哪来 / 在哪流失'、'推广效果 / 渠道效果'、'UTM / 来源归因'、'GA / GTM / 不想用谷歌统计'、'广告转化回传'、'Cookie 同意框'、'给新项目也做埋点' 时使用;只加一两个事件的小改也要按第 1 节的事件表和第 3 节的白名单来做。"
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/weifashi--funnel-tracking)HTML
<a href="/listings/weifashi--funnel-tracking"><img src="/api/listings/weifashi--funnel-tracking/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
git clone https://github.com/weifashi/funnel-tracking ~/.claude/skills/funnel-tracking
然后对 Claude 说「给 X 做埋点」「我想看用户从哪来、在哪流失」即可触发。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 89 lines
- ---
- name: funnel-tracking
- description: "给产品做埋点和推广漏斗统计的完整打法:先定「要用数据做哪几个决定」,从访问到付费画出漏斗,一步一个事件,逐个事件过一遍留 / 删 / 加;身份分三级(单次打开的临时编号、同意后才有的访客编号、后端核对过的账号);数据进自己的后端,收集接口有白名单、限流、防伪造、防刷爆;报表按漏斗、来源、落地页、访客路线、产品使用、留存来看,并能一键导出给 AI 分析;要投广告时只把一两个真实结果回传给广告平台。当用户说 '埋点'、'打点'、'统计'、'漏斗'、'转化率'、'看用户从哪来 / 在哪流失'、'推广效果 / 渠道效果'、'UTM / 来源归因'、'GA / GTM / 不想用谷歌统计'、'广告转化回传'、'Cookie 同意框'、'给新项目也做埋点' 时使用;只加一两个事件的小改也要按第 1 节的事件表和第 3 节的白名单来做。"
- ---
- # 埋点和漏斗统计:从设计到看数
- > 由一个多端产品(官网 + 商家后台 + 收银端)的自有统计沉淀出来:二十多个事件、十二步漏斗、一套运营报表。每条规则背后都是一次真实的返工。
- > 案例见 `references/case-study.md`。
- 核心只有一句话:**埋点是为了做决定。每个事件都要说得出「看到这个数会改什么」,说不出就不埋。**
- ## 0. 开工:先问清这几件事
- 清单和可以直接转发给 AI 的任务单见 `references/kickoff.md`。
- - 要用数据做哪几个决定(改哪一页、砍哪个渠道、修哪一步)
- - 用第三方统计还是自己存:默认建议**自己存**(数据在自己手里、没有第三方脚本、口径自己定),除非团队已经深度依赖某个平台
- - 目标国家和它的隐私法(决定同意框怎么做)
- - 产品有哪几端(官网、后台、App、给终端顾客用的页面)
- - 报表给谁看、在哪看
- - 以后投不投广告、投哪家
- ## 1. 设计:从漏斗倒推事件
- 做法和模板见 `references/events.md`。
- 1. **先画漏斗**:从「来到官网」到「付费」,中间每一步都是一个看得见的动作,10 步左右。产品里的「激活」要有明确定义(例如第一笔真实收款)。
- 2. **一步一个事件**,再补三类:页面类(打开、离开、滚到哪)、意向类(点了哪个按钮、展开了哪个问题)、健康类(用户看到的报错、脚本出错)。
- 3. **逐个事件过一遍**:留、改、删、加,每个都写「用来做什么决定」。重复的、只是好奇的删掉。
- 4. **事件字典进代码库**:事件名、哪一端发、带哪些字段、口径。之后加功能就在这里加一行。
- 事件带的字段要少而固定(枚举值、数字),不带自由文本、金额、姓名、搜索词、聊天原话。
- ## 2. 身份和同意:三级,各管各的
- 细则见 `references/privacy.md`。
- | 级别 | 是什么 | 要不要同意 | 能算出什么 |
- |---|---|---|---|
- | 单次打开编号 | 每次打开页面随机生成,只在内存里 | 不要(不写本机、不识别个人) | 每页被看几次、看到哪、点了什么 |
- | 访客编号 | 同意后才写进本机的随机编号 | 要 | 同一个人的几次访问、之后注册连成一条路线 |
- | 账号 / 店铺 | 后端从登录状态里核对出来的 | 按产品的隐私说明 | 注册后的使用、留存、付费 |
- - 同意框只有「拒绝 / 同意」两个一样大的按钮;没选之前不写任何非必要记录;浏览器的全局隐私控制当作拒绝。
- - 广告来源参数(utm 等)跟着站内链接一路带进产品,但**写进本机也要等同意**。
- - 明确不记:IP、浏览器型号、邮箱、地址栏参数、表单里的自由文本、金额。
- - 给终端顾客用的页面(例如扫码点餐)不统计:他们不是你的用户,是你客户的客人。
- ## 3. 收集接口:默认不信任任何请求
- 做法见 `references/intake.md`。统计接口是公开的,谁都能往里发:
- - **白名单**:每一端只收它该发的事件名;未知事件丢掉并计数,不报错。
- - **里程碑事件要验证身份**:注册成功、第一笔收款、升级付费这类事件,只有带着有效登录、并且是本人账号时才收。否则任何人都能把漏斗刷高。
- - **限流和限量**:每个来源每天的批数、条数、字节数有上限;全站每天也有上限。统计不能把业务数据库写满。
- - **去重**:每个事件带客户端生成的编号;里程碑事件每个账号只记一次。
- - **过滤**:机器人、自己人的设备、测试环境分开。
- - **保存期限**:定一个天数(例如 400 天),定时清理。
- - **永远不影响页面**:统计请求失败、接口没上线,页面照常工作。
- ## 4. 报表:每个页签对应一个决定
- 见 `references/reports.md`。
- | 页签 | 看什么 | 用来做什么决定 |
- |---|---|---|
- | 漏斗 | 每一步还剩多少人、停在哪一步的人最多 | 先修流失最大的一步 |
- | 按来源 | 各渠道、广告系列、落地页、合作伙伴的访问到付费;加上花费就是每个客户的成本 | 加预算还是停掉 |
- | 落地页 | 每页的打开、看到一半、点主按钮、停留、秒退;每一屏还剩多少人 | 改哪一页、哪一屏 |
- | 访客路线 | 单个访客或账号的完整时间线 | 看具体的人卡在哪 |
- | 产品使用和报错 | 各页面停留、用户看到的报错 | 修哪个功能 |
- | 留存 | 注册后第几天还在用 | 产品留不留得住人 |
- 再加两样:**一键导出给 AI 分析**(数据 + 每个数字的口径 + 分析要求)和**每周周报**。
- ## 5. 广告转化回传(要投广告时才做)
- 见 `references/ads.md`。三层分开:自己的统计什么都记;回传只送「真正有结果」的一两个事件;广告平台只拿这一两个信号去找相似的人。不要把十几个行为都设成转化。
- ## 6. 上线和验证
- 见 `references/release.md`。要点:建表要用户点头;前端先发是安全的,接口和建表要一起发;用带真实浏览器标识的请求验证入库;上线前自己人测试产生的脏数据要清理,清理前备份。
- ## 7. 汇报
- - 向用户讲埋点时用「谁从哪来、走到哪一步、在哪走掉」这样的话,不讲事件名。
- - 事件表里每一行都有「用来做什么决定」一列。
- - 明说哪些数现在还看不到(功能没接通、样本太少、没人同意所以连不成路线)。
README.md · README · 51 lines
- # funnel-tracking
- > 一个 [Claude Code Skill](https://docs.claude.com/en/docs/claude-code/skills):让 AI 给产品把埋点和推广漏斗统计从设计做到能看数。
- >
- > A Claude Code skill for first-party event tracking and funnel analytics: decisions first, one event per funnel step, three identity levels with consent, a hardened intake endpoint, reports that map to decisions, and minimal ad-conversion upload.
- 这份打法来自一个多端产品(官网 + 商家后台 + 收银端)的自有统计。每条规则都对应一次真实的返工:有的事件记了很久却说不出用途、一家店被记了 23 次「注册完成」、任何人都能伪造「已付费」、接口返回成功但库里一条都没有、导出给 AI 的数字整体错位……
- ## 它会怎么做
- 1. **开工表**:要用数据做哪些决定、存在哪、有哪几端、目标国家、投不投广告。
- 2. **事件设计**:从访问到付费画漏斗,一步一个事件;逐个事件过一遍留 / 删 / 加,每个都写「用来做什么决定」。
- 3. **身份和同意**:单次打开编号(不需同意)→ 访客编号(同意后)→ 账号(后端核对);明确不记什么。
- 4. **收集接口**:白名单、关键事件验证身份、限流限量、过滤机器人和自己人,永远不影响页面。
- 5. **报表**:漏斗、按来源(含花费)、落地页、访客路线、产品使用和报错、留存;一键导出给 AI 分析;每周周报。
- 6. **广告回传**(可选):三层分开,只回传一两个真实结果。
- 7. **上线和验证**:发布顺序、怎么确认入库、清理测试数据。
- ## 安装
- ```bash
- git clone https://github.com/weifashi/funnel-tracking ~/.claude/skills/funnel-tracking
- ```
- 然后对 Claude 说「给 X 做埋点」「我想看用户从哪来、在哪流失」即可触发。
- ## 不想装技能,只想转发一段话
- `references/kickoff.md` 里有一份可以直接转发给任何 AI 的任务单,填上项目信息就能用。
- ## 目录
- | 文件 | 内容 |
- |---|---|
- | `SKILL.md` | 主流程与规则 |
- | `references/kickoff.md` | 开工表、可转发的任务单 |
- | `references/events.md` | 漏斗怎么画、三类辅助事件、逐个过一遍的模板、事件字典 |
- | `references/privacy.md` | 三级身份、同意框、来源参数、不记什么、保存期限 |
- | `references/intake.md` | 收集接口的校验、身份验证、限流限量、过滤、兼容性 |
- | `references/reports.md` | 各报表页签、导出给 AI、周报、样本少时怎么说 |
- | `references/ads.md` | 广告转化回传的三层和六条规则 |
- | `references/release.md` | 上线顺序、验证清单、清理测试数据 |
- | `references/case-study.md` | 案例:弯路如何变成规则 |
- | `assets/schema.example.sql` | 事件表、访客与账号对应表、花费表 |
- | `assets/track.example.js` | 官网埋点脚本模板(无第三方脚本,带同意和来源处理) |
- 隐私相关的内容是工程上的默认做法,不是法律意见;目标国家的规定请单独确认。
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.