名称: 营销产品分析 描述: 产品分析仪表板和策略，涵盖事件分类设计、追踪计划、用户行为分析、激活/保留指标和营销归因。以PostHog为首选，支持多平台（Pendo、Amplitude、Mixpanel、Heap）。
产品分析 - 仪表板与测量操作系统
现代最佳实践（2026年1月）: PostHog为首选，会话上下文注册，严格的事件命名，北极星激活事件，隐私优先的归因。
主要来源位于data/sources.json。如果网络搜索可用，请在给出明确建议前根据官方文档刷新时间敏感细节。
无冗余内容。仅可执行步骤、模板和清单。
何时使用此技能
- 事件分类设计: 命名约定、事件层次结构、属性结构
- 追踪计划创建: 追踪什么、在哪里、为什么
- 营销归因: UTM捕获、活动追踪、来源归因
- 激活指标: 定义和测量用户激活
- 留存分析: 队列分析、流失预测、参与度评分
- 平台设置: PostHog、Pendo、Amplitude、Mixpanel、Heap配置
- 数据质量: 事件验证、调试、治理
默认工作流（除非用户覆盖）
- 澄清目标和约束: 业务问题、生命周期阶段、身份模型、隐私/同意要求、平台（web/移动/后端）
- 定义北极星价值事件: 一个标准事件，代表收到的价值（加上最小的支持事件集）
- 编写追踪计划: 使用
assets/tracking-plan-saas.md作为起始模板；定义所需属性和所有权 - 实施仪表板: 选择快速参考中的平台指南（PostHog/Pendo/Amplitude/Mixpanel/Heap；如果需要，服务器端）
- 质量保证和强化: 使用
assets/analytics-qa-checklist.md+references/event-quality-rules.md+references/production-hardening.md
核心原则
1. 北极星价值事件（至关重要）
每个产品必须有一个标准激活事件 - 单个事件，表示“用户收到真实价值”。
| 产品类型 | 北极星事件 | 触发时机 |
|---|---|---|
| 内容/媒体 | content_consumed |
内容完全加载并可见 |
| SaaS工具 | workflow_completed |
用户完成核心工作流 |
| 电子商务 | purchase_completed |
交易成功 |
| 开发者工具 | integration_working |
首次成功API调用 |
规则: 每个功能事件应折叠为一个激活事件，带有属性：
// 正确：通过：一个事件，通过属性区分
posthog.capture('value_delivered', { value_type: 'report', value_id: 'rpt_123' });
posthog.capture('value_delivered', { value_type: 'integration', value_id: 'int_456' });
// 错误：失败：分散的“价值”事件（在留存/漏斗中更难统一）
posthog.capture('report_generated');
posthog.capture('integration_working');
2. 最小可行分析（MVA）
从5-15个事件开始，而不是200个。 您可以随时添加更多。
| 层 | 必需事件 | 可选 |
|---|---|---|
| 获取 | page_viewed, signup_completed |
campaign_landed |
| 激活 | 您的激活事件（最多1-2个） | onboarding_step_completed |
| 参与 | 您的参与信号（最多1-2个） | feature_used |
| 转化 | purchase_completed |
checkout_started |
3. 会话上下文注册
使用posthog.register()每会话注册标准上下文一次：
posthog.register({
app_env: 'prod',
platform: 'web',
landing_path: window.location.pathname,
traffic_source: deriveTrafficSource(),
utm_source, utm_medium, utm_campaign
});
4. 事件命名约定
| 规则 | 正确 | 不正确 |
|---|---|---|
| 仅小写 | user_signed_up |
User_Signed_Up |
| 蛇形_case | button_clicked |
buttonClicked |
| 对象_动作格式 | project_created |
createProject |
快速参考
| 任务 | 参考 |
|---|---|
| PostHog设置 | references/posthog-implementation.md |
| Pendo设置 | references/pendo-implementation.md |
| Amplitude设置 | references/amplitude-implementation.md |
| Mixpanel设置 | references/mixpanel-implementation.md |
| Heap设置 | references/heap-implementation.md |
| 服务器端追踪 | references/server-side-tracking.md |
| 隐私合规 | references/privacy-compliance.md |
| 事件质量规则 | references/event-quality-rules.md |
| 生产模式 | references/production-hardening.md |
| 追踪计划模板 | assets/tracking-plan-saas.md |
| UTM标准 | assets/utm-naming-standards.md |
实施清单
### 事件正确性
- [ ] 激活事件仅在价值可见时触发（而不是在挂载时）
- [ ] 事件包括追踪计划中定义的必需属性（例如，`object_type`, `object_id`, `surface`, `flow`）
- [ ] 在可能重复触发的地方使用去重保护（参见`references/production-hardening.md`）
- [ ] 事件每个功能在恰好一个地方触发
### 会话上下文
- [ ] `registerSessionContext()`在应用初始化时调用
- [ ] 包括：`app_env`, `platform`, `landing_path`, `traffic_source`, UTMs
### 类型安全
- [ ] `TrafficSource`使用TypeScript枚举，而不是自由字符串
- [ ] 所有属性使用`snake_case`
### 隐私
- [ ] 个人属性默认不包含PII
- [ ] 仅在明确同意下存储电子邮件
决策树
### 未看到预期事件？
├─ PostHog默认事件可见吗？（$pageview, autocapture）
│ ├─ 是 -> 自定义事件错误 -> 检查组件、保护、去重
│ └─ 否 -> SDK问题 -> 检查环境变量、同意、广告拦截器
├─ 检查DevTools网络 -> 验证/e/调用
└─ 检查PostHog实时事件（非活动）
### 无法回答业务问题？
├─ 缺少事件 -> 为关键时刻添加自定义事件
├─ 缺少属性 -> 用上下文丰富
├─ 没有用户ID -> 实施identify()调用
└─ 归因缺口 -> 捕获UTMs，通过注册持久化
反模式总结
| 反模式 | 替代方案 |
|---|---|
| 没有北极星事件 | 定义一个标准激活事件 |
过多的*_viewed事件 |
折叠为一个事件，带有属性 |
| 在identify()中使用PII | 仅基于状态的识别 |
| 从重新渲染中产生事件垃圾邮件 | 使用isPostHogReady()保护 + 去重 |
自由文本source |
使用TypeScript枚举作为TrafficSource |
| 非唯一ID | 使用稳定领域ID（*_id）或action_instance_id |
| 追踪一切 | 专注于5-15个关键事件（MVA） |
| 不一致的命名 | 严格强制执行小写蛇形_case |
详见references/event-quality-rules.md获取详细示例。
指标和基准
默认为内部基线和趋势线；仅在比较类似细分和定义时使用外部基准。
如果需要外部参考，请见data/sources.json -> benchmarks_research。
模板
| 模板 | 目的 |
|---|---|
| tracking-plan-saas.md | 完整的SaaS追踪计划 |
| marketing-event-library.md | 营销归因事件 |
| utm-naming-standards.md | UTM参数指南 |
| activation-metrics-template.md | 激活指标定义 |
| analytics-qa-checklist.md | 数据质量清单 |
国际市场
此技能使用美国/英国市场默认值。对于国际产品分析：
| 需求 | 参见技能 |
|---|---|
| 区域合规（GDPR、PIPL、LGPD） | marketing-geo-localization |
| 区域分析平台（百度统计） | marketing-geo-localization |
| 区域隐私要求 | marketing-geo-localization |
| 司法管辖区的Cookie同意 | marketing-geo-localization |
如果您的查询主要关于GDPR/PIPL/LGPD或同意配置，请使用marketing-geo-localization与此技能一起。
相关技能
- marketing-cro - A/B测试，转化优化
- marketing-leads-generation - 潜在客户漏斗，B2B归因
- qa-agent-testing - LLM代理测试（补充AI分析）
- data-sql-optimization - SQL用于分析查询
数据来源
详见data/sources.json获取官方文档链接。