用途:帮助搭建能支撑营销与产品决策的分析追踪方案,适用于设置、改进或审计埋点与衡量体系,也覆盖 GA4、Google Tag Manager 相关内容。
初始评估:若存在 .agents/product-marketing.md(或 .claude/product-marketing.md,旧版为 product-marketing-context.md),先读取该背景,再只询问未覆盖或本任务特有的信息。实现前需了解业务背景(数据将支持哪些决策、关键转化)、当前状态(已有追踪与在用工具)、技术背景(技术栈、隐私/合规要求)。
核心原则:为决策而非数据而追踪,每个事件都应服务一个决策,避免虚荣指标,质量优先于数量;从问题出发反推所需事件;命名保持一致,实现前先确立模式并记录;维护数据质量,验证实现并持续监控。
追踪计划框架:以事件名、类别、属性、触发条件、备注为结构;事件类型包括页面浏览、用户操作、系统事件、自定义转化。推荐命名格式为“对象-动作”,如 signup_completed、button_clicked、form_submitted、checkout_payment_completed;使用小写加下划线,具体化命名(如 cta_hero_clicked),把上下文放进属性而非事件名,避免空格和特殊字符并记录决策。
基础事件:营销站点包括 cta_clicked(button_text、location)、form_submitted(form_type)、signup_completed(method、source)、demo_requested;产品/应用包括 onboarding_step_completed(step_number、step_name)、feature_used(feature_name)、purchase_completed(plan、value)、subscription_cancelled(reason)。标准属性覆盖页面、用户、活动、产品四类。需避免在属性中放入 PII。
GA4:创建媒体资源和数据流,安装 gtag.js 或 GTM,启用增强型衡量,配置自定义事件,在管理中标记转化。自定义事件示例:gtag('event', 'signup_completed', {'method': 'email','plan': 'free'});
GTM:使用代码、触发器、变量与数据层模式,例如 dataLayer.push({'event': 'form_submitted','form_name': 'contact','form_location': 'footer'});
UTM 参数:utm_source、utm_medium、utm_campaign、utm_content、utm_term;统一小写,选用下划线或连字符并保持一致,具体而简洁,用表格记录全部 UTM。
调试与验证:可用 GA4 DebugView、GTM Preview Mode、浏览器扩展;检查事件是否在正确触发器上触发、属性值是否正确、是否重复、跨浏览器与移动端是否正常、转化是否记录、是否泄露 PII。
隐私与合规:欧盟/英国/加拿大等地区需 cookie 同意,不使用 PII,设置数据保留,支持用户删除;实现上采用同意模式、IP 匿名化,只收集必要数据,并集成同意管理平台。
输出可形成追踪计划文档,含概览、事件表、自定义维度与转化表。常用集成工具包括 GA4、Mixpanel、Amplitude、PostHog、Segment。具体事件库、GA4 与 GTM 详细实现资料未在本次资料中展开。