Supermetrics营销数据查询

技能简介

Supermetrics是官方提供的营销数据查询技能，可对接Google Analytics、Meta Ads、Google Ads、LinkedIn等100多个营销平台，统一获取广告效果、流量分析、转化追踪等核心指标。

能做什么

• 浏览全部可用的数据源平台列表
• 查看已授权账号及其权限范围
• 获取各平台支持的指标与维度字段
• 执行异步数据查询并提取结果
• 按日期范围、过滤条件筛选数据
• 检索Supermetrics资源文档与建议
• 检测服务端健康状态

使用说明

安装与配置

本技能需预先配置环境变量：

SUPERMETRICS_API_KEY=你的API密钥

获取方式：访问Supermetrics官网注册账号并申请API访问权限。

基础调用

from supermetrics import discover_sources, discover_accounts, query_data, get_results

# 查看可用平台
sources = discover_sources()

# 获取Google Analytics账号
accounts = discover_accounts("GAWA")

# 查询最近7天数据
query = query_data(
    ds_id="GAWA",
    ds_accounts="123456789",
    fields=["date", "sessions", "users"],
    date_range_type="last_7_days"
)
results = get_results(query['data']['schedule_id'])

常用数据源代码：FA（Meta Ads）、AW（Google Ads）、GAWA（Google Analytics）、GA4（Google Analytics 4）、LI（LinkedIn Ads）、AC（Microsoft Advertising）。

输入与输出

见下方输入与输出表格。

风险提示

• API调用按量计费，频繁查询可能产生额外费用
• 账号授权过期后需重新绑定数据源
• 大数据量查询采用异步机制，需轮询获取结果
• 自定义日期范围格式必须为YYYY-MM-DD
• 过滤器语法错误将返回空数据集而非报错

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/bartschneider/supermetrics-openclawd/SKILL.md
来源类型：GitHub仓库