首页 AI 用 Codex 写 Google Ads 日报与搜索词脚本(2026):GAQL search_stream 导出、零转化搜索词清洗、否定词 validate_only 提交

用 Codex 写 Google Ads 日报与搜索词脚本(2026):GAQL search_stream 导出、零转化搜索词清洗、否定词 validate_only 提交

用 Codex 写三支 Google Ads 运营脚本:GAQL search_stream 日报导出、零转化搜索词清单、人工批准后用 partial_failure + validate_only 提交否定关键词,附 codex exec 定时分析与配额控制。

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

投放团队每天重复最多的两件事:看日报和清搜索词。这两件事非常适合让 Codex 写成脚本——逻辑清楚、可测试、可定时。本文给出三支可直接改用的 google-ads Python 脚本,以及一个用 codex exec 做只读分析的定时任务。

四个脚本各管什么

脚本做什么读/写频率
report.py导出昨日系列花费、点击、转化、搜索展示份额只读每天
search_terms.py找出 30 天零转化但花费超阈值的搜索词只读每周
add_negatives.py把人工标记 approved=yes 的词加为否定词写(先预检)每周
codex exec 分析读 CSV,写摘要与调整建议只读沙盒每天
Codex 编写的 4 个 Google Ads 运营脚本一览表

脚本 1:GAQL 日报导出

Google Ads 的报表通过 GAQL 查询,search_stream 适合一次拉完结果(GAQL 文档)。让 Codex 按下面的结构写:

# report.py - pip install google-ads ; GAQL via search_stream (read-only)
import csv, sys
from google.ads.googleads.client import GoogleAdsClient

QUERY = """
SELECT campaign.id, campaign.name, campaign.status,
       metrics.cost_micros, metrics.clicks, metrics.conversions,
       metrics.search_impression_share
FROM campaign
WHERE segments.date DURING YESTERDAY
  AND campaign.status != 'REMOVED'
ORDER BY metrics.cost_micros DESC
"""

def main(customer_id: str):
    client = GoogleAdsClient.load_from_storage("google-ads.yaml")
    ga = client.get_service("GoogleAdsService")
    with open("report_yesterday.csv", "w", newline="") as f:
        w = csv.writer(f)
        w.writerow(["campaign_id", "name", "status", "cost", "clicks", "conv", "search_is"])
        for batch in ga.search_stream(customer_id=customer_id, query=QUERY):
            for r in batch.results:
                w.writerow([r.campaign.id, r.campaign.name, r.campaign.status.name,
                            r.metrics.cost_micros / 1e6, r.metrics.clicks,
                            r.metrics.conversions, r.metrics.search_impression_share])

if __name__ == "__main__":
    main(sys.argv[1])          # customer ID, 10 digits, no hyphens

配置文件 google-ads.yaml 不需要开发者令牌(已于 2026-09-09 停用,说明):

# google-ads.yaml - no developer_token needed after the 2026-09-09 sunset
# Option A: application default credentials (google-ads >= 28.3.0)
use_application_default_credentials: True
# Option B: OAuth user refresh token (use ONE auth group only)
# client_id: ${from secret manager}
# client_secret: ${from secret manager}
# refresh_token: ${from secret manager}
login_customer_id: 1234567890      # manager account, 10 digits, no hyphens
use_proto_plus: True

脚本 2:零转化搜索词清单

-- 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

把结果导出成 CSV,加一列 approved 交给投手勾选。AI Max 与广泛匹配带来的新搜索词,可以结合 AI Max 流量怎么识别:{search_term_matchtype} 里的匹配类型参数一起判断。

脚本 3:人工批准后加否定词

只处理 approved=yes 的行;默认 validate_only 预检,开启 partial_failure 让单个错误不影响整批(Mutate resources):

# add_negatives.py - campaign-level negative keywords from a reviewed CSV
import csv, sys
from google.ads.googleads.client import GoogleAdsClient

