GA4数据查询

技能简介

该技能通过Google Analytics Data API连接GA4资产，提取页面浏览量、会话数、用户数、流量来源、转化事件等核心指标。支持自定义日期范围、多维度筛选及多种输出格式。

能做什么

• 查询热门页面排行（按浏览量、会话数或用户数）
• 分析流量来源分布（搜索引擎、社交媒体、直接访问等）
• 追踪落地页表现与转化路径
• 导出指定时间段的自定义报表（JSON/CSV/表格）
• 按设备类型、地理位置、浏览器等维度细分数据

使用说明

前置配置（一次性）

1. 在Google Cloud控制台启用Analytics Data API
2. 创建OAuth 2.0凭证或复用现有项目
3. 配置以下环境变量：
   GA4_PROPERTY_ID（数字格式属性ID）
   GOOGLE_CLIENT_ID
   GOOGLE_CLIENT_SECRET
   GOOGLE_REFRESH_TOKEN

常用命令示例

查看TOP30页面：

python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --limit 30

带多指标的页面分析：

python3 scripts/ga4_query.py --metrics screenPageViews,sessions,totalUsers --dimension pagePath --limit 20

流量来源统计：

python3 scripts/ga4_query.py --metric sessions --dimension sessionSource --limit 20

指定日期范围：

python3 scripts/ga4_query.py --metric sessions --dimension pagePath --start 2026-01-01 --end 2026-01-15

路径过滤：

python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --filter "pagePath=~/blog/"

输出格式切换：追加--json或--csv参数

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管OAuth凭证，避免硬编码提交至代码仓库
• API存在每日配额限制，高频查询可能触发限流
• refresh_token长期有效，泄露将导致数据访问权限失控
• 日期范围过大可能返回超时错误，建议分批获取

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jdrhyne/ga4/SKILL.md
来源类型：GitHub开源技能库