# Ga4 Reader Workbuddy

> 通过团队 GA4 Reader API 读取并分析网站流量、渠道、落地页、电商漏斗、收入、Campaign、设备和 Google Ads 导入费用。用于 WorkBuddy 中的只读 GA4 查询与转化诊断，不用于修改 GA4、Google Ads、GTM 或网站。

- Skill: `the-alexliu/ga4-reader-workbuddy` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add the-alexliu/ga4-reader-workbuddy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/the-alexliu/ga4-reader-workbuddy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Marketing & Growth
- Author: The-AlexLiu (https://skillmd.com/u/the-alexliu)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/the-alexliu/ga4-reader-workbuddy

---


# GA4 Reader for WorkBuddy

通过团队 Reader API 只读查询 GA4。首次使用时读取 [references/first-use.md](references/first-use.md)。

## 连接检查

运行：

```bash
python3 scripts/ga4_reader.py --health
```

查询前确认 `~/.workbuddy/secrets/ga4-reader.json` 已配置。只检查文件是否存在，不得打印 Token。若缺失，立即停止并引导用户运行配置脚本。不要安装 `gcloud`、Google SDK 或 MCP，不要发起 OAuth 或浏览器登录。

## 查询

将 GA4 Data API `runReport` 请求保存为 JSON，然后运行：

```bash
python3 scripts/ga4_reader.py --request /path/to/request.json
```

查询口径和输出要求见 [references/query-guide.md](references/query-guide.md)。Property 由服务端固定，不得在请求中覆盖。

## 输出

- 使用中文，先给结论，再给数据表和行动建议。
- 明确日期范围、时区、货币、维度、指标和过滤条件。
- 用户漏斗优先使用 `totalUsers`；事件诊断才使用 `eventCount`。
- CVR = transactions / sessions；AOV = purchaseRevenue / transactions。
- 不打印 API URL 配置中的 Token，不编造缺失数据。