你要回答的问题
开发者会问的
在装任何东西之前。
怎么做到
为集成而设计
装一次，按需扩展。
01
保持整洁的埋点
基础交互交给全埋点，业务数据用自定义事件，埋点方案检查进来的数据。
- 全埋点与 AI 命名事件
- 埋点方案与质量检查
- 虚拟事件与维度表
埋点方案12 个事件
| 事件 | 状态 | 近 7 天 |
|---|---|---|
| signup_completed | 方案内 | 2,140 |
| purchase | 方案内 | 512 |
| add_to_cart | 方案内 | 1,248 |
| AddToCart | 方案外 | 37 |
数据质量
不在方案里的事件37
类型不对的属性4
缺少必填属性0
02
服务端与导入
从后端上报订单、订阅和抓取；导入 CSV 事件或 Nginx / Apache 日志。
- 事件 API 与 5 种服务端 SDK
- CSV 与访问日志导入
- 跨数据源同一用户 ID
- 有幂等键，重试也不会重复
线索接口超时重试了 17 次，靠幂等键一笔订单都没重复
A · signup_completedB · purchaseB / A按周
signup_completedpurchase
| 拆分 | A | B | B / A |
|---|---|---|---|
| iOS | 1,240 | 312 | 25.2% |
| Android | 980 | 201 | 20.5% |
| Web | 1,610 | 288 | 17.9% |
03
给 AI 工具的 MCP
用只读 API Key 连接 MCP 服务，在编辑器里查询流量、漏斗和获客批次。
- 11 个只读工具
- Streamable HTTP
- 按 API Key 限定范围
线索在 AI 工具里问「ChatGPT 来的人落在哪些页」，几秒钟就从真实数据里给出答案
{
"mcpServers": {
"pathclue": {
"type": "http",
"url": "https://…/mcp",
"headers": {
"Authorization": "Bearer <API key>"
}
}
}
}使用只读权限的 API Key，AI 工具只能看到这个 Key 能读的项目。
工具6
list_sitessite_overviewrun_insightaskattribute_changedashboard_summary
Claude · Cursor · ChatGPT
“上周从 ChatGPT 来的访客，哪个落地页转化最好？”
工作流
四步接入
多数团队午饭前就能搞定。
- 1
创建项目
登记网站、App 或小程序，各自拿到一个站点标识。
- 2
加代码或 SDK
单页应用的路由切换会自动记录。
- 3
识别用户
登录后用你的用户 ID 调用 login()。
- 4
上报业务事件
订单和订阅从服务端上报。
FAQ
开发者常见问题
没找到答案？打开右下角的聊天直接问我们。
网站有 npm 包吗？
网站用 script 标签统计。App、小程序和服务端的 SDK 发布在 npm、pub.dev、PyPI、Maven Central、OHPM、SwiftPM、Packagist 和 Go modules。
单页应用怎么处理？
路由切换自动记为页面浏览。
能私有化部署吗？
能，企业版提供。