用途：该技能面向已配置账号可访问的 GA4 媒体资源，提供实用型报告与快速分析，例如查看近 7/30/90 天流量、与上一周期对比、审查来源/媒介表现、诊断内容互动、比较设备表现，以及导出表或 JSON 结果。
主要能力：涵盖 overview、sources、content、devices 四类分析；ga_client.py 支持自定义指标与维度，输出 table 或 json。当前不提供归因建模、漏斗探索、群组或留存分析、高级事件调试及完整营销审计。
使用方式：先准备凭据，将 .env.example 复制为 .env，设置 GOOGLE_SERVICE_ACCOUNT_CREDENTIALS 与 GOOGLE_ANALYTICS_PROPERTY_ID；服务账号需启用 Google Analytics Data API 并被授予该 GA4 媒体资源读取权限。安装依赖： python -m venv google-analytics/.venv google-analytics/.venv/Scripts/python -m ensurepip --upgrade google-analytics/.venv/Scripts/python -m pip install -r google-analytics/requirements.txt
运行基线报告： google-analytics/.venv/Scripts/python google-analytics/scripts/ga_client.py --env-file .env --days 30 --metrics sessions,activeUsers,bounceRate
来源/媒介分析： google-analytics/.venv/Scripts/python google-analytics/scripts/analyze.py --env-file .env --analysis-type sources --days 30
内容互动诊断： google-analytics/.venv/Scripts/python google-analytics/scripts/analyze.py --env-file .env --analysis-type content --days 30
周期对比： google-analytics/.venv/Scripts/python google-analytics/scripts/analyze.py --env-file .env --analysis-type overview --days 30 --compare
适用场景：GA4 流量概览、来源/媒介表现、内容互动质量、设备表现比较，或需要自定义指标维度报告时使用 ga_client.py。
限制：凭据从本地 .env 与本地文件路径加载，直连 Google SDK，不依赖第三方 OAuth 代理；不要提交服务账号 JSON 或密钥。analyze.py 属于启发式快速诊断，不是完整归因分析。使用多个 .env 时应显式传入 --env-file。其他未在资料中明确说明的功能、收费或价格暂未提供。