agentic-awesome-skills Analytics 技能实战：从 Tracking Plan 设计到 GA4/GTM 埋点落地

AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载导读本文系统拆解 agentic-awesome-skills 仓库中analytics分析埋点技能包的完整方法论与工程实现覆盖事件建模、命名规范、GA4/GTM 双通道落地、UTM 归因、调试校验与 GDPR 合规六大环节。读完本文你将能够以先问决策、再定事件、后写代码的顺序独立为营销站、SaaS 产品与电商业务产出一份可执行、可审计、可度量的完整 Tracking Plan并直接在 gtag.js 与 dataLayer 中落地。一、技能包概览何时启用与元数据定位analytics技能在仓库中以独立技能包形式存放主文档位于 plugins/agentic-awesome-skills-claude/skills/analytics/SKILL.md主插件 plugins/agentic-awesome-skills/skills/analytics/SKILL.md 中保留同等副本配套三份参考文档与一份评测清单事件库参考按业务类型分类的完整事件清单GA4 实现参考数据流、自定义事件、转化、自定义维度、受众、调试与数据质量GTM 实现参考容器结构、dataLayer 模式、常用标签、预览调试与同意管理评测用例6 组能力校验场景B2B SaaS 埋点、UTM 规划、重复事件排查、电商从零建站、GDPR 合规、A/B 测试协同。从 catalog.json 可见该技能在目录中登记risk: critical、来源为社区技能source_type: community描述为When the user wants to set up, improve, or audit analytics tracking and measurement.并带有analytics、tracking、measurement、audit等触发词。也就是说当用户提到搭建/改进/审计埋点、GA4、Google Analytics、转化追踪、事件追踪、UTM 参数、标签管理器GTM、analytics implementation等表述时该技能即被激活其角色定位是analytics 实现与度量专家目标是让埋点数据真正支撑营销与产品决策。技能包还给出明确的边界声明Limitations仅在任务与上游来源及本地项目上下文明确匹配时使用对命令、生成代码、依赖、凭据与外部服务行为在落地前必须验证示例不能替代针对具体环境的测试、安全评审或用户对高成本/破坏性操作的审批。二、动手前先做初始评估读上下文、问对问题该技能强调埋点前先补全上下文这是避免盲目埋点、产出垃圾数据的第一道闸门。2.1 优先读取产品营销上下文技能规定如果项目存在.agents/product-marketing.md或.claude/product-marketing.md旧版环境为product-marketing-context.md必须先读取该文件把其中已覆盖的信息当作已知背景只针对任务特有、未被覆盖的信息再向用户提问。这条规则在 评测用例 #1 中被列为第一条断言Checks for product-marketing.md是技能执行的标准起点。2.2 三项前置理解在开始实现前必须厘清三个层面的上下文业务上下文Business Context——这些数据将支撑哪些决策关键转化是什么现状Current State——目前已有哪些埋点正在使用哪些工具GA4、Mixpanel、Amplitude、PostHog、Segment技术上下文Technical Context——技术栈是什么是否存在隐私/合规要求这三问决定了事件表怎么建、参数怎么取、数据往哪送是整个 Tracking Plan 的输入契约。三、核心原则为决策而埋不为数据而埋技能将方法论浓缩为四条原则是后续所有操作的总纲为决策而追踪Track for Decisions, Not Data每个事件都应能回答一个决策问题拒绝虚荣指标vanity metrics追求事件质量而非数量。从问题出发Start with the Questions先问你需要知道什么你会基于这些数据采取什么行动再反向推导需要追踪什么。命名一致Name Things Consistently命名规范先于实现确立并全部文档化。维护数据质量Maintain Data Quality验证实现、监控异常干净的数据优于海量的数据。这四条原则贯穿后续的事件表、参数表与调试清单是评估一切埋点方案对错的价值标尺。四、Tracking Plan 框架事件规划的结构化模板4.1 规划表结构技能给出了一张最小可用的追踪计划表结构Event Name | Category | Properties | Trigger | Notes ---------- | -------- | ---------- | ------- | -----每一列都对应一个关键问题事件叫什么Event Name、属于哪一类Category页面浏览/用户行为/系统事件/自定义转化、带哪些参数Properties、在什么时机触发Trigger、有哪些备注Notes。这张表既是设计工具也是后续审计与复盘的主文档。4.2 四类事件模型类型示例Pageviews自动采集辅以元数据增强User Actions按钮点击、表单提交、功能使用System Events注册完成、购买、订阅变更Custom Conversions目标达成、漏斗阶段更完整、按业务类型细分的事件库见 事件库参考其中还包含漏斗事件序列Funnel Event Sequences例如标准购买漏斗pricing_viewed → plan_selected → checkout_started → payment_info_entered → purchase_completed。五、事件命名规范Object-Action 与一致性约束命名是数据资产的第一性。技能推荐Object-Action对象-动作格式全小写、下划线连接signup_completed button_clicked form_submitted article_read checkout_payment_completed最佳实践约束包括全小写 下划线具体化用cta_hero_clicked而非button_clicked上下文放进 properties 而不是事件名事件名保持动词性、可复用场景差异交给参数避免空格与特殊字符所有命名决策记录在案。这一规范直接对应评测断言Uses object_action naming convention也是后续 GA4/GTM 中事件名与参数名对齐的基础。六、关键事件清单营销站与产品/App 的最小必需集6.1 营销站Marketing SiteEventPropertiescta_clickedbutton_text, locationform_submittedform_typesignup_completedmethod, sourcedemo_requested-6.2 产品/AppProduct/AppEventPropertiesonboarding_step_completedstep_number, step_namefeature_usedfeature_namepurchase_completedplan, valuesubscription_cancelledreason6.3 深度扩充按业务类型的完整事件库事件库参考 将事件按五类业务场景展开构成可复制的开箱即用事件集营销站事件导航与互动page_view、scroll_depth、outbound_link_clicked、video_completed等、CTA 与表单cta_clicked、form_started、form_field_completed、form_error、resource_downloaded等、转化signup_started、demo_requested、trial_started等产品/App 事件引导onboarding_started、first_key_action_completed等、核心使用feature_used、action_completed、search_performed、settings_changed等、错误与支持error_occurred、help_opened、feedback_submitted等商业化事件定价与结账pricing_viewed、plan_selected、checkout_started、purchase_failed等、订阅管理subscription_upgraded、subscription_cancelled、billing_updated等电商事件浏览product_viewed、product_list_viewed、product_filtered等、购物车product_added_to_cart、cart_viewed等、结账checkout_step_completed、coupon_applied、purchase_completed等、售后order_confirmed、refund_requested、review_submitted等B2B/SaaS 专属团队与协作team_created、team_member_invited、role_changed等、集成integration_started、integration_connected等、账户account_upgraded、account_churned、account_reactivated等。评测用例 #4 特别强调电商从零建站时必须覆盖product_viewed → product_added_to_cart → cart_viewed → checkout_started → checkout_step_completed → purchase_completed全链并带上item_id、item_name、price、quantity等增强电商参数按必须项/锦上添花划分优先级输出。七、事件属性Parameters让事件有血有肉7.1 标准属性四象限类别属性Pagepage_title, page_location, page_referrerUseruser_id, user_type, account_id, plan_typeCampaignsource, medium, campaign, content, termProductproduct_id, product_name, category, price事件库参考进一步给出了可直接落地的参数取值样例用户上下文user_id: 12345、user_type: free | trial | paid、plan_type: starter | pro | enterprise、会话上下文session_id、session_number、page、referrer、营销活动上下文source: google、medium: cpc、campaign: spring_sale、电商商品上下文product_id: SKU123、price: 99.99、currency: USD以及计时参数timestamp、time_on_page、session_duration。7.2 属性最佳实践属性名保持跨事件一致如method在所有表单类事件中含义统一携带与决策相关的上下文不要重复 GA4 自动采集的属性如自动page_view已带page_title属性中严禁出现 PII个人身份信息。八、GA4 实现从 Quick Setup 到深度配置8.1 五步快速接入创建 GA4 媒体资源Property与数据流Data Stream安装 gtag.js 或通过 GTM 部署启用增强型衡量Enhanced Measurement配置自定义事件在 Admin 中将关键事件标记为转化Conversions。8.2 自定义事件示例gtag.jsgtag(event, signup_completed, { method: email, plan: free });8.3 深度扩充GA4 配置要点GA4 实现参考 对上述五步给出工程级细节数据流每个平台Web/iOS/Android一条数据流开启增强型衡量以自动采集page_view自动、scroll90% 滚动深度可开关、outbound_click自动、site_search需配置参数、video_engagement可开关、file_download可配置扩展名数据保留期默认 2 个月、最长 14 个月经用户同意后可启用 Google Signals 做跨设备。推荐事件Recommended Events优先使用 Google 预定义事件以增强报告——全属性通用login、sign_up、share、search电商view_item、add_to_cart、begin_checkout、add_payment_info、purchase、refund游戏level_up、unlock_achievement、post_score、spend_virtual_currency。带值的自定义事件gtag(event, purchase, { transaction_id: T12345, value: 99.99, currency: USD, items: [{ item_id: SKU123, item_name: Product Name, price: 99.99 }] });用户属性与 User IDgtag(set, user_properties, { user_type: premium, plan_name: pro }); gtag(config, GA_MEASUREMENT_ID, { user_id: USER_ID });转化设置先在 GA4 确认事件已上报再到 Admin Events 中Mark as conversion计数方式可选每会话一次线索、注册或每次事件购买转化可导入 Google Ads 用于出价优化。自定义维度与指标Admin Data display Custom definitions 创建作用域分 Event如content_type、User如account_type、Item如product_category参数名必须与事件参数完全一致。受众Admin Data display Audiences典型用例包括高意向访客看过定价页未转化、近 7 天活跃用户3 会话或 5 分钟互动购买者用于排除或相似受众。调试通过 URL 参数?debug_modetrue、Chrome 扩展 GA Debugger 或debug_mode: true配置启用 DebugViewReports Configure DebugView实时报告可查看 30 分钟内的数据。数据质量在 Admin Data streams Configure tag settings 中定义内部流量并排除内网 IP、开发与测试环境跨域追踪需在此列出共享会话的全部域名会话超时默认 30 分钟有效会话时长默认 10 秒。Google Ads 集成Admin Product links Google Ads links 建立关联开启自动标记auto-tagging随后即可导入转化与受众用于再营销、客户匹配与类似受众。九、Google Tag Manager 实现容器、数据层与常用标签9.1 容器三要素组件用途Tags触发时执行的代码GA4、像素Triggers定义标签何时触发页面浏览、点击Variables动态取值点击文本、数据层数据9.2 数据层推送模式dataLayer.push({ event: form_submitted, form_name: contact, form_location: footer });9.3 深度扩充GTM 工程细节GTM 实现参考 将 GTM 落地展开为七个层面标签类型GA4 Configuration基础配置、GA4 Event自定义事件、Google Ads Conversion、Facebook Pixel、LinkedIn Insight Tag、Custom HTML其他像素。触发器内置触发器覆盖 Page ViewAll Pages / DOM Ready / Window Loaded、ClickAll Elements / Just Links、Form Submission、Scroll Depth、Timer、Element Visibility自定义触发器支持 Custom Event来自 dataLayer与 Trigger Groups多条件组合。变量体系内置 Click Text/URL/ID/Classes、Page Path/URL/Hostname、Referrer、Form Element/ID用户自定义支持 Data Layer 变量、JavaScript 变量、查找表Lookup、正则表RegEx、常量。命名规范采用[类型] - [描述] - [细节]三段式例如标签GA4 - Event - Signup Completed、FB - Pixel - Page View触发器Click - CTA Button、Custom - signup_completed变量DL - user_id、JS - Current Timestamp、LT - Campaign Source Map。页面加载数据在 GTM 容器之前把页面级上下文推入 dataLayerpageType、contentGroup、user.loggedIn/userId/userType。表单与按钮事件在 DOM 上监听submit/click后推送form_submitted、cta_clicked及对应参数。电商事件规范每次推送前先执行dataLayer.push({ ecommerce: null })清空旧数据再推送view_item、add_to_cart、purchase含transaction_id、value、currency、tax、shipping、items[]。常见标签配置GA4 Configuration 标签Measurement ID:G-XXXXXXXX、勾选 Send page view、触发器 All Pages、GA4 Event 标签绑定配置标签、事件名用{{DL - event_name}}或硬编码、触发器为 Custom Event 事件名匹配、Facebook Pixel 基础与事件标签Custom HTML fbq(track, Lead, {content_name: {{DL - form_name}}})触发器 Custom Event - form_submitted。预览与调试GTM Preview 模式可逐事件检查已触发/未触发及原因/变量取值/数据层内容常见三类问题——标签不触发查触发器条件、dataLayer 推送、标签排序、变量值错误查数据层结构、嵌套路径、推送时序、重复触发查触发器唯一性、重复标签、触发选项。工作区与版本默认工作区用于生产大型变更开独立工作区完成后合并每个版本必须有描述性名称与变更说明如v15: Added purchase conversion tracking 新增标签/触发器/变量/测试范围清单。同意管理通过 gtag consent 接口设置默认拒绝、按用户选择更新授权或在 GTM Admin 中开启 Consent Overview为每个标签单独配置所需同意类型标签自动遵循同意状态。// Default state (before consent) gtag(consent, default, { analytics_storage: denied, ad_storage: denied }); // Update on consent function grantConsent() { gtag(consent, update, { analytics_storage: granted, ad_storage: granted }); }高级模式标签排序Tag Sequencing如配置标签先于事件标签、像素初始化先于跟踪、触发器异常排除特定页面/内部流量/测试期、自定义 JavaScript 变量从 URL 取campaign参数、读 cookie 中的user_id、从页面 DOM 解析商品价格。十、UTM 参数策略让渠道归因可解释10.1 五个标准参数参数用途示例utm_source流量来源google, newsletterutm_medium营销媒介cpc, email, socialutm_campaign活动名称spring_saleutm_content区分不同版本hero_ctautm_term付费搜索关键词runningshoes10.2 命名约定全部小写统一使用下划线或连字符全站保持一致具体且简洁用blog_footer_cta不要用cta1在电子表格中登记全部 UTM形成可检索的命名字典。评测用例 #2 进一步要求按渠道给出可直接套用的约定sourcegoogle、meta、linkedin、newsletter、mediumcpc、paid-social、email、organic-social并为每个渠道提供具体示例同时预警常见错误大小写不一致、冗余参数、漏填 medium最终输出一份 UTM 追踪表/命名规范文档。十一、调试与验证上线前的最后一公里11.1 三类测试工具工具用途GA4 DebugView实时事件监控GTM Preview Mode发布前测试触发器浏览器扩展Tag Assistant、dataLayer Inspector11.2 验证清单事件在正确触发器上触发属性值正确填充无重复事件跨浏览器与移动端可用转化正确记录无 PII 泄漏11.3 常见问题速查问题排查方向事件不触发触发器配置、GTM 是否加载数值错误变量路径、dataLayer 结构重复事件多个容器、触发器触发两次针对评测用例 #3 描述的GA4 转化数与数据库对不上场景技能要求按框架系统排查重复 GTM 标签触发、缺少事件去重、触发器条件错误、跨域追踪问题、同意模式过滤并逐项排除常见失配原因同意模式、广告拦截器、客户端 vs 服务端追踪、会话超时差异最后用 DebugView、GTM Preview 与浏览器开发者工具交叉定位。十二、隐私与合规GDPR 语境下的埋点红线12.1 合规考虑点欧盟/英国/加拿大等地需要 Cookie 同意分析属性中不得包含 PII配置数据保留期支持用户删除数据的能力。12.2 落地手段使用同意模式Consent Mode在获得同意前等待/拒绝IP 匿名化只采集所需最小数据与同意管理平台CMP集成。评测用例 #5 将合规要求扩展到多工具栈GA4 Hotjar Facebook Pixel每个工具都需在用户同意后才开始追踪配置 CMP为 GA4 开启 Consent Mode按同意层级必需/分析/营销条件化加载 Hotjar 与 Facebook Pixel并在 GTM 中实现基于同意状态的标签触发同时设置 GA4 数据保留期与 Cookie 横幅。十三、输出格式一份可直接交付的 Tracking Plan 文档技能强制规定了交付物的组织方式确保输出可读、可审、可追踪# [Site/Product] Tracking Plan ## Overview - Tools: GA4, GTM - Last updated: [Date] ## Events | Event Name | Description | Properties | Trigger | |------------|-------------|------------|---------| | signup_completed | User completes signup | method, plan | Success page | ## Custom Dimensions | Name | Scope | Parameter | |------|-------|-----------| | user_type | User | user_type | ## Conversions | Conversion | Event | Counting | |------------|-------|----------| | Signup | signup_completed | Once per session |模板要求覆盖四个板块工具与更新时间Overview、完整事件表Events、自定义维度清单Custom Dimensions、转化定义与计数方式Conversions。评测断言Output follows tracking plan format将其作为质量门槛之一。十四、任务引导问题把需求问清楚在信息缺失时技能用六个问题完成需求收敛你在用什么工具GA4、Mixpanel 等你想追踪哪些关键动作这些数据将支撑什么决策由谁实现——开发团队还是市场团队有隐私/同意要求吗目前已埋了什么十五、工具生态与关联技能15.1 常用分析工具矩阵工具最佳场景GA4Web 分析、Google 生态Mixpanel产品分析、事件追踪Amplitude产品分析、群组分析PostHog开源分析、会话回放Segment客户数据平台、数据路由技能对 GA4 标注了 MCP 支持能力上述工具在仓库中均有配套自动化技能可组合使用如 amplitude-automation、segment-cdp、posthog-automation 等可从 catalog.json 检索。15.2 关联技能协同ab-testing实验追踪——评测用例 #6 明确要求当任务本质是A/B 实验度量而非单纯埋点时实验设计、假设与统计检验应交给 ab-testing 技能analytics 技能只负责事件与参数实现部分seo-audit自然流量分析cro转化率优化直接消费本技能产出的数据revops管道指标、CRM 追踪与收入归因。十六、能力边界与使用注意事项仅在任务与上游来源及本地项目上下文明确匹配时启用落地前必须验证命令、生成代码、依赖、凭据及外部服务行为示例不能替代针对具体环境的测试、安全评审或对高成本/破坏性操作的用户审批。评测清单evals.json同时为该技能的能力边界提供了可验证锚点它既负责 GA4/GTM 的完整实现细节事件参数、dataLayer 示例也负责命名约定与输出格式的强制约束但在实验框架设计这类跨技能问题上保持谦逊并正确转介。这正是 analytics 技能在 agentic-awesome-skills 生态中的准确位置埋点方案的设计者、实现者与质检员。赞分享AI 技能AI 插件【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,445 agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址https://gitcode.com/gh_mirrors/an/agentic-awesome-skills点击查看免费下载相关推荐agentic-awesome-skills Analytics 事件库按业务类型构建 GA4/GTM 全链路埋点体系agentic awesome skills Analytics 事件库按业务类型构建 GA4/GTM 全链路埋点体系 事件库Event Library是AI 技能AI 插件GA4 全流程实施指南在 agentic-awesome-skills 中落地数据流、事件埋点、转化与 Google Ads 集成GA4 全流程实施指南在 agentic awesome skills 中落地数据流、事件埋点、转化与 Google Ads 集成 本指南以 agenticAI 技能AI 插件基于 agentic-awesome-skills 的 analytics-product 技能实战从事件埋点到漏斗、Cohort 留存、North Star 与 A/B 检验基于 agentic awesome skills 的 analytics product 技能实战从事件埋点到漏斗、Cohort 留存、North StarAI 技能AI 插件上一篇如何用3条命令备份Hindsight智能体记忆数据完整备份与灾难恢复指南下一篇开源项目推荐Awesome Electronics创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考