GA4 Analytics

# GA4 - Google Analytics 4 Data API

查询 GA4 媒体资源以获取分析数据：页面浏览量、会话、用户、流量来源、转化等。

## 设置（一次性）

1. 启用 Google Analytics Data API：https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com 2. 创建 OAuth 凭据或使用现有的 Google Cloud 项目 3. 设置环境变量： - `GA4_PROPERTY_ID` - 您的 GA4 媒体资源 ID（数字，例如 "123456789"） - `GOOGLE_CLIENT_ID` - OAuth 客户端 ID - `GOOGLE_CLIENT_SECRET` - OAuth 客户端密钥 - `GOOGLE_REFRESH_TOKEN` - OAuth 刷新令牌（来自初始身份验证流程）

## 常见查询

### 热门页面（按页面浏览量） ```bash python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --limit 30 ```

### 带有会话数和用户数的热门页面 ```bash python3 scripts/ga4_query.py --metrics screenPageViews,sessions,totalUsers --dimension pagePath --limit 20 ```

### 流量来源 ```bash python3 scripts/ga4_query.py --metric sessions --dimension sessionSource --limit 20 ```

### 落地页 ```bash python3 scripts/ga4_query.py --metric sessions --dimension landingPage --limit 30 ```

### 自定义日期范围 ```bash python3 scripts/ga4_query.py --metric sessions --dimension pagePath --start 2026-01-01 --end 2026-01-15 ```

### 按页面路径筛选 ```bash python3 scripts/ga4_query.py --metric screenPageViews --dimension pagePath --filter "pagePath=~/blog/" ```

## 可用的指标 (Metrics)

常用指标：`screenPageViews`、`sessions`、`totalUsers`、`newUsers`、`activeUsers`、`bounceRate`、`averageSessionDuration`、`conversions`、`eventCount`

## 可用的维度 (Dimensions)

常用维度：`pagePath`、`pageTitle`、`landingPage`、`sessionSource`、`sessionMedium`、`sessionCampaignName`、`country`、`city`、`deviceCategory`、`browser`、`date`

## 输出格式

默认：表格格式 添加 `--json` 以获取 JSON 输出 添加 `--csv` 以获取 CSV 输出