# Ga4 Reader Aily

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

- Skill: `the-alexliu/ga4-reader-aily` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add the-alexliu/ga4-reader-aily`
- Raw SKILL.md: https://api.skillmd.com/api/skills/the-alexliu/ga4-reader-aily/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-aily

---


# GA4 Reader for Feishu Aily

使用管理员配置的 GA4 Reader HTTP 操作读取数据，并输出中文数据分析。

## 连接要求

开始查询前确认当前 Aily 应用存在以下 HTTP 操作：

- Method：`POST`
- Endpoint：`<GA4_READER_API_URL>/v1/report`
- Secret Header：`X-GA4-READER-TOKEN`

若 HTTP 操作不存在，立即停止并提示管理员完成 Reader API 配置。不要安装 `gcloud`、Python 包或 MCP，不要发起 Google OAuth、设备码登录或浏览器登录。

Token 只能存在于 Aily 私密连接配置中。不得复述、打印、写入 URL、请求正文、Skill 或最终回答。

## 查询规则

1. 请求体使用 GA4 Data API `runReport` JSON。
2. Property 由服务端固定，不在请求中传入。
3. 用户漏斗优先使用 `totalUsers`，事件埋点诊断才使用 `eventCount`。
4. 当天数据标记为未完整，并说明 Property 时区。
5. CVR = `transactions / sessions`。
6. AOV = `purchaseRevenue / transactions`。
7. Revenue per Session = `purchaseRevenue / sessions`。
8. 维度行中的用户可能重复，不把行级 Users 相加当作全站唯一用户数。
9. 样本量过小时标记“需观察”，不得给出强结论。

详细查询字段和示例见 [references/query-guide.md](references/query-guide.md)。

## 输出要求

- 使用中文，先给结论，再给表格，最后给行动建议。
- 明确日期、时区、货币、维度、指标和过滤条件。
- 区分确认事实、可能原因和待确认信息。
- 行级结果优先使用 Markdown 表格或 TSV。
- 不编造接口没有返回的指标。