SuperAPI AI 工具集

analytics

数据与分析

查看项目

更新于 10-16 04:08

技能介绍

用途

该技能用于在用户需要设置、改进或审计分析追踪与衡量时提供帮助。当用户提及“set up tracking”“GA4”“Google Analytics”“conversion tracking”“event tracking”“UTM parameters”“tag manager”“GTM”“analytics implementation”等关键词时适用。其目标是帮助建立能够为营销和产品决策提供可执行洞察的追踪体系。

主要能力

  • 初始评估:在实施追踪前,先了解业务背景(数据将支持哪些决策、关键转化是什么)、当前状态(已有追踪、在用工具)、技术背景(技术栈、隐私/合规要求)。若存在 .agents/product-marketing.md(或 .claude/product-marketing.md,或旧版 product-marketing-context.md),会先读取该上下文,仅询问未覆盖或本任务特有的信息。
  • 核心原则:为决策而追踪而非为数据而追踪;从问题出发反向推导需要追踪的内容;命名保持一致;维护数据质量。
  • 追踪计划框架:提供事件名称、类别、属性、触发条件、备注的结构化表格;区分页面浏览、用户操作、系统事件、自定义转化等事件类型。
  • 事件命名规范:推荐“对象-动作”格式(如 signup_completed、button_clicked),使用小写加下划线,具体化命名,将上下文放入属性而非事件名,避免空格和特殊字符,并记录决策。
  • 必备事件:分别列出营销站点(cta_clicked、form_submitted、signup_completed、demo_requested)和产品/应用(onboarding_step_completed、feature_used、purchase_completed、subscription_cancelled)的示例事件及属性。
  • 事件属性:涵盖页面、用户、活动、产品等标准属性类别及最佳实践(属性名一致、包含相关上下文、不重复自动属性、避免 PII)。
  • GA4 实现:快速设置步骤(创建 GA4 属性和数据流、安装 gtag.js 或 GTM、启用增强衡量、配置自定义事件、在 Admin 中标记转化),并提供自定义事件代码示例。
  • Google Tag Manager:容器结构(标签、触发器、变量)与 dataLayer 模式示例。
  • UTM 参数策略:标准参数(utm_source、utm_medium、utm_campaign、utm_content、utm_term)及命名规范。
  • 调试与验证:测试工具(GA4 DebugView、GTM Preview Mode、浏览器扩展)、验证清单、常见问题排查。
  • 隐私与合规:Cookie 同意、不使用 PII、数据保留设置、用户删除能力、同意模式、IP 匿名化等。
  • 输出格式:提供追踪计划文档模板,包含概述、事件表、自定义维度、转化等部分。
  • 工具集成:列出 GA4、Mixpanel、Amplitude、PostHog、Segment 等分析工具及其适用场景。
  • 相关技能:ab-testing、seo-audit、cro、revops。

使用方式

该技能以技能(skill)形式提供,在匹配上述场景时被调用。使用时会先检查产品营销上下文文件,再按需询问业务、当前状态、技术背景等问题,随后依据追踪计划框架、命名规范、实现指南等给出方案,并可按模板输出追踪计划文档。具体安装命令与调用方式暂未提供。

适用场景

适用于需要搭建、优化或审计分析追踪与衡量的场景,例如配置 GA4 或 GTM、定义事件与属性、规划 UTM 参数、验证追踪实现、处理隐私合规等,服务于营销与产品决策。

限制

仅当任务明确匹配其上游来源和本地项目上下文时使用。应用更改前需验证命令、生成的代码、依赖、凭据和外部服务行为。示例不能替代针对具体环境的测试、安全审查,以及对破坏性或高成本操作的用户批准。