官方 Supermetrics 数据集成工具，支持 100+ 营销平台（Google Analytics、Meta Ads、Google Ads 等）的数据查询与报表生成，需 API 密钥授权。
说明：
# Supermetrics 营销数据 Skill 深度评估
## 核心功能与用法
Supermetrics Skill 是官方提供的营销数据查询工具，核心能力在于**统一接入 100+ 主流营销平台**的数据接口，包括 Google Analytics 4、Meta Ads（Facebook）、Google Ads、LinkedIn Ads、Microsoft Advertising（Bing）等。其设计遵循典型的数据探索-查询-获取工作流：
1. **数据源发现** (`discover_sources`)：枚举所有可用平台
2. **账户发现** (`discover_accounts`)：获取已授权的账户列表
3. **字段发现** (`discover_fields`)：查询可用的指标（metrics）与维度（dimensions）
4. **数据查询** (`query_data`)：提交异步查询请求，返回 `schedule_id`
5. **结果获取** (`get_results`)：通过 `schedule_id` 拉取实际数据
参数设计体现专业级灵活性：支持相对日期（`last_7_days`、`last_30_days`）与绝对日期范围，提供丰富的过滤操作符（`==`、`!=`、`=@` 包含匹配、`=~` 正则匹配），并支持 IANA 时区指定。
## 显著优点
– **平台覆盖广度**：一站式解决多平台数据孤岛问题，避免重复对接各家 API
– **官方维护**：由 Supermetrics 官方提供，接口稳定性与数据准确性有保障
– **异步查询架构**：复杂查询通过 `schedule_id` 解耦提交与获取，适合大数据量场景
– **响应格式统一**：所有函数返回 `{“success”: True/False, “data”/”error”: …}` 结构，便于错误处理
– **搜索辅助**：`search()` 函数提供资源检索能力，降低字段记忆成本
## 局限性与风险
– **API 密钥依赖**：必须配置 `SUPERMETRICS_API_KEY` 环境变量，密钥泄露将导致数据访问权限丢失
– **异步复杂度**：需自行管理 `schedule_id` 状态，简单场景下增加代码负担
– **平台授权前置**：使用前需在 Supermetrics 平台完成各数据源的 OAuth 授权，非”开箱即用”
– **成本不透明**：Supermetrics 为商业 SaaS，API 调用可能产生额外订阅费用，需关注用量配额
– **数据延迟**：部分平台数据存在 24-48 小时延迟，非实时流式数据
## 适用人群
– **营销分析师**：需要跨平台整合广告投放数据、计算 ROI
– **数据工程师**：构建营销数据仓库（ELT 流程中的 Extract 层）
– **增长团队**：自动化周报/日报生成，监控核心指标趋势
– **中小企业主**：低成本替代自建 API 对接，快速获取多平台报表
## 常规风险提示
– **密钥管理**：`SUPERMETRICS_API_KEY` 应存储于安全环境变量或密钥管理系统，禁止硬编码
– **速率限制**：批量查询时注意平台级 API 配额，建议实现指数退避重试
– **数据隐私**：涉及用户行为数据时，需确保符合 GDPR/CCPA 等合规要求
– **过期监控**：OAuth 授权可能过期，需建立账户健康检查机制（`health()` 函数可辅助）
会员专属
