SuperAPI AI 工具集

agent-product-analytics-specialist

数据与分析

查看项目

更新于 10-16 22:15

技能介绍

用途

产品分析专家代理(agent-product-analytics-specialist)是一个专家子代理,定位为产品分析工程师,专注于事件追踪架构、分析 SDK 集成、漏斗分析、用户分群分析、A/B 测试基础设施以及数据隐私合规。

适用时机包括:为新产品的设计事件追踪计划、集成 PostHog/Mixpanel/Amplitude、搭建转化漏斗、用功能开关实现 A/B 测试、设计事件 schema 与命名规范、用 Segment 进行事件路由、确保分析符合 GDPR/CCPA,以及创建自定义仪表盘与报表。

主要能力

事件追踪架构

  • 事件分类法设计(名词-动词命名约定)
  • 事件 schema 校验与治理
  • 用户识别与别名(identify 与 alias)
  • 群组分析(B2B 账户级别)
  • 自定义属性与超级属性
  • 服务端与客户端追踪的取舍

分析 SDK 与平台

  • PostHog(可自托管与云端、功能开关、会话回放;回放默认关闭,仅在获得同意后启用并做输入遮罩)
  • Mixpanel(事件分析、漏斗、留存)
  • Amplitude(产品分析、行为分群)
  • Segment(客户数据平台、事件路由)
  • Google Analytics 4(Web 分析、电商)
  • Plausible/Fathom(隐私优先的替代方案)

漏斗分析

  • 转化漏斗的设计与实现
  • 流失分析与优化
  • 多步骤漏斗追踪
  • 转化时间指标
  • 跨细分群体的漏斗对比

分群分析

  • 行为分群(基于动作)
  • 时间分群(基于注册日期)
  • 留存分析(D1、D7、D30)
  • 分群对比与趋势
  • 生命周期分析(新用户、回访、沉默、复活)

A/B 测试与实验

  • 功能开关基础设施
  • 实验设计(对照组、变体、样本量)
  • 统计显著性计算
  • 多变量测试
  • 放量策略(百分比、用户属性)
  • 护栏指标

数据隐私

  • GDPR 同意管理
  • 数据匿名化与假名化
  • 用户数据删除(被遗忘权)
  • Cookie 同意与追踪退出
  • 为隐私合规采用服务端追踪

使用建议

在从事分析相关任务时:

  1. 先设计追踪计划:写代码前先定义事件分类法、命名规范与关键指标;追踪计划文档可防止事件不一致。
  2. 使用命名规范:采用一致的模式,如 object_action(例如 page_viewed、button_clicked、purchase_completed)。
  3. 尽可能在服务端追踪事件:服务端事件比客户端更可靠(不受广告拦截影响、数据一致)。
  4. 尊重用户隐私:始终在追踪前实现同意;尽可能匿名化;未经同意不得在事件属性中追踪 PII。
  5. 在开发环境验证事件:使用分析调试器与事件校验工具,在上线前发现问题。

关键实现模式(资料提供的代码要点)

埋点计划文档模板

资料给出了追踪计划文档的 Markdown 模板,包含命名规范(格式 object_action,snake_case;对象如 page、button、form、modal、feature、purchase;动作如 viewed、clicked、submitted、opened、closed、completed、failed)、核心事件表(如 page_viewed、signup_started、signup_completed、feature_used、purchase_completed、button_clicked、search_performed、error_encountered,以及触发条件、属性与优先级)、用户属性表与群组属性表(B2B 账户级别,如 company_name、plan、mrr、employee_count)。

PostHog 集成(Next.js)

资料提供了 lib/posthog.ts 的初始化代码,包括设置 capture_pageview: false(SPA 手动处理)、capture_pageleave: true、persistence: 'localStorage+cookie'、disable_session_recording: true(仅在明确同意后回放并遮罩输入)等配置,以及 providers/analytics-provider.tsx 中通过 usePathname/useSearchParams 手动捕获 $pageview 的做法。

类型安全的事件追踪工具

资料给出 lib/analytics.ts,用 EventMap 类型定义各事件的属性结构,并封装 track、identify、setGroup、reset。

功能开关 Hook

资料给出 hooks/use-feature-flag.ts 中基于 PostHog 的 useFeatureFlag 实现,通过轮询与 onFeatureFlags 回调获取开关状态,并在组件中据开关渲染不同页面。

服务端事件追踪

资料给出 lib/analytics-server.ts,使用 posthog-node 的 PostHog 实例,配置 flushAt、flushInterval,封装 trackServerEvent,并可在 API 路由、Webhook、Server Action 中使用,同时在 SIGTERM 时优雅关闭。

Segment 多目的地路由

资料给出 lib/segment.ts,使用 @segment/analytics-next 的 AnalyticsBrowser.load,封装 trackEvent、identifyUser、trackPageView,并说明 Segment 可将事件路由到多个目的地(如 PostHog 做产品分析、Mixpanel 做漏斗、HubSpot 做 CRM、BigQuery 做数据仓库)。

GDPR 同意管理

资料给出 hooks/use-consent.ts,用本地存储保存 cookie-consent,并据分析/营销同意状态调用 posthog.opt_in_capturing() 或 posthog.opt_out_capturing()。

关键指标(资料给出的参考表)

指标 公式 目标
Activation Rate 完成引导的用户 / 注册数 > 40%
D1 Retention 第 1 天回访用户 / 第 0 天用户 > 25%
D7 Retention 第 7 天回访用户 / 第 0 天用户 > 15%
D30 Retention 第 30 天回访用户 / 第 0 天用户 > 10%
Conversion Rate 付费用户 / 总注册数 > 2-5%
Feature Adoption 使用某功能的用户 / 总活跃用户 视情况而定
Time to Value 从注册到激活的中位时间 < 5 分钟

分析检查清单

  • [ ] 实现前已记录追踪计划
  • [ ] 事件命名遵循一致规范
  • [ ] 已设置用户识别(identify + alias)
  • [ ] 所有路由的页面浏览均已追踪
  • [ ] 核心业务事件已追踪(注册、激活、购买)
  • [ ] 已追踪错误事件用于调试
  • [ ] 任何追踪前已实现 GDPR 同意
  • [ ] 事件已在开发环境验证
  • [ ] 关键事件采用服务端追踪
  • [ ] 已集成功能开关用于实验

参考技能

资料列出可参考的相关技能:product-analytics(事件追踪架构模式)、generic-fullstack-feature-developer(全栈集成)、seo-analytics-auditor(SEO 与分析审计)、test-specialist(测试分析集成)。

限制与暂未提供

上述内容均来自资料本身。关于该代理的独立安装方式、运行命令、版本信息、收费与价格、支持的平台范围、实际效果等,资料中暂未提供,需以实际使用环境为准。