def run(cid, csv_path, commit=False):
    client = GoogleAdsClient.load_from_storage("google-ads.yaml")
    svc = client.get_service("CampaignCriterionService")
    ga = client.get_service("GoogleAdsService")
    ops = []
    for row in csv.DictReader(open(csv_path)):          # columns: campaign_id,term,approved
        if row["approved"].strip().lower() != "yes":
            continue                                    # only human-approved rows
        op = client.get_type("CampaignCriterionOperation")
        cc = op.create
        cc.campaign = ga.campaign_path(cid, row["campaign_id"])
        cc.negative = True
        cc.keyword.text = row["term"]
        cc.keyword.match_type = client.enums.KeywordMatchTypeEnum.EXACT
        ops.append(op)
    req = client.get_type("MutateCampaignCriteriaRequest")
    req.customer_id = cid
    req.operations.extend(ops)
    req.partial_failure = True                          # one bad term won't block the rest
    req.validate_only = not commit
    resp = svc.mutate_campaign_criteria(request=req)
    print(len(ops), "ops", "validated" if not commit else "committed", resp.partial_failure_error)

if __name__ == "__main__":
    run(sys.argv[1], sys.argv[2], commit="--commit" in sys.argv)

定时分析:codex exec 只读运行

codex exec 默认只读沙盒,可用 --output-schema 约束输出结构、-o 写入文件(非交互模式):

# nightly: pull data with a plain script, let Codex analyse it read-only
python report.py 1234567890
codex exec --ephemeral --output-schema report_schema.json -o report.json \
  "Read report_yesterday.csv. Summarise cost, clicks, conversions and search \
impression share per campaign, list anomalies vs the 7-day average and propose \
(do not apply) budget or negative-keyword changes."

Codex 输出「建议」而不是「执行」,投手看完再决定是否运行 add_negatives.py –commit。

6 个控制点

控制点做法原因
配额合并查询、日报只跑一次Explorer 生产帐户每天 2,880 次操作
金额单位cost_micros ÷ 1,000,000避免把 micros 当成元
写入预检validate_only=True 默认失败请求也计配额
部分失败partial_failure=True一个坏词不拖垮整批
人工批准CSV 的 approved 列否定词可能误伤有效流量
凭据ADC/密钥管理,不进仓库防泄露
Google Ads 运营脚本的 6 个控制点

配额细节见 API limits and quotas:返回 GoogleAdsFailure 的请求同样计入每日配额,所以预检和重试上限比想象中重要。

给 Codex 的任务模板

  1. 「读 AGENTS.md。写 report.py:用 search_stream 导出昨日系列数据到 CSV,金额换算为帐户币种单位,附 pytest(mock GoogleAdsService)。」
  2. 「写 search_terms.py:GAQL 查 30 天零转化、花费 > 20 的搜索词,输出 CSV 并加 approved 列。」
  3. 「写 add_negatives.py:只处理 approved=yes,默认 validate_only,partial_failure=True,–commit 才提交。」
  4. 「为三个脚本写 README 和 cron 示例,不要调用真实 API。」

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

这篇讲的是 Codex,但在实际服务中,熊猫出海会把 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 广告开户与投放(熊猫出海服务页)。

常见问题

为什么不直接让 Codex 通过 MCP 查数?

可以,MCP 的 search_search 很方便;但定时日报用脚本更稳定、可测试、输出格式固定。两者可以并存。

否定词用 EXACT 还是 PHRASE?

看场景。脚本示例用 EXACT 最保守;要更大范围排除,让投手在 CSV 中指定匹配类型。

日报能覆盖多个帐户吗?

可以,通过经理帐户设置 login_customer_id,循环客户 ID;注意配额。

Codex 会不会把凭据写进代码?

在 AGENTS.md 里明确禁止,并用 .gitignore 和代码审查双重把关。

合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 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/codex-google-ads-daily-report-search-terms-scripts-2026.html
上一篇
下一篇

作者: 熊猫出海编辑团队

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

为您推荐

发表回复

联系我们

联系我们

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

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

微信扫一扫关注我们

关注微博
返回顶部