GA4 流量数据查询
用 Python 脚本直连 GA4 数据接口,查热门页面、流量来源、落地页、转化和设备分布等指标,支持自定义日期范围和过滤。
功能与用途
要看看网站这周哪些页面浏览量最高、流量从哪些渠道来、转化在哪些活动上,但打开 GA4 后台一层层点很慢,也导不出想要的字段组合。这个 Skill 用脚本直接调 Google Analytics Data API,按指标加维度的方式取数,能查页面路径、来源媒介、落地页、设备、国家,也能按日期范围和路径前缀过滤,结果打印成表格。用之前要在 Google Cloud 建项目、开 Analytics Data API、配 OAuth 客户端并生成 refresh token,一次性配好之后就一直可用。
适用场景
- 热门页面与流量排行:查询指定周期内浏览量最高的页面路径、访客数与会话量,快速评估核心内容与功能页面的热度及访问表现。
- 渠道来源与转化归因:按来源媒介与营销活动聚合会话及转化数据,清晰评估各推广渠道的获客质量与投放回报率。
- 落地页与跳出率分析:调取各落地页的会话规模与跳出率指标,定位用户流失节点,为页面内容调整和转化漏斗优化提供数据支撑。
- 终端设备与地域分布:汇总访客的设备类别、浏览器及所在国家或城市分布,辅助前端界面适配排期与区域化营销决策。
适用人群
- 网站运营分析岗
- 独立站或内容站的增长运营
- 负责线上转化的市场人员
使用步骤
- 先去 Google Cloud 建项目,把 OAuth 同意屏幕设成 Internal,加上 analytics.readonly 权限范围,并启用 Analytics Data API。
- 创建一个桌面应用类型的 OAuth 客户端,拿到 Client ID 和 Client Secret,再用脚本走一遍浏览器登录换出 refresh token。
- 在 GA4 后台的属性设置里找到数字形式的 Property ID。
- 把 GA4_PROPERTY_ID、GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET、GOOGLE_REFRESH_TOKEN 配成环境变量。
- 用脚本按指标加维度的方式查询,需要时带上日期范围或路径过滤,结果表格可以直接看或用 --json 取原始数据。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 商业运营
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- 0.1.1
- 最近更新
- 2026-05-11
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Query Google Analytics 4 (GA4) data directly via the Analytics Data API. Use when you need website analytics like top pages, traffic sources, sessions, users...
使用前准备
- 需要在 Google Cloud 建项目并开启 Analytics Data API、创建 OAuth 客户端、生成 refresh token,并配置 4 个环境变量
- 需要本机有 python3 和浏览器完成一次授权。
依赖与权限
- GOOGLE_CLIENT_SECRET
- GOOGLE_REFRESH_TOKEN
- YOUR_CLIENT_SECRET
- TOKEN
- 读取用户主动提供的内容