G
GravityAds
AI Agent 广告智能

GravityAds Ads MCP / API

面向 AI agent、广告优化师、agency 和技术团队的广告智能入口。

受控操作工作流

分析

AI agent 读取广告数据

建议

生成优化建议

审核

人工审核变更草稿

批准

团队成员批准执行

执行

受控执行变更

适用人群

不只面向开发者

广告优化师

通过 AI agent 查询跨平台广告表现,无需手写查询即可获得 campaign 维度洞察。

  • 自然语言广告查询
  • Campaign 表现摘要
  • 预算分配建议

不只面向开发者

入门层叫 Essentials,是为了避免让广告优化师、agency 账号经理和媒体负责人误以为自己不是目标用户。

受控操作

连接广告智能、审批和工具访问,但不把商业官网变成 developer portal。

Portal 保持技术定位

API key、文档、MCP setup 和 console 仍然留在 portal.gravityads.dev。

从一个账户的只读核对开始

读取已结束日期,查看缺失数据,再次打开原任务。首次体验不修改广告、预算或投放状态。

  1. 真实数据接入前,确认有权操作者、账户、客户端、体验安排、数据用途与保存,以及实际支持联系人。
  2. 在Portal登录自己的组织,按约定流程授权并选择账户,再使用所选客户端的原生远程MCP设置。
  3. 先发现客户端实际工具,再用gravityads.metrics.summary和source_policy=warehouse_only读取约定账户与日期。没有已存数据就说明缺口,不触发实时采集。

文字工具与交互App分别验收。对话中的只读要求不会降低凭据权限;key仅输入客户端私密设置,不放进共享文件或截图。

首次读取

只读取我已选择且获准的这个账户,使用约定的已结束日期,设置source_policy=warehouse_only。先给来源账户时区、币种及覆盖/缺失日期,再列可用指标。不调用广告API、不建定时任务、不改广告、不补缺失值;新采集或保存任务状态前先说明。
查看配置与请求示例

均为占位示例;账户和日期只替换为约定范围,不注入其他tenant或operator。

{
  "mcpServers": {
    "gravityads": {
      "url": "https://mcp.gravityads.dev/mcp",
      "headers": {
        "Authorization": "Bearer REPLACE_IN_PRIVATE_CLIENT_SETTINGS_ONLY"
      }
    }
  }
}
{
  "name": "gravityads.metrics.summary",
  "arguments": {
    "platform": "google",
    "account_id": "REPLACE_WITH_AUTHORIZED_ACCOUNT_ID",
    "start_date": "2026-01-01",
    "end_date": "2026-01-03",
    "days": 3,
    "granularity": "account",
    "source_policy": "warehouse_only"
  }
}
下载接入指南与示例

中文与English · ZIP

缺一天数据,不等于当天花费为零

合成示例,不是客户案例或广告平台官方导出。

请求3天,实际覆盖2天。来源自然日:Asia/Hong_Kong;币种:USD;没有重新分桶为UTC。

合成花费示例:两天分别观察到$40、$60,第三天标为缺失而不是零。
合成示例,不是客户案例或广告平台官方导出。
日期合成参考花费已观察花费已观察点击
2026-01-01$40$4020
2026-01-02$60$6030
2026-01-03$50缺失缺失

有记录的两天小计$100、50次点击。实际三天总计仍未知,完整期间对账未通过。

采取行动前,先核对报告

阅读全文

文中算例为合成数据,不是客户案例,也不证明广告效果提升。

报告中的数字正确,不代表回答了正确的问题。两天花费准确,不等于三天覆盖完整;账户自然日不一定等于UTC日;广告平台的转化价值,也不直接等于店铺收到的收入或利润。

用AI助手核对广告账户时,先看范围、覆盖和独立对照来源,再考虑建议是否可用。第一步应当是一份能解释、能重新打开的结果,而不只是一段听起来合理的优化意见。

先把问题限定清楚

明确一个获准账户、平台、已经结束的日期范围和币种,保留来源账户时区,以及平台归因和筛选设置。口径未知时应当直接说明,不能为了让两份结果看起来可比,自动补上未经确认的默认值。

首次任务可以很小:读取一个账户,列出可用指标,解释缺失。读取报告不等于授权改广告、预算或投放状态;创建保存任务也与广告写入不同,需要说明保存的状态。

小计不是完整期间总计

假设一个合成账户以USD、Asia/Hong_Kong自然日记账。请求1月1日至3日:参考表花费分别为$40、$60、$50,观察结果只有前两天,第三天没有记录。

此时可以说“有记录的两天花费小计$100”,不能说“三天总花费$100”。更不能把第三天补成$0,再判断账户停止投放。参考三天$150与已观察两天$100不是相同覆盖范围的期间指标。

在计算涨跌、CPA或ROAS之前,这个区别尤其重要。缺一天数据或缺少分母,可能生成外观完整、实际不支持结论的比率。保留缺失值,标明partial,指出下一步要核什么。本包算例把三天记录逐行展示,缺口没有藏在摘要后。

用独立来源核对

使用广告平台独立导出或后台结果,与相同账户、日期、时区、币种、归因和筛选的报告逐指标比较。记录差异、缺失与采用的容差;总数接近不能证明每天记录都相同。

同一个仓库换一个界面读取,可用于检查展示一致性,但不是独立平台对账。页面只显示几条预览,也不表示底层来源已经完整取齐;长证据通过原结果的正常分页或导出路径核查。

平台转化价值保留原标签;要称店铺收入、回款或利润,需要额外证据。也不要为了图表整齐,直接合并不同币种或把来源自然日重标为UTC。

恢复时沿用原结果

回答中断后,先重新打开同一保存任务和报告,核状态与已有证据,不要立刻创建一个替代任务。否则旧结果、新采集和重复操作很难区分。

明确只读已存数据时,对支持该参数的工具使用 source_policy=warehouse_only。缺数据就报告缺口,不自动回退实时广告查询;需要新采集时,另行说清账户和操作范围。对话文本既不会增加账户权限,也不能降低凭据本来拥有的权限。

分清停止访问与处置数据

产品断开、广告平台授权撤销、已存数据处置是三个动作。分别核对哪些新读取或采集已停止、哪些内容还保留,以及处置申请如何跟踪。申请提交不等于拿到了删除完成回执。

一次有用的首次体验应交付清楚的结果:哪些数值得到核对,哪些仍缺失,如何重新打开原报告,以及如何停止访问。之后再做一个用户真正需要的独立任务,判断它是否值得重复使用。

GravityAds MCP初期辅助只读范围按这一思路开展:读取已结束日期的账户指标,并返回已保存工作。平台、客户端和数据子范围按具体体验确认;文字工具与交互App界面分别验收,SDK成功不能外推所有客户端。完整自动巡检、广告写入与利润归因,不由一次账户指标读取自动放行。

下载教程

恢复时打开原任务和报告,不重建、不重新采集。产品断开、平台侧撤销与已存数据处置分别记录;申请提交不表示删除完成。

排障通过约定支持联系人提供时间、客户端版本、原任务引用及安全错误码;不要发送密码、key、Authorization请求头或原始客户导出。

准备好让 AI agent 管理广告了吗?

也可以看看True ROAS,Shopify 店铺的真实广告利润分析