用途:在正式使用前验证 PostHog 新接入是否可用,通过一次受控事件、一个已识别测试用户和一个功能开关回退来确认三条核心链路(事件捕获、用户识别、功能开关评估)均正常。
主要能力:提供 posthog-node、posthog-js 与 Python SDK 的最小示例,并给出不依赖 SDK 的原始 HTTP API 调用方式(单事件端点与批量端点)。示例涵盖捕获自定义事件、identify 用户属性、getFeatureFlag/isFeatureEnabled 评估开关,以及 group 关联公司做分组分析。
使用方式:前置条件为已完成 posthog-install-auth 设置、配置好项目 API key(phc_...)、安装 posthog-js 和/或 posthog-node。Node 脚本中初始化 PostHog 后依次 capture、identify、getFeatureFlag,脚本或 serverless 环境必须调用 await posthog.shutdown() 或 flush()。浏览器端在应用启动时调用一次 posthog.init,再 capture、identify、isFeatureEnabled。Python 端设置 project_api_key 与 host 后调用 capture、identify、feature_enabled。原始 HTTP 可用 curl 向 https://us.i.posthog.com/i/v0/e/ 或 /batch/ 发送 JSON。
适用场景:新项目接入 PostHog 后的冒烟验证、在一次性测试环境中确认事件能到达 Activity 页、Persons 视图能看到带属性的用户、开关评估结果被记录。
限制与注意事项:API host 应使用 us.i.posthog.com 而非 app.posthog.com;功能开关需先在 PostHog 仪表盘创建,否则返回 undefined;前后端必须使用相同 distinct_id 才能正确关联;Python 退出前需 flush 或 shutdown,否则事件可能丢失。资料未提供收费、价格与平台支持等细节。