Agent Skills
返回列表
Google GA4 数据分析

Google GA4 数据分析

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md 的说明,将 @yahuixun/cloudplus-google-analytics 安装到你的 AI 助手中。

技能介绍

要解决什么问题

团队在 GA4 上做只读分析时,往往要在 Data API、属性 ID、维度指标组合和实时报表之间来回切换;若把服务账号或 OAuth JSON 写进本地 .env 或对话里,还会带来凭证泄露风险。本技能面向流量、获客、互动、留存、转化以及事件参数、自定义维度/指标等常见问数场景,用统一工作流把「查哪个属性、用什么报表、实时还是历史」说清楚。

技能如何工作

运行时优先走项目里的 Google Analytics MCP(详见 docs/GOOGLE_ANALYTICS_MCP.md):在可用时不要求用户本地配置 Google ADC,MCP 通常通过 SSH stdio 在云端 Docker Runner 上执行。典型步骤:

  1. 确认 MCP 客户端里 analytics 服务可用;属性不明时先调 get_account_summaries。
  2. 元数据用 get_property_details、list_google_ads_links、get_custom_dimensions_and_metrics。
  3. 历史报表需明确 property id、日期范围、metrics、dimensions、filters/comparisons;实时问题用 run_realtime_report,不要用历史报表工具。
  4. 用户缺省且风险较低时:趋势类默认近 28 天、按主指标降序、结果集保持可解释规模;结论里写明所用默认值。

输出偏决策向摘要:先给主要发现,必要时用紧凑表格对比页面路径、事件名、渠道等,并标明指标是 users、sessions、事件次数还是转化/收入;不夸大因果,对稀疏数据、采样阈值、无权限属性等要显式说明。

适用边界与注意

  • 适合:GA Data API 能回答的漏斗/路径类问题、事件热度、Ads 关联发现、账号/属性探查。
  • 不适合:修改 GA4 配置;在聊天或源码中写入凭证;未覆盖工具下的 Search Console 等非 GA SEO 检查。
  • 凭证:不请求、不暴露 credential JSON;不把 ADC/服务账号/OAuth 文件提交进仓库;敏感部署信息(SSH 别名、主机名、路径、property ID)在用户未主动披露前按部署机密处理。

使用场景

  • 活动复盘前,需要在对话里按渠道对比某 GA4 属性近 28 天的会话、转化或留存,并输出可决策的表格摘要。
  • 产品迭代后,要统计指定 property 下热门事件、事件参数或自定义维度/指标,且不能改动 GA4 后台配置。
  • 接入多个 GA 账号时,先探查 account/property 列表,再拉 property 详情或 Google Ads 关联,避免猜错 property id。
  • 线上突发流量波动时,需要回答当前实时活跃用户数或实时维度分布,应使用实时报表而非历史 Data API 报告。

适合人员

  • 负责 GA4 周报/活动复盘、需在 IDE 里直接拉流量与获客报表且不愿本地存放服务账号密钥的增长或运营分析同学。
  • 维护多 property 的数据分析师,典型诉求是先枚举账号摘要再按日期范围、维度指标组合出历史报表结论。
  • 对接项目云端 MCP Runner(SSH stdio)的运维或合作伙伴工程师,需确保 analytics-mcp 可用并指导同事安全问数。
  • 用自定义事件与维度衡量漏斗转化、只读查数且严禁在聊天或仓库中写入 OAuth/ADC 文件的产品或数据 PM。