用途:为 Web 应用(尤其 Next.js/React)提供 PostHog 分析的生产级架构参考,规范事件与功能开关组织方式,并规划数据管道集成。
主要能力:给出 src/analytics 目录结构示例,包含 posthog.ts(浏览器 SDK 单例)、posthog-server.ts(服务端 SDK 单例)、events.ts(类型化事件常量)、flags.ts(功能开关常量)、hooks(useFeatureFlag 与 useExperiment)等文件;提出 object_action(名词_动词)事件命名约定,覆盖用户生命周期、核心产品、收入与参与度事件;提供功能开关默认值映射以应对加载失败;支持 B2B 组分分析(posthog.group);通过 CDP 目标(Webhook、Slack、S3 等)与外部系统集成,并给出接收 CDP Webhook 的服务端路由示例。
使用方式:前置条件为 PostHog Cloud 或自托管实例、posthog-js 与 posthog-node SDK,以及 Next.js 或 React 应用(模式可适配其他框架)。按步骤建立文件结构、定义事件分类、配置开关常量、编写高层分析模块(封装 track/identify/服务端 capture),再接入数据管道。错误排查表提示:事件未出现需确认 posthog.init() 先于 capture 执行;开关总返回默认值应使用 posthog.onFeatureFlags() 回调;身份碎片化需统一 distinct_id;组分分析为空需先调用 posthog.group();无服务器环境服务端事件丢失应 await posthog.shutdown()。
限制:资料未提供具体安装命令、版本号、收费与价格信息;示例代码针对 React/Next.js,其他框架需自行适配。