SuperAPI AI 工具集

posthog

数据与分析

查看项目

更新于 10-16 00:29

技能介绍

PostHog 是产品分析平台,具备自动捕获、功能开关、会话回放和 A/B 测试能力,开源且可自托管。

用途:为应用添加产品分析、实验与用户行为追踪。

安装:npm install posthog-js @posthog/react;服务端 npm install posthog-node。

前端接入:在入口调用 posthog.init(KEY, { api_host, defaults: '2025-11-30' }),并用 <PostHogProvider> 包裹应用。Next.js App Router 需在客户端 provider 中 init,并设 capture_pageview: 'history_change'。

事件追踪:组件内使用 usePostHog 钩子,调用 posthog.capture('event_name', { ...properties }),勿直接导入。

用户识别:登录后 posthog.identify(user.id, {...}),登出调用 posthog.reset();可用 people.set 与 people.set_once 更新属性。

功能开关与实验:使用 useFeatureFlagEnabled、useFeatureFlagVariantKey、useFeatureFlagPayload 或 <PostHogFeature>;服务端用 posthog-node 的 isFeatureEnabled/getFeatureFlag。

分组:posthog.group('company', id, {...}) 支持 B2B 分析。

会话回放:在控制台启用并配置 session_recording,如 maskAllInputs、maskTextSelector,可用 startSessionRecording/stopSessionRecording 手动控制。

服务端:posthog-node 可 capture 与 identify,无服务端环境下注意调用 await posthog.shutdown()。

配置与隐私:支持 autocapture、capture_pageleave、mask 系列选项,建议用 defaults: '2025-11-30',可考虑反向代理减少广告拦截影响。环境变量客户端用 VITE_/NEXT_PUBLIC_ 前缀,服务端用 POSTHOG_API_KEY。

限制:价格、套餐、平台支持范围等资料未提供;具体能力以官方为准。