核心用法
该技能通过 ClawLink 托管的 OAuth 流程，将 OpenClaw 聊天环境无缝接入 Google Analytics 4 (GA4) Data API。用户无需自行申请 API 密钥或处理复杂的认证配置，只需三步即可完成账户配对：安装插件 → 配对设备 → 连接 Google Analytics。
安装后，用户可通过自然语言指令调用 30+ 种工具，覆盖三大核心场景：
1. 账户与资产发现：列出可访问的 GA4 账户、属性、数据流和受众群体，快速定位目标数据源。
2. 数据查询与报告：运行标准报告（支持自定义维度、指标、日期范围）、实时报告（近 30-60 分钟数据）、透视表报告及漏斗分析。所有查询自动处理 OAuth 令牌注入，无需手动管理凭证。
3. 元数据与配置管理：检查维度/指标兼容性（避免 GA4 严格的组合限制）、查看数据保留设置、归因模型、自定义维度/指标等配置信息。
典型交互流程为：用户描述需求 → 助手确认连接状态 → 列出可用属性 → 运行报告 → 可视化呈现关键指标（会话数、用户数、跳出率、收入等）。
显著优点
- 零配置接入：ClawLink 托管 OAuth 流程，消除传统 API 集成的密钥管理、权限范围配置和令牌刷新负担。
- 实时与历史数据兼备：同时支持标准历史报告和近实时数据监控，满足运营监控与深度分析双重需求。
- 智能兼容性检查：内置
check_compatibility工具，主动规避 GA4 API 严格的维度/指标组合限制，减少调用失败率。 - 安全分级执行：读操作（报告、列表查询）可直接执行；写操作（创建受众列表、自定义维度、关键事件）强制要求用户显式确认，符合最小权限原则。
- 透明化错误处理：针对常见错误（403 权限不足、400 参数无效、连接丢失）提供结构化排查指引，降低故障诊断成本。
潜在缺点与局限性
- 依赖 ClawLink 基础设施：认证与代理服务由第三方托管，若 ClawLink 服务不可用，整个技能将中断。存在单点依赖风险。
- OAuth 权限边界：实际可访问的数据严格受限于用户 Google 账户的 GA4 权限。无法跨账户访问无权限的数据，也无法提升权限。
- 实时数据覆盖有限：实时报告仅支持近 30-60 分钟数据，且部分自定义维度不可用，不适合长期趋势分析。
- 写操作需人工介入：创建关键事件、更新属性设置等操作必须用户确认，虽提升安全性，但自动化场景受限。
- 学习曲线：GA4 的维度/指标命名（如
sessionCampaignName、userAgeBracket）及 API 格式（properties/123456789）对用户有一定认知门槛。
适合人群
- 数字营销团队：需快速获取流量来源、转化路径、受众画像数据，用于日常监控与周报生成。
- 数据分析师：需要程序化查询 GA4 数据，结合其他数据源做交叉分析，避免手动导出 CSV。
- 产品运营人员：关注实时活跃用户、关键事件触发情况，用于活动效果监控与即时决策。
- 中小企业主：无专职技术团队，希望以对话方式获取网站/应用表现洞察。
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据隐私泄露 | GA4 数据包含用户行为、地理位置、收入等敏感信息 | ClawLink 仅代理请求，不存储报告数据；确保在 HTTPS 环境下使用 |
| 误操作风险 | 写操作可能影响关键事件定义或受众配置 | 强制用户确认机制；建议先在测试属性验证 |
| 服务可用性 | ClawLink 托管服务故障将导致技能不可用 | 定期验证连接状态；关注 ClawLink 状态页面 |
| 权限误配 | 用户可能无意中授权过多或过少范围 | 定期审计 OAuth 授权；按需最小化权限范围 |
| API 配额耗尽 | GA4 Data API 有每日调用限额 | 使用 `get_property_quotas_snapshot` 监控用量；批量查询减少调用次数 |