首页 AI Claude 用 GAQL 自动生成 Google Ads 报表与异常诊断(2026):展示份额、搜索词、预算花不满一次查清

Claude 用 GAQL 自动生成 Google Ads 报表与异常诊断(2026):展示份额、搜索词、预算花不满一次查清

让 Claude 通过 Google Ads MCP 服务器的 search_search 与 metadata 工具自动写 GAQL:日报、展示份额三列诊断、零转化搜索词、预算花不满排查,附 GAQL 示例、只读配置与 claude -p 定时摘要。

最后更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文档均于当天查阅;当前 API 版本 v26.2)

Google Ads 的报表能力都建立在 GAQL(Google Ads Query Language)上:用类 SQL 的语法查询资源、指标、细分维度(GAQL 官方文档)。问题是投手大多不会写 GAQL。现在有了 Google 开源的 Google Ads MCP 服务器,Claude 可以直接替你拼 GAQL、执行、解释结果——这是整个 Google 自动化里最安全、收益最快的一段,因为它只读。

Claude 查数用到的 3 个 MCP 工具

  • customers_list_accessible_customers:列出当前凭据能直接访问的客户 ID。
  • search_search:根据结构化参数(customer_id、resource、fields、conditions、orderings、limit)构造并执行 GAQL SearchStream 查询。
  • metadata_get_resource_metadata:返回某资源可选、可筛选、可排序的 GAQL 字段,避免写出无效查询。

此外服务器还挂载了 4 个只读参考资源(discovery-document、metrics、segments、release-notes),不受工具开关影响(官方指南)。

5 类最常问的报表问题

你问 Claude 的问题Claude 生成的 GAQL 要点看什么
昨天哪些系列花费异常?FROM campaign,segments.date DURING YESTERDAY,cost_micros与 7 天均值偏差
预算为什么花不满?metrics.search_budget_lost_impression_share、search_rank_lost_impression_share预算损失 vs 排名损失
哪些搜索词在白花钱?FROM search_term_view,conversions = 0,cost_micros 阈值加否定词候选
哪个广告组 CTR 掉了?FROM ad_group,segments.date DURING LAST_14_DAYS + segments.week周环比
某字段能不能和某资源一起查?metadata_get_resource_metadata可选、可筛、可排序字段
Claude 自动生成 GAQL 的 5 类常见问题对照表

一个实用技巧:让 Claude 先调 metadata 工具确认字段兼容性,再查数。这样能少踩「字段不能和该资源一起选」这类错误。如果想手写验证,Google 也提供交互式查询构建器。

GAQL 示例:零转化但有花费的搜索词

-- GAQL: search terms with spend but no conversions in the last 30 days
SELECT search_term_view.search_term, campaign.name, ad_group.name,
       metrics.cost_micros, metrics.clicks, metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.conversions = 0
  AND metrics.cost_micros > 20000000
ORDER BY metrics.cost_micros DESC
LIMIT 200

注意 Google Ads API 的金额字段都是 micros(1 个币种单位 = 1,000,000),上面的 20000000 就是 20 个帐户币种单位。让 Claude 在报表里自动除以 1,000,000 再展示。

异常诊断:信号 → 原因 → 下一步

异常信号可能原因Claude 的下一步查询人工决策
花费骤降预算受限、审核拒登、出价策略学习查系列状态与政策摘要字段是否加预算/改素材
CPC 飙升竞争加剧、质量下降、匹配放宽按关键词查平均 CPC 与质量相关字段是否调出价上限
转化归零追踪断了、落地页故障按转化动作查最近转化时间先排查追踪
展示份额低预算损失或排名损失两列损失份额分开看加预算还是优化排名
搜索词漂移AI Max/广泛匹配扩量search_term_view + 匹配类型加否定词
Google Ads 常见异常信号与 Claude 排查路径对照表

「预算花不满」是出海团队最常问的问题之一。展示份额三列(预算损失、排名损失、搜索量过低)的判读方法见 谷歌搜索广告预算花不满:展示份额三列诊断;Claude 可以按同样逻辑自动跑一遍并给出结论。AI Max 带来的搜索词变化,可配合 AI Max 流量怎么识别:{search_term_matchtype} 一起看。

把它变成每天的只读摘要

第一步,在服务器端开启只读模式,让写入工具根本不注册:

# tools_config.yaml - strictly read-only deployment
# (point GOOGLE_ADS_MCP_TOOLS_CONFIG at this file)
namespaces:
  customers: true
  search: true
  metadata: true
  labels: false
  assets: false

第二步,用 claude -p 无交互运行,并通过 --allowedTools 只放行查询工具(headless 模式):

