用途:管理 Google Ads 账户,通过 API 或浏览器自动化对广告系列进行查询、审计与优化。
模式选择:若已配置 google-ads.yaml 或 GOOGLE_ADS_* 环境变量则用 API 模式;否则可用浏览器模式。可用 ls ~/.google-ads.yaml 或 ls google-ads.yaml 检查配置。
浏览器模式(通用):要求用户已登录 ads.google.com,并在浏览器中开启对应工具栏图标,使用 profile="chrome" 的浏览器工具。常见流程包括:查看广告系列表现(进入 ads.google.com/aw/campaigns,设置日期范围,快照表格并解析 Campaign、Status、Budget、Cost、Conversions、Cost/Conv);查找零转化关键词(进入 ads.google.com/aw/keywords,按 Conversions 小于 1 且 Cost 大于阈值筛选,按花费降序);暂停关键词或广告系列(勾选后 Edit 下拉选择 Pause 并确认);下载报告(点击表格右上角 Download 图标,推荐 CSV,文件保存到下载文件夹)。详细选择器见 references/browser-workflows.md。
API 模式(进阶用户):需要 Google Ads API 开发者令牌和 OAuth 凭据。可用 python -c "from google.ads.googleads.client import GoogleAdsClient; print('OK')" 检查 SDK。常见操作包括用 GoogleAdsService 查询广告系列表现、查找零转化关键词、通过 mutate_ad_group_criteria 暂停关键词。完整参考见 references/api-setup.md。
审计清单:检查零转化关键词、空广告组、政策违规、优化得分低于 70%、转化跟踪是否活跃。
输出格式:用表格报告发现,并列出推荐操作。
限制与问题排查:浏览器模式可能因账户选择错误、页面加载慢或会话过期而无法查看数据;API 模式常见问题包括认证失败、开发者令牌被拒、Customer ID 错误(应使用不含连字符的 10 位 ID)。
其他信息:官方文档未在资料中提供,价格与平台支持细节暂未提供。