用途:该技能用于在 JavaScript Web(浏览器端)应用中集成 PostHog 分析,使用的 SDK 为 posthog-js。
主要能力与流程:按顺序执行集成步骤 basic-integration-1.0-begin.md(开始)、1.1-edit.md(编辑)、1.2-revise.md(修订)、1.3-conclude.md(收尾)。参考文件包括 references/js.md(JavaScript Web 文档)、references/posthog-js.md(SDK)、references/identify-users.md(用户识别)及对应各阶段参考。示例项目展示目标实现模式,API 细节需查文档。
使用方式要点:PostHog key 必须使用环境变量,禁止硬编码;在已有集成旁新增 PostHog 代码,不改动或重构现有代码;实现尽量贴合示例项目模式。posthog.init() 必须在任何其他 PostHog 方法(capture、identify 等)之前调用。posthog-js 仅适用于浏览器,不要在 Node.js 或服务端环境导入,应改用 posthog-node。用户识别:在登录和注册时调用 posthog.identify(userId, { email, name, role }),页面刷新且已登录时也要调用;登出时调用 posthog.reset()。PII(邮箱、姓名、角色)应放在 identify 的人员属性中,绝不放入 capture() 事件属性,禁止发送邮箱、全名、电话、地址、IP 或用户生成内容。无框架路由的 SPA 可用 posthog.capture('$pageview'),或在 init 中使用 capture_pageview 的 history_change 选项。前后端并存时,可用 X-POSTHOG-DISTINCT-ID 和 X-POSTHOG-SESSION-ID 头传递会话与 distinct ID。可在关键用户流程与 API 边界添加 PostHog 错误追踪。
框架指引:源码位于 node_modules;查看 package.json 的 type checking 或 build 脚本以校验改动。autocapture 默认开启(追踪点击、表单提交、页面浏览),除非用户明确要求否则不要关闭。
限制:本文档未提供具体代码示例、版本要求、收费或性能数据,暂未提供。