📦 Ga4 Data Api — GA4数据查询

技能文档

# GA4 Data API 使用该技能通过 OAuth 用户授权设置并查询 GA4。 ## 默认方法 优先使用 OAuth 用户授权。在常规路径中使用 scripts/install_ga4_openclaw.sh + scripts/ga4_query.py。只有当明确需要无头/服务器端访问时，才建议后续使用 service accounts。 ## 硬性规则 1. 设置前检查账户与权限 - 询问哪个 Google 账户能真正登录 GA 并拥有媒体/账户访问权限。 - 对于企业/内部数据，默认不要一上来就用 service-account 设置。 2. 如实说明阻碍 - 如果用户无法添加用户，就说这是权限阻碍。 - 如果 OAuth 应用仍在测试阶段，就说必须把账户加入测试用户列表。 - 如果用户能看到媒体但缺乏管理员控制，就说这是访问级别问题，而不是假装按钮被隐藏。 ## 设置流程 ### 第 1 步 — 验证访问模型 询问/确认： - 哪个 Google 账户拥有 GA 访问权限？ - 用户能否登录该账户？ - GA4 Property ID 是什么？ - Google Analytics Data API 是否已启用？ - 是否已有 Desktop OAuth 客户端 JSON？ ### 第 2 步 — 安装并接入凭据 运行： ``bash bash ~/.openclaw/workspace/skills/ga4-data-api/scripts/install_ga4_openclaw.sh ` 这会安装 Python 依赖，将 OAuth 客户端 JSON 复制到 ~/.config/openclaw/ga4-client.json，并把 GA4_PROPERTY_ID 写入 shell 配置。 ### 第 3 步 — 首次授权 运行： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics activeUsers,sessions \ --dimensions date \ --start 7daysAgo \ --end today \ --pretty ` 浏览器会打开。用户必须选择 真正拥有 GA 访问权限的同一个 Google 账户。 授权成功后会生成： - ~/.config/openclaw/ga4-token.json ### 第 4 步 — 查询示例 最近趋势： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics activeUsers,sessions \ --dimensions date \ --start 7daysAgo \ --end yesterday \ --pretty ` 国家分布： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics activeUsers \ --dimensions country \ --start 7daysAgo \ --end yesterday \ --limit 50 \ --pretty ` 来源分布： `bash python3 ~/.openclaw/workspace/skills/ga4-data-api/scripts/ga4_query.py \ --metrics sessions \ --dimensions sessionSourceMedium \ --start 7daysAgo \ --end yesterday \ --limit 50 \ --pretty ` ## 分析指导 趋势类问题： - 优先使用整天（end=yesterday），除非用户明确要求当天日内。 - 指出当天下降可能只是部分数据所致。 转化类问题： - 区分 流量事件 与 真正转化事件。 - 如果 key events 范围太宽，建议在得出产品结论前先缩小事件集。 ## 参考资料 - 当用户需要可分享的设置流程时，阅读 references/setup.md。 - 每次查询都用 scripts/ga4_query.py`，而不是手写新的 GA SDK 示例。