# read-only morning summary with Claude Code in headless mode
claude -p "Use google-ads to pull yesterday's cost, clicks, conversions and \
search impression share by campaign for customer 1234567890. Compare with the \
7-day average, flag anomalies. Do not change anything." \
  --allowedTools "mcp__google-ads__search_search,mcp__google-ads__metadata_get_resource_metadata" \
  --output-format json > summary.json

需要更稳定的结构化输出或接入 BI,可以改用 google-ads Python 库的 search_stream 直接导出 CSV,由 Codex 写脚本、Claude 只做解读,见 用 Codex 写 Google Ads 日报与搜索词脚本。

配额与数据口径

  • 每次查询都消耗 API 操作配额;Explorer 级别对生产帐户每天 2,880 次(
  • 配额说明
  • )。把多帐户日报合并成少量查询更省。
  • 当日数据会有延迟,日报建议查 YESTERDAY。
  • 报表口径以 Google Ads 后台为准;让 Claude 在摘要里注明查询的日期范围和过滤条件。

熊猫出海如何用 Claude、Codex 和 Google 广告帐户帮客户提升投放效率

这篇讲的是 Claude,但在实际服务中,熊猫出海会把 Claude、Codex 和 Google Ads 帐户组合起来,帮出海企业更快跑完「开户与转化追踪 → 搭系列 → 写素材 → 看报表与搜索词 → 调预算与否定词」这一整套重复工作,让投手把时间花在策略、出价判断和素材上。

  • 广告帐户:使用企业自己的 Google Ads 帐户,或通过熊猫出海开户服务合规开通的帐户;帐户归企业所有,不出租、不共享。需要多帐户管理时,用企业自己的经理帐户(MCC)授权。
  • Claude:通过 Google 开源的 Google Ads MCP 服务器用自然语言查数(GAQL)、诊断展示份额和搜索词、写 RSA 标题描述与附加信息初稿,在「先提议、后确认」模式下创建素材和标签。
  • Codex:写和维护 google-ads Python 脚本(日报、搜索词清洗、批量建暂停系列、validate_only 预检),在沙盒里运行并接入定时任务或 CI。
  • 人工把关:启用系列、提预算、改出价目标都由投手审核后执行;Google Ads 政策与落地页合规由人工最终确认。

这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 Google、Anthropic 或 OpenAI 的官方合作伙伴。开户与代投放流程请看 Google 广告开户与投放(熊猫出海服务页)。

常见问题

Claude 写的 GAQL 会不会出错?

会,尤其是字段兼容性。让它先调用 metadata 工具确认字段,再执行查询;结果异常时让它把 GAQL 原文贴出来供人检查。

只读模式下 Claude 还能改东西吗?

在 tools_config.yaml 里关闭 labels 和 assets 命名空间后,写入工具不会注册,Claude 无法调用。

需要 MCC 吗?

不是必须。通过经理帐户访问客户帐户时,设置 GOOGLE_ADS_LOGIN_CUSTOMER_ID 或每次调用传 login_customer_id 即可。

能查多个帐户吗?

可以,先用 customers_list_accessible_customers 列出帐户,再逐个查询;注意配额。

合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 Google Ads 帐户(含经理帐户 MCC 下的客户帐户),通过 Google 官方 Google Ads API、Google 开源的 Google Ads MCP 服务器或 Google Ads 编辑器等官方工具接入,遵守《Google Ads API 条款》、API 配额与《Google Ads 政策》,并在任何会产生花费的动作前保留人工审核。熊猫出海不出售、出租、共享或转让广告帐户、MCC 或 API 凭据,不协助规避广告审核、地区限制、身份验证或付款管控,也不是 Google、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。

相关阅读

联系熊猫出海:Google 广告开户 + AI 自动化投放

告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(报表、搜索词、素材还是建系列)。我们先做资质与落地页预审,再协助企业合规开通自有 Google Ads 帐户,并把 Claude / Codex 接入到你的投放流程。

WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

熊猫出海微信二维码 szcwh99

官方来源

以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

本文来自网络,不代表熊猫出海立场。转载请注明出处: https://www.pandawm.com/blog/claude-google-ads-gaql-reporting-anomaly-diagnosis-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

熊猫出海(PandaWM)编辑团队,来自香港出海服务商熊猫出海,专注 Facebook、TikTok、Google 等海外广告开户与代投,以及 GEO/AI 搜索优化、多语言独立站建设。有Facebook白名单牌照户、TikTok加白户、Google G2认证户等核心资源 。

为您推荐

发表回复

联系我们

联系我们

工作时间:周一至周五,9:00-17:30,节假日休息

关注微信
微信扫一扫关注我们

微信扫一扫关注我们

关注微博
返回顶部