SuperAPI AI 工具集

ads-audit

营销与增长

查看项目

更新于 10-16 07:23

技能介绍

用途:对 Google Ads 账户做只读健康审计,并保存业务背景与人群画像,作为其他广告技能的输入。不会改动账户,修复操作交给 /ads 执行。

主要能力:按 7 个维度 0–5 分打分,整体分=round(sum×100/35);覆盖账户指标、广告系列、广告组、关键词质量分、搜索词、否定关键词、转化操作、广告素材、地理定位与近期变更事件。内置启发式规则:按花费而非关键词数量加权质量分、检测品牌词泄漏、识别浪费(点击数>10 且转化=0 且有花费)、Display 与 Search 混投、僵尸关键词(30 天 0 曝光)、转化计数类型、展示份额矩阵,以及转化跟踪 0–1 分时的停止条件(先暂停花费修跟踪)。

使用方式:先做 setup 与 MCP 检测、API key、账户选择;先跑政策新鲜度检查(读 policy-registry.json,对过期条目做 WebSearch 比对)。用一次 runScript 调 ads.gaqlParallel 并行拉取审计数据集,脚本内做聚合返回摘要 JSON。窗口上限 90 天(受展示份额数据限制)。可将 getRecommendations 作为 Google 建议的交叉验证。用 /ads 执行推荐修复。

文件契约(必须持久化):业务上下文写入 {data_dir}/business-context.json,人群画像写入 {data_dir}/personas/{accountId}.json,二者是所有广告技能的交接物,即使报告很短也要写。

范围与限制:用户可缩小审计范围,按广告系列名不区分大小写子串匹配,先在内存中过滤再打分;账户级维度仍全账户评估。若 totalSpend==0 或 activeCampaigns==0,跳过打分直接进入业务背景阶段。关键查询出错时直接暴露错误并停止,不做降级审计。报告约 80 行内,先给结论、前三项行动、记分卡,只对 0–2 分维度展开证据。每个发现都需点名具体广告系列、关键词、搜索词与金额。

其他:人群画像需基于 5 个以上真实搜索词,否则丢弃;每个发现引用具体对象。审计历史保存至账户,可在 https://adsagent.org 查看。