SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场google-analytics

google-analytics

数据与分析

查看项目

更新于 11-03 17:17

技能介绍

用途

该技能面向 Google Analytics 4（GA4）数据查询与报告生成。用户可以用自然语言提出流量、页面、用户、事件、行为指标、自然搜索落地页质量、电商收入、渠道组合以及 SEO 实验跟进等问题，技能将其映射为相应的 GA4 查询工作流。

其增长分析原则是不要只把 GA4 当作静态报表看板，而要把获客来源、落地页、互动、转化或收入、SEO 行动与学习串联起来。做 SEO 时建议同时结合 Google Search Console：GSC 提供查询词、展示、点击、CTR 与排名，GA4 提供会话、互动、转化与收入。若转化、收入、电商事件或维度缺失，应明确说明，不得编造。

前置条件与配置

使用前需确认 MCP 服务器可用，检查是否存在 runReport、getPageViews、getActiveUsers、getEvents、getUserBehavior 等工具。若不可用，需引导用户完成配置：

  1. 在项目根目录创建或编辑 .mcp.json，配置 mcp-server-google-analytics，通过 npx -y mcp-server-google-analytics 启动，并设置环境变量 GOOGLE_CLIENT_EMAIL、GOOGLE_PRIVATE_KEY、GA_PROPERTY_ID。
  2. 凭据准备：在 Google Cloud Console 创建或选择项目，启用 Analytics Data API；创建服务账号并生成 JSON 密钥；从 JSON 中提取 client_email 与 private_key；在 GA4 的媒体资源访问管理中将服务账号邮箱添加为查看者；在 GA4 属性设置中复制纯数字属性 ID。
  3. 验证：重启 Claude Code 后，用“显示最近 7 天的活跃用户”之类的问题测试。

就绪状态按顺序包括：missing_credentials → credentials_present → service_account_valid → property_access_missing/property_id_invalid → first_query_passed → production_ready。查询失败时应报告所处状态与下一步修复。MCP 适合本地或手动分析；生产客户端代理、定时报告、类型化输出、重试、配额处理与多客户隔离更适合直接调用 GA4 Data API 脚本。

主要工作流

技能先解析请求并确定日期范围。未指定时默认最近 28 天；“本月”为当月首日至今天；“上周”为 7 天前至昨天；“最近 30 天”为 30daysAgo 至 today；“最近 3 个月”为 90daysAgo 至 today。

  • 流量总览：以 date 为维度，查询 activeUsers、sessions、screenPageViews、bounceRate，给出汇总与趋势表并标注异常波动。
  • 热门页面：按 pagePath（可加 pageTitle）查询页面浏览量、活跃用户与跳出率，默认展示前 10。
  • 受众分析：按 country、deviceCategory、browser 或 sessionSource/sessionMedium 维度分析用户、会话与浏览量。
  • 事件跟踪：按事件名或全部事件统计事件次数，区分标准事件与自定义事件。
  • 用户行为：汇总互动、跳出率、会话时长等质量指标，可对比上一周期。
  • 转化断点检测：对指定文章页查询最近 28 天 sessions 与 eventCount，若会话 ≥80 且主转化事件为 0，则标记为需检查 CTA 而非内容；常见原因包括 CTA 样式失效不可见、CTA 商品与文章受众不匹配、CTA 全部堆在文末、文案与文章承诺不一致。建议拉取文章 HTML，结合标题上下文与滚动位置解析 CTA，提出修复并 28 天后复测。
  • 自然搜索落地页 / SEO 增长：按 landingPagePlusQueryString 与 sessionDefaultChannelGroup 查询会话、活跃用户、互动会话、转化与总收入，筛出 Organic Search，识别高流量无转化、高转化低流量及环比衰减页面。
  • 电商 / 自然搜索收入：分析落地页与渠道分组下的会话、转化、总收入与事件数，仅在收入或转化指标存在时报告每会话收入与转化率。
  • GSC + GA4 机会关联：按规范化页面路径连接 GSC 页面 URL 与 GA4 落地页，优先关注高展示低 CTR 但有转化的页面、高点击但互动弱的页面、低点击但转化价值高的页面。
  • 定时监控与实验跟进：用于日常自然流量哨兵、每周落地页复盘、转化质量检查、电商收入报告，以及 7/14/28/60/90 天的实验跟进。

输出与后续

报告模板包括标题（报告类型与日期范围）、关键发现、报告专属数据表、建议与备注（数据源、属性 ID、日期范围）。用户可要求按设备下钻、与上月对比、仅看自然流量、与 GSC 连接或导出 CSV。

常见问题与限制

日期使用 YYYY-MM-DD 或 7daysAgo 等相对字符串；属性 ID 仅用数字，不带 properties/ 前缀。维度与指标组合不一定兼容，失败时可简化。注意 GA4 Data API 配额、抽样、媒体资源时区、低流量人群维度被隐私阈值抑制、GA4 与 GSC 归因模型差异、总收入为零可能是未配置电商而非无价值、转化定义取决于关键事件设置。切勿提交真实 .mcp.json、服务账号 JSON、.env 或私钥。

该技能只查询 GA4 中已有的数据；新属性历史数据可能有限；查询的是已处理数据而非实时数据，通常有 24–48 小时延迟；自定义维度需知道准确 API 名称；免费属性详细数据保留 2 或 14 个月；技能为只读，不能创建目标、修改属性设置或配置跟踪。