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 或最终回答。
查询规则
- 请求体使用 GA4 Data API
runReportJSON。 - Property 由服务端固定,不在请求中传入。
- 用户漏斗优先使用
totalUsers,事件埋点诊断才使用eventCount。 - 当天数据标记为未完整,并说明 Property 时区。
- CVR =
transactions / sessions。 - AOV =
purchaseRevenue / transactions。 - Revenue per Session =
purchaseRevenue / sessions。 - 维度行中的用户可能重复,不把行级 Users 相加当作全站唯一用户数。
- 样本量过小时标记“需观察”,不得给出强结论。
详细查询字段和示例见 references/query-guide.md。
输出要求
- 使用中文,先给结论,再给表格,最后给行动建议。
- 明确日期、时区、货币、维度、指标和过滤条件。
- 区分确认事实、可能原因和待确认信息。
- 行级结果优先使用 Markdown 表格或 TSV。
- 不编造接口没有返回的指标。