尧图网页设计 
AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本文聚焦 marketingskills 仓库中 PostHog 集成指南 的核心内容系统讲解这款开源产品分析工具如何通过 Capture API、Query API、Feature Flags API 与 JavaScript SDK为营销与增长团队尤其是 Claude Code 与 AI Agent 场景提供事件追踪、会话回放、特征标志与 A/B 测试能力。读完本文你将掌握 PostHog 的认证方式、七类常用 Agent 操作事件上报、批量上报、用户查询、HogQL 查询、特征标志、洞察与录制、JavaScript SDK 埋点模式并了解如何结合仓库中的 analytics、ab-testing、attribution 等技能在真实增长工程中落地 PostHog。一、PostHog 是什么开源产品分析全家桶PostHog 是一套开源的产品分析平台核心定位是Open-source product analytics with session replay and feature flags即同时具备传统产品分析事件追踪、会话回放观看真实用户操作录屏和特征标志灰度发布三大能力。与 GA4、Mixpanel 等同类工具相比PostHog 最大的差异化在于开源可自托管——你可以把它运行在自己的基础设施上从而满足隐私合规与数据主权要求。在 marketingskills 仓库的工具注册表中PostHog 被归类为Analytics产品分析类别与 GA4、Mixpanel、Amplitude、Segment、Adobe Analytics、Plausible 并列并在 Analytics 分类表中明确标注其定位为Open-source analytics, session replay。注册表给出的选型建议是Google 生态用户从 GA4 入手深度产品分析选 Mixpanel/Amplitude隐私优先站点选 Plausible而 PostHog 的核心适用场景则是开源要求、自托管需求与特征标志管理。能力矩阵一览原集成指南tools/integrations/posthog.md给出了完整的接入能力矩阵集成方式可用性说明API✓Capture API、Query API、Feature Flags APIMCP-暂不可用CLI✓posthogCLI用于本地开发SDK✓JavaScript、Python、Ruby、Go 等从这张表可以得到三个对 Agent 工程实践至关重要的结论无 MCP 服务器PostHog 目前不提供官方 MCPModel Context Protocol服务器因此 AI Agent 无法像 GA4、Stripe 那样通过 MCP 工具直接交互必须走 HTTP API 或 SDK 路径。这与 工具注册表 中MCP-Enabled Tools清单GA4、Stripe、Mailchimp 等相互印证——PostHog 不在其中。CLI 仅限本地开发posthogCLI 面向开发环境如本地自托管实例生产环境的数据读写主力是 REST API 与各语言 SDK。多语言 SDKJavaScript 之外还有 Python、Ruby、Go 等这意味着无论你的技术栈是前端站点、后端服务还是数据管道都能找到对应接入方式。二、认证机制两种 API Key 的正确用法PostHog 的认证是整个集成的基础原文档给出的要点可以归纳为三条规则认证类型API Key分为 Personal Key 与 Project Key 两类请求头Authorization: Bearer {api_key}——这是所有管理类 APIQuery、Persons、Insights、Session Recordings的标准认证方式数据上报Capture 与 Batch 端点不走 Bearer 头而是把Project API Key 直接放在请求体 payload 中两种 Key 的职责边界值得展开说明Key 类型用途传递方式Personal API Key管理类 API查询、用户、洞察、录制Authorization: Bearer {api_key}Project API Key事件上报Capture/Batch与客户端初始化请求体api_key字段 / SDK 初始化参数实战要点事件上报端点/capture/、/batch/、/decide/天然是公开设计——Project API Key 会出现在前端代码中这是产品分析工具的通用模式Mixpanel 同样用公开的 project token 做上报。而涉及读取数据的 Query API、Persons API 等则必须用带 Bearer 认证的服务端 Key严禁把 Personal Key 暴露在前端。仓库中 analytics 技能 的隐私与合规章节进一步强调了这种密钥分治的意义分析属性中不得包含 PII个人身份信息Key 的分级管理本身就是防止数据泄露的第一道防线。三、Agent 常用操作详解七类核心 API 调用原集成指南为 AI Agent 提供了七类开箱即用的 API 操作模板。以下逐一展开并补充参数说明与适用场景。3.1 上报单个事件Capture APIPOST https://app.posthog.com/capture/ { api_key: {project_api_key}, event: signup_completed, distinct_id: user_123, properties: { plan: pro, $current_url: https://example.com/signup } }参数解析api_keyProject API Key公开 Key必填event事件名。仓库 analytics 技能 强烈建议采用Object-Action对象-动作命名规范如signup_completed、button_clicked、form_submitted、checkout_payment_completed——全小写下划线具体到对象cta_hero_clicked优于button_clicked上下文放进 properties 而非事件名distinct_id用户唯一标识。匿名访客时为匿名 IDidentify()之后为邮箱/UUIDproperties事件属性$前缀为 PostHog 保留属性如$current_url、$browser、$os自定义属性直接使用业务字段名3.2 批量上报事件Batch APIPOST https://app.posthog.com/batch/ { api_key: {project_api_key}, batch: [ {event: pageview, distinct_id: user_1}, {event: signup, distinct_id: user_2} ] }batch字段接收事件数组一次请求可携带多条事件。批量上报有两个关键优势降低网络请求次数规避 Cloud 版 10,000 events/second 的瞬时峰值限制、服务端合并上报如 webhook 回调、离线补数场景。仓库 first-party-tracking 归因指南 中有一个非常典型的生产级用法——在第三方域名如 SavvyCal 预订工具的 webhook 中通过/batch/一次性完成身份合并$identify与转化事件上报const events []; if (anonId) { events.push({ event: $identify, distinct_id: userId, properties: { $anon_distinct_id: anonId, $set: { email: userId, name } }, }); } events.push({ event: discovery_call_booked, distinct_id: userId, properties: { booking_id, journey_linked: Boolean(anonId) }, }); await fetch(${POSTHOG_HOST}/batch/, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ api_key: POSTHOG_API_KEY, batch: events }), signal: AbortSignal.timeout(3000), });这段代码同时示范了三个 Agent 工程要点① 业务事件discovery_call_booked与系统事件$identify可以混在同一批次② webhook 中必须用AbortSignal.timeout限时并保证失败不影响主流程③ 用journey_linked属性记录归因链路是否打通便于事后监控覆盖率。3.3 按 distinct_id 查询用户Persons APIGET https://app.posthog.com/api/projects/{project_id}/persons/?distinct_iduser_123 Authorization: Bearer {api_key}注意此端点有两个路径参数差异{project_id}是 PostHog 项目的数字 ID可在项目设置中获取而认证使用 Bearer 头Personal Key。用途包括确认identify()是否生效、检查用户画像的$initial_*首触属性是否落地、排查匿名用户与已知用户是否成功合并。3.4 HogQL 查询事件Query APIPOST https://app.posthog.com/api/projects/{project_id}/query/ { query: { kind: HogQLQuery, query: SELECT event, count() FROM events WHERE timestamp now() - interval 7 day GROUP BY event ORDER BY count() DESC LIMIT 10 } }HogQL是 PostHog 基于 ClickHouse SQL 封装的查询语言是理解其SQL-like query language定位的关键。这个示例查询了近 7 天的事件频率 Top 10可用于快速审计埋点是否生效pageview、signup_completed是否都在上报发现未预期的高频事件排查重复埋点作为 Agent 自动化报告的数据源配合 analytics 技能 中的验证清单事件是否在正确触发点上报、属性值是否正确填充、是否存在重复事件HogQL 就是执行这些校验的底层查询工具。3.5 查询特征标志Feature Flags APIPOST https://app.posthog.com/decide?v3 { api_key: {project_api_key}, distinct_id: user_123 }/decide/端点是 SDK 内部获取特征标志决策的底层接口v3为当前 API 版本号。传distinct_id后返回该用户命中的所有特征标志及变量值。在 Agent 场景中可用它实现服务端灰度判断——例如决定向某批用户展示新定价页还是旧页面。特征标志是 PostHog 连接分析与实验的桥梁ab-testing 技能 明确把 PostHog 列为实验工具之一与 Optimizely、VWO 并列而 churn-prevention 技能 更进一步给出了具体实践用特征标志在服务端把用户切分到不同的取消流程再用漏斗分析追踪取消流程的每一步survey → offer → accept/decline → confirm从而用实验数据驱动流失挽留策略。3.6 获取洞察Insights APIGET https://app.posthog.com/api/projects/{project_id}/insights/ Authorization: Bearer {api_key}Insights 是 PostHog 中已保存的图表/看板趋势、漏斗、留存等。通过 API 拉取它们Agent 可以将现成的分析看板数据接入自动化报告流程而无需重新编写 HogQL 查询。3.7 获取会话录制Session Recordings APIGET https://app.posthog.com/api/projects/{project_id}/session_recordings/ Authorization: Bearer {api_key}会话录制是 PostHog 的差异化能力回放真实用户会话用于 UX 洞察。在营销场景中的典型用法包括观察用户在实际落地页上的滚动/点击行为、识别表单填写卡点、为 cro 转化率优化 提供定性证据。Agent 可通过该 API 拉取录制元数据清单与事件数据交叉分析。四、JavaScript SDK 埋点四步完成前端接入原文档给出了完整的前端 SDK 四步范式这是 Web 场景的标配接入路径// 1. Initialize初始化 posthog.init(PROJECT_API_KEY, { api_host: https://app.posthog.com }); // 2. Identify user识别用户 posthog.identify(user_123, { email: userexample.com, plan: pro }); // 3. Track event上报事件 posthog.capture(signup_completed, { method: email }); // 4. Check feature flag判断特征标志 if (posthog.isFeatureEnabled(new-pricing)) { // Show new pricing }对这四个调用的工程解读init传入 Project API Key 与api_host自托管实例需把api_host指向你自己的部署域名。仓库 first-party-tracking 归因指南 提醒SDK 加载前调用会被队列暂存stub 机制这也是为什么读取get_distinct_id()需要做加载完成判断。identify在知道用户是谁的时刻调用注册成功、表单提交、首次付费。仓库归因指南特别强调身份归一化——分析工具按精确字符串匹配身份Coreyx.com与coreyx.com会被拆成两个人因此上报前必须email.trim().toLowerCase()。配合person_profiles: identified_only配置identify()的这一刻才会创建用户画像并打上首触属性。capture与 Capture API 等价的前端封装。事件名遵循 analytics 技能 的 Object-Action 规范。isFeatureEnabled对应/decide/端点的 SDK 封装用于前端灰度判断。进阶匿名 ID 的安全读取在把匿名用户引导到第三方转化域名并回传归因的场景中详见 first-party-tracking 归因指南Agent 需要在前端安全读取当前匿名 ID。由于 SDK stub 在加载完成前get_distinct_id()返回undefined归因指南给出了一种先 SDK 后 Cookie 的回退读取实现并附带严格的匿名性守卫export function getPostHogDistinctId() { if (typeof window undefined) return null; try { if (window.posthog?.__loaded) { const id window.posthog.get_distinct_id(); if (id) return isAnonymousDistinctId(id) ? id : null; } } catch {} try { const prefix ph_${POSTHOG_API_KEY}_posthog; const cookie document.cookie.split(/;\s*/).find(c c.startsWith(prefix)); if (!cookie) return null; const parsed JSON.parse(decodeURIComponent(cookie.slice(prefix.length))); return typeof parsed.distinct_id string isAnonymousDistinctId(parsed.distinct_id) ? parsed.distinct_id : null; } catch { return null; } }其中匿名性守卫isAnonymousDistinctId的规则邮箱身份应用场景id.length 0 id.length 100 !id.includes()——即只允许透传看起来不像邮箱的匿名 ID一旦identify()之后当前distinct_id变成邮箱形状立即拒绝透传防止 PII 泄露与错误合并。归因指南给出的铁律是当身份不明确时什么都不发送——缺失的归因只是数据缺口错误的合并则是数据污染。五、关键能力全景与选型建议原文档将 PostHog 的六大核心能力总结如下Event tracking事件追踪产品分析的基础能力覆盖 Web 与移动端Session replay会话回放观看真实用户会话获取 UX 洞察Feature flags特征标志控制功能灰度发布与实验分流A/B testing内置实验开箱即用的 A/B 测试能力配合 ab-testing 技能 使用HogQLSQL 风格的查询语言底层基于 ClickHouseSelf-hostable可自托管可在自有基础设施上运行满足数据主权要求何时选择 PostHog原文档给出了五类明确的使用场景产品分析 隐私优先需要在分析能力与数据隐私之间取得平衡会话回放做 UX 洞察需要看真实用户操作而非仅看数字特征标志管理需要服务端灰度与功能开关能力自托管分析需求数据必须留在自己的基础设施内开源要求代码库与生态完全开源从仓库 工具注册表 的 Agent 选型建议看各分析工具的定位是互补的GA4 适合 Google 生态Mixpanel/Amplitude 适合深度产品分析Plausible 适合隐私极简场景而 PostHog 的独特价值在于开源 自托管 特征标志 会话回放的组合——这是其他商业 SaaS 分析工具难以同时提供的。在 analytics 技能 的工具集成表中PostHog 与 GA4、Mixpanel、Amplitude、Segment 并列展示Agent 应根据上述场景而非品牌偏好选择。六、速率限制Cloud 与自托管的差异原文档给出的速率限制信息非常明确Cloud云托管版10,000 events/second每秒 1 万事件Self-hosted自托管版无限制取决于你自己的基础设施容量对 Agent 工程的意义批量上报/batch/是规避 Cloud 瞬时峰值的最直接手段——把突发的事件流如 campaign 高峰、webhook 风暴聚合为批量请求比逐条上报更稳健。自托管场景下无限制仅指软件层面无硬性配额实际吞吐受 ClickHouse 集群性能约束扩容规划仍需按事件量设计。七、PostHog 在仓库增长工程中的完整落地路径PostHog 在 marketingskills 仓库中不是孤立文档而是贯穿多条技能链路的底层数据与实验基础设施。综合仓库源码可以梳理出四条典型的落地路径路径一营销分析analytics 技能在 analytics 技能 中PostHog 是五大推荐分析工具之一。Agent 可参照该技能的 Tracking Plan 框架Event Name | Category | Properties | Trigger | Notes表格与 事件库参考 设计埋点计划——例如营销站点事件cta_clicked、form_submitted、signup_completed、产品事件onboarding_step_completed、feature_used、purchase_completed、电商事件product_added_to_cart、checkout_started——再用本文第三节的 Capture/Batch API 落地到 PostHog。路径二实验驱动ab-testing 技能ab-testing 技能 将 PostHog 列为实验工具与 Optimizely、VWO 并列其假设框架Because [observation], we believe [change] will cause [outcome] for [audience]...配合 PostHog 的特征标志分流与漏斗分析构成完整的提出假设 → 分流实验 → 漏斗度量闭环。路径三自助归因attribution 技能first-party-tracking 归因指南 以PostHog SavvyCal 作为完整工作示例展示了如何用 PostHog 的identify()、$anon_distinct_id合并、/batch/上报、$initial_*首触属性把匿名浏览 → 第三方域名转化拼接成一条可归因的完整旅程。核心模式可以概括为拿到匿名 ID → 跨越域名边界携带它 → 在对岸合并身份 → 按首触渠道拆分转化。路径四流失挽留churn-prevention 技能churn-prevention 技能 给出了一个具体的工程配方用 PostHog 特征标志在服务端把用户分流到不同取消流程再用漏斗分析追踪取消流程每步转化survey → offer → accept/decline → confirm从而用实验数据优化挽留策略。八、验证与上线自检清单综合原文档 API 模板与仓库各技能的工程经验PostHog 集成上线前建议完成以下验证事件链路验证用 HogQL 查询SELECT event, count() ...确认各事件按预期频率上报且无重复/畸形事件身份合并验证用 Persons API?distinct_id...确认匿名浏览历史与已知用户画像成功合并$initial_utm_source首触属性已落地特征标志验证/decide/返回预期标志与变量值isFeatureEnabled在前端按分流生效批量上报验证向/batch/手动 POST 测试 payload返回{status:Ok}且用户画像正确合并参考归因指南的验证清单隐私合规检查属性中无 PII遵循 analytics 技能 的隐私原则Personal Key 仅存在于服务端至此你已经掌握了从 API 认证、七类常用操作、SDK 埋点到真实增长工程落地路径的完整 PostHog 集成知识——这套能力可以直接作为 AI Agent 接入 PostHog 的自动化操作手册使用。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐highlight.io 与 Amplitude 集成指南在会话回放中联动产品分析事件highlight.io 与 Amplitude 集成指南在会话回放中联动产品分析事件 本文以 highlight.io 官方集成文档为基础讲解如何通过一行可观测性后端免费快速部署 GB28181 视频监控平台三步法wvp-GB28181-pro 完整使用指南含国标级联免费快速部署 GB28181 视频监控平台三步法wvp GB28181 pro 完整使用指南含国标级联 不同品牌的摄像头、NVR 各说各话没法统一管理后端音视频前端Onlook会话录制用户操作回放与行为分析Onlook会话录制用户操作回放与行为分析 概述 Onlook作为一款面向设计师的开源可视化代码编辑器其会话录制功能是提升用户体验和协作效率的核心特性。通过前端AI 应用开发工具上一篇KiteSQL未来路线图SQL 2016支持与LLVM JIT优化展望下一篇Hound项目推荐创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 基于 PostHog 的产品分析与增长工程集成指南：为 AI Agent 提供事件捕获、会话回放与特征标志的完整操作手册
AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载本文聚焦 marketingskills 仓库中 PostHog 集成指南 的核心内容系统讲解这款开源产品分析工具如何通过 Capture API、Query API、Feature Flags API 与 JavaScript SDK为营销与增长团队尤其是 Claude Code 与 AI Agent 场景提供事件追踪、会话回放、特征标志与 A/B 测试能力。读完本文你将掌握 PostHog 的认证方式、七类常用 Agent 操作事件上报、批量上报、用户查询、HogQL 查询、特征标志、洞察与录制、JavaScript SDK 埋点模式并了解如何结合仓库中的 analytics、ab-testing、attribution 等技能在真实增长工程中落地 PostHog。一、PostHog 是什么开源产品分析全家桶PostHog 是一套开源的产品分析平台核心定位是Open-source product analytics with session replay and feature flags即同时具备传统产品分析事件追踪、会话回放观看真实用户操作录屏和特征标志灰度发布三大能力。与 GA4、Mixpanel 等同类工具相比PostHog 最大的差异化在于开源可自托管——你可以把它运行在自己的基础设施上从而满足隐私合规与数据主权要求。在 marketingskills 仓库的工具注册表中PostHog 被归类为Analytics产品分析类别与 GA4、Mixpanel、Amplitude、Segment、Adobe Analytics、Plausible 并列并在 Analytics 分类表中明确标注其定位为Open-source analytics, session replay。注册表给出的选型建议是Google 生态用户从 GA4 入手深度产品分析选 Mixpanel/Amplitude隐私优先站点选 Plausible而 PostHog 的核心适用场景则是开源要求、自托管需求与特征标志管理。能力矩阵一览原集成指南tools/integrations/posthog.md给出了完整的接入能力矩阵集成方式可用性说明API✓Capture API、Query API、Feature Flags APIMCP-暂不可用CLI✓posthogCLI用于本地开发SDK✓JavaScript、Python、Ruby、Go 等从这张表可以得到三个对 Agent 工程实践至关重要的结论无 MCP 服务器PostHog 目前不提供官方 MCPModel Context Protocol服务器因此 AI Agent 无法像 GA4、Stripe 那样通过 MCP 工具直接交互必须走 HTTP API 或 SDK 路径。这与 工具注册表 中MCP-Enabled Tools清单GA4、Stripe、Mailchimp 等相互印证——PostHog 不在其中。CLI 仅限本地开发posthogCLI 面向开发环境如本地自托管实例生产环境的数据读写主力是 REST API 与各语言 SDK。多语言 SDKJavaScript 之外还有 Python、Ruby、Go 等这意味着无论你的技术栈是前端站点、后端服务还是数据管道都能找到对应接入方式。二、认证机制两种 API Key 的正确用法PostHog 的认证是整个集成的基础原文档给出的要点可以归纳为三条规则认证类型API Key分为 Personal Key 与 Project Key 两类请求头Authorization: Bearer {api_key}——这是所有管理类 APIQuery、Persons、Insights、Session Recordings的标准认证方式数据上报Capture 与 Batch 端点不走 Bearer 头而是把Project API Key 直接放在请求体 payload 中两种 Key 的职责边界值得展开说明Key 类型用途传递方式Personal API Key管理类 API查询、用户、洞察、录制Authorization: Bearer {api_key}Project API Key事件上报Capture/Batch与客户端初始化请求体api_key字段 / SDK 初始化参数实战要点事件上报端点/capture/、/batch/、/decide/天然是公开设计——Project API Key 会出现在前端代码中这是产品分析工具的通用模式Mixpanel 同样用公开的 project token 做上报。而涉及读取数据的 Query API、Persons API 等则必须用带 Bearer 认证的服务端 Key严禁把 Personal Key 暴露在前端。仓库中 analytics 技能 的隐私与合规章节进一步强调了这种密钥分治的意义分析属性中不得包含 PII个人身份信息Key 的分级管理本身就是防止数据泄露的第一道防线。三、Agent 常用操作详解七类核心 API 调用原集成指南为 AI Agent 提供了七类开箱即用的 API 操作模板。以下逐一展开并补充参数说明与适用场景。3.1 上报单个事件Capture APIPOST https://app.posthog.com/capture/ { api_key: {project_api_key}, event: signup_completed, distinct_id: user_123, properties: { plan: pro, $current_url: https://example.com/signup } }参数解析api_keyProject API Key公开 Key必填event事件名。仓库 analytics 技能 强烈建议采用Object-Action对象-动作命名规范如signup_completed、button_clicked、form_submitted、checkout_payment_completed——全小写下划线具体到对象cta_hero_clicked优于button_clicked上下文放进 properties 而非事件名distinct_id用户唯一标识。匿名访客时为匿名 IDidentify()之后为邮箱/UUIDproperties事件属性$前缀为 PostHog 保留属性如$current_url、$browser、$os自定义属性直接使用业务字段名3.2 批量上报事件Batch APIPOST https://app.posthog.com/batch/ { api_key: {project_api_key}, batch: [ {event: pageview, distinct_id: user_1}, {event: signup, distinct_id: user_2} ] }batch字段接收事件数组一次请求可携带多条事件。批量上报有两个关键优势降低网络请求次数规避 Cloud 版 10,000 events/second 的瞬时峰值限制、服务端合并上报如 webhook 回调、离线补数场景。仓库 first-party-tracking 归因指南 中有一个非常典型的生产级用法——在第三方域名如 SavvyCal 预订工具的 webhook 中通过/batch/一次性完成身份合并$identify与转化事件上报const events []; if (anonId) { events.push({ event: $identify, distinct_id: userId, properties: { $anon_distinct_id: anonId, $set: { email: userId, name } }, }); } events.push({ event: discovery_call_booked, distinct_id: userId, properties: { booking_id, journey_linked: Boolean(anonId) }, }); await fetch(${POSTHOG_HOST}/batch/, { method: POST, headers: { Content-Type: application/json }, body: JSON.stringify({ api_key: POSTHOG_API_KEY, batch: events }), signal: AbortSignal.timeout(3000), });这段代码同时示范了三个 Agent 工程要点① 业务事件discovery_call_booked与系统事件$identify可以混在同一批次② webhook 中必须用AbortSignal.timeout限时并保证失败不影响主流程③ 用journey_linked属性记录归因链路是否打通便于事后监控覆盖率。3.3 按 distinct_id 查询用户Persons APIGET https://app.posthog.com/api/projects/{project_id}/persons/?distinct_iduser_123 Authorization: Bearer {api_key}注意此端点有两个路径参数差异{project_id}是 PostHog 项目的数字 ID可在项目设置中获取而认证使用 Bearer 头Personal Key。用途包括确认identify()是否生效、检查用户画像的$initial_*首触属性是否落地、排查匿名用户与已知用户是否成功合并。3.4 HogQL 查询事件Query APIPOST https://app.posthog.com/api/projects/{project_id}/query/ { query: { kind: HogQLQuery, query: SELECT event, count() FROM events WHERE timestamp now() - interval 7 day GROUP BY event ORDER BY count() DESC LIMIT 10 } }HogQL是 PostHog 基于 ClickHouse SQL 封装的查询语言是理解其SQL-like query language定位的关键。这个示例查询了近 7 天的事件频率 Top 10可用于快速审计埋点是否生效pageview、signup_completed是否都在上报发现未预期的高频事件排查重复埋点作为 Agent 自动化报告的数据源配合 analytics 技能 中的验证清单事件是否在正确触发点上报、属性值是否正确填充、是否存在重复事件HogQL 就是执行这些校验的底层查询工具。3.5 查询特征标志Feature Flags APIPOST https://app.posthog.com/decide?v3 { api_key: {project_api_key}, distinct_id: user_123 }/decide/端点是 SDK 内部获取特征标志决策的底层接口v3为当前 API 版本号。传distinct_id后返回该用户命中的所有特征标志及变量值。在 Agent 场景中可用它实现服务端灰度判断——例如决定向某批用户展示新定价页还是旧页面。特征标志是 PostHog 连接分析与实验的桥梁ab-testing 技能 明确把 PostHog 列为实验工具之一与 Optimizely、VWO 并列而 churn-prevention 技能 更进一步给出了具体实践用特征标志在服务端把用户切分到不同的取消流程再用漏斗分析追踪取消流程的每一步survey → offer → accept/decline → confirm从而用实验数据驱动流失挽留策略。3.6 获取洞察Insights APIGET https://app.posthog.com/api/projects/{project_id}/insights/ Authorization: Bearer {api_key}Insights 是 PostHog 中已保存的图表/看板趋势、漏斗、留存等。通过 API 拉取它们Agent 可以将现成的分析看板数据接入自动化报告流程而无需重新编写 HogQL 查询。3.7 获取会话录制Session Recordings APIGET https://app.posthog.com/api/projects/{project_id}/session_recordings/ Authorization: Bearer {api_key}会话录制是 PostHog 的差异化能力回放真实用户会话用于 UX 洞察。在营销场景中的典型用法包括观察用户在实际落地页上的滚动/点击行为、识别表单填写卡点、为 cro 转化率优化 提供定性证据。Agent 可通过该 API 拉取录制元数据清单与事件数据交叉分析。四、JavaScript SDK 埋点四步完成前端接入原文档给出了完整的前端 SDK 四步范式这是 Web 场景的标配接入路径// 1. Initialize初始化 posthog.init(PROJECT_API_KEY, { api_host: https://app.posthog.com }); // 2. Identify user识别用户 posthog.identify(user_123, { email: userexample.com, plan: pro }); // 3. Track event上报事件 posthog.capture(signup_completed, { method: email }); // 4. Check feature flag判断特征标志 if (posthog.isFeatureEnabled(new-pricing)) { // Show new pricing }对这四个调用的工程解读init传入 Project API Key 与api_host自托管实例需把api_host指向你自己的部署域名。仓库 first-party-tracking 归因指南 提醒SDK 加载前调用会被队列暂存stub 机制这也是为什么读取get_distinct_id()需要做加载完成判断。identify在知道用户是谁的时刻调用注册成功、表单提交、首次付费。仓库归因指南特别强调身份归一化——分析工具按精确字符串匹配身份Coreyx.com与coreyx.com会被拆成两个人因此上报前必须email.trim().toLowerCase()。配合person_profiles: identified_only配置identify()的这一刻才会创建用户画像并打上首触属性。capture与 Capture API 等价的前端封装。事件名遵循 analytics 技能 的 Object-Action 规范。isFeatureEnabled对应/decide/端点的 SDK 封装用于前端灰度判断。进阶匿名 ID 的安全读取在把匿名用户引导到第三方转化域名并回传归因的场景中详见 first-party-tracking 归因指南Agent 需要在前端安全读取当前匿名 ID。由于 SDK stub 在加载完成前get_distinct_id()返回undefined归因指南给出了一种先 SDK 后 Cookie 的回退读取实现并附带严格的匿名性守卫export function getPostHogDistinctId() { if (typeof window undefined) return null; try { if (window.posthog?.__loaded) { const id window.posthog.get_distinct_id(); if (id) return isAnonymousDistinctId(id) ? id : null; } } catch {} try { const prefix ph_${POSTHOG_API_KEY}_posthog; const cookie document.cookie.split(/;\s*/).find(c c.startsWith(prefix)); if (!cookie) return null; const parsed JSON.parse(decodeURIComponent(cookie.slice(prefix.length))); return typeof parsed.distinct_id string isAnonymousDistinctId(parsed.distinct_id) ? parsed.distinct_id : null; } catch { return null; } }其中匿名性守卫isAnonymousDistinctId的规则邮箱身份应用场景id.length 0 id.length 100 !id.includes()——即只允许透传看起来不像邮箱的匿名 ID一旦identify()之后当前distinct_id变成邮箱形状立即拒绝透传防止 PII 泄露与错误合并。归因指南给出的铁律是当身份不明确时什么都不发送——缺失的归因只是数据缺口错误的合并则是数据污染。五、关键能力全景与选型建议原文档将 PostHog 的六大核心能力总结如下Event tracking事件追踪产品分析的基础能力覆盖 Web 与移动端Session replay会话回放观看真实用户会话获取 UX 洞察Feature flags特征标志控制功能灰度发布与实验分流A/B testing内置实验开箱即用的 A/B 测试能力配合 ab-testing 技能 使用HogQLSQL 风格的查询语言底层基于 ClickHouseSelf-hostable可自托管可在自有基础设施上运行满足数据主权要求何时选择 PostHog原文档给出了五类明确的使用场景产品分析 隐私优先需要在分析能力与数据隐私之间取得平衡会话回放做 UX 洞察需要看真实用户操作而非仅看数字特征标志管理需要服务端灰度与功能开关能力自托管分析需求数据必须留在自己的基础设施内开源要求代码库与生态完全开源从仓库 工具注册表 的 Agent 选型建议看各分析工具的定位是互补的GA4 适合 Google 生态Mixpanel/Amplitude 适合深度产品分析Plausible 适合隐私极简场景而 PostHog 的独特价值在于开源 自托管 特征标志 会话回放的组合——这是其他商业 SaaS 分析工具难以同时提供的。在 analytics 技能 的工具集成表中PostHog 与 GA4、Mixpanel、Amplitude、Segment 并列展示Agent 应根据上述场景而非品牌偏好选择。六、速率限制Cloud 与自托管的差异原文档给出的速率限制信息非常明确Cloud云托管版10,000 events/second每秒 1 万事件Self-hosted自托管版无限制取决于你自己的基础设施容量对 Agent 工程的意义批量上报/batch/是规避 Cloud 瞬时峰值的最直接手段——把突发的事件流如 campaign 高峰、webhook 风暴聚合为批量请求比逐条上报更稳健。自托管场景下无限制仅指软件层面无硬性配额实际吞吐受 ClickHouse 集群性能约束扩容规划仍需按事件量设计。七、PostHog 在仓库增长工程中的完整落地路径PostHog 在 marketingskills 仓库中不是孤立文档而是贯穿多条技能链路的底层数据与实验基础设施。综合仓库源码可以梳理出四条典型的落地路径路径一营销分析analytics 技能在 analytics 技能 中PostHog 是五大推荐分析工具之一。Agent 可参照该技能的 Tracking Plan 框架Event Name | Category | Properties | Trigger | Notes表格与 事件库参考 设计埋点计划——例如营销站点事件cta_clicked、form_submitted、signup_completed、产品事件onboarding_step_completed、feature_used、purchase_completed、电商事件product_added_to_cart、checkout_started——再用本文第三节的 Capture/Batch API 落地到 PostHog。路径二实验驱动ab-testing 技能ab-testing 技能 将 PostHog 列为实验工具与 Optimizely、VWO 并列其假设框架Because [observation], we believe [change] will cause [outcome] for [audience]...配合 PostHog 的特征标志分流与漏斗分析构成完整的提出假设 → 分流实验 → 漏斗度量闭环。路径三自助归因attribution 技能first-party-tracking 归因指南 以PostHog SavvyCal 作为完整工作示例展示了如何用 PostHog 的identify()、$anon_distinct_id合并、/batch/上报、$initial_*首触属性把匿名浏览 → 第三方域名转化拼接成一条可归因的完整旅程。核心模式可以概括为拿到匿名 ID → 跨越域名边界携带它 → 在对岸合并身份 → 按首触渠道拆分转化。路径四流失挽留churn-prevention 技能churn-prevention 技能 给出了一个具体的工程配方用 PostHog 特征标志在服务端把用户分流到不同取消流程再用漏斗分析追踪取消流程每步转化survey → offer → accept/decline → confirm从而用实验数据优化挽留策略。八、验证与上线自检清单综合原文档 API 模板与仓库各技能的工程经验PostHog 集成上线前建议完成以下验证事件链路验证用 HogQL 查询SELECT event, count() ...确认各事件按预期频率上报且无重复/畸形事件身份合并验证用 Persons API?distinct_id...确认匿名浏览历史与已知用户画像成功合并$initial_utm_source首触属性已落地特征标志验证/decide/返回预期标志与变量值isFeatureEnabled在前端按分流生效批量上报验证向/batch/手动 POST 测试 payload返回{status:Ok}且用户画像正确合并参考归因指南的验证清单隐私合规检查属性中无 PII遵循 analytics 技能 的隐私原则Personal Key 仅存在于服务端至此你已经掌握了从 API 认证、七类常用操作、SDK 埋点到真实增长工程落地路径的完整 PostHog 集成知识——这套能力可以直接作为 AI Agent 接入 PostHog 的自动化操作手册使用。赞分享AI 技能人工智能【免费下载链接】marketingskillsMarketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.项目地址https://gitcode.com/GitHub_Trending/mar/marketingskills点击查看免费下载相关推荐highlight.io 与 Amplitude 集成指南在会话回放中联动产品分析事件highlight.io 与 Amplitude 集成指南在会话回放中联动产品分析事件 本文以 highlight.io 官方集成文档为基础讲解如何通过一行可观测性后端免费快速部署 GB28181 视频监控平台三步法wvp-GB28181-pro 完整使用指南含国标级联免费快速部署 GB28181 视频监控平台三步法wvp GB28181 pro 完整使用指南含国标级联 不同品牌的摄像头、NVR 各说各话没法统一管理后端音视频前端Onlook会话录制用户操作回放与行为分析Onlook会话录制用户操作回放与行为分析 概述 Onlook作为一款面向设计师的开源可视化代码编辑器其会话录制功能是提升用户体验和协作效率的核心特性。通过前端AI 应用开发工具上一篇KiteSQL未来路线图SQL 2016支持与LLVM JIT优化展望下一篇Hound项目推荐创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考