用途:帮助开发者使用 AdsApp API 编写运行在 Google Ads 编辑器中的 JavaScript 脚本,实现广告账户自动化。
主要能力:一是广告系列操作,可通过 AdsApp.campaigns() 配合条件筛选,按状态、预算、名称模式或类型创建、修改、批量更新并打标签;二是关键词与出价管理,按质量得分筛选、依据 ROAS/CPA 目标调整最高 CPC、增删否定关键词;三是效果报表,基于广告系列、广告组、关键词统计生成自定义报告,支持自定义日期范围并导出到 Google Sheets;四是预算管理,查询与设置每日预算、监控支出阈值、达限暂停;五是自动化规则,如暂停低效关键词、提升高效词出价、按星期模式调整预算;六是错误处理,用 try-catch、空值检查与表格日志应对 API 限额与运行错误,并注意 30 分钟执行上限。
使用方式:常见模式是用 AdsApp.keywords() 叠加 .withCondition() 与 .forDateRange('LAST_30_DAYS').get() 遍历结果执行操作。最佳实践包括先收集实体再批处理、用 API 级筛选代替 JavaScript 过滤、用 .withLimit() 分批处理大账户、金额按 micros 除以 1,000,000、将变更带时间戳记录到 Google Sheets。可用 scripts/validators.py 做部署前校验,Logger.log() 配合 View > Logs 调试。
适用场景:广告系列批量维护、关键词与出价优化、预算控制、绩效报表导出及自动化决策。
限制:注意执行超时、配额超限、类型错误与空值;API 参考、示例、最佳实践与自动化模式需按需加载 references/ 相关文件。与 google-apps-script、google-analytics、google-tagmanager 可配合使用,上述集成的具体步骤资料未详细提供。