Google Ads Write Operations 是一个管理 Google Ads 账户写入操作的技能。资料说明,所有对账户的变更都必须遵循 CEP 协议,没有例外。
一、CEP 协议(Confirm → Execute → Post-check)
第一步:确认。在任何写操作之前,先准确展示将要发生的变化,包括:Action(将执行的操作)、Account(客户 ID)、Target(广告系列/广告组/关键词名称与 ID)、Before(当前状态)、After(新状态)、Risk Level(低/中/高风险),并提示用户输入 CONFIRM 以继续。
第二步:执行。只有用户明确确认(如回复 confirm、yes、go ahead、do it、approved)后,才通过 Google Ads API 执行变更,并记录操作,包括时间戳、操作、参数和执行前状态快照。
第三步:事后检查。执行后,查询更新后的实体以验证变更是否生效,报告前后对比结果,并注明需要的后续操作。
二、支持的写操作
- 广告系列状态:update_campaign_status,参数为 campaign_id、status(ENABLED | PAUSED),风险中等,影响该广告系列下所有广告。
- 预算更新:update_budget,参数为 budget_id、amount_micros(以 micros 表示的新每日预算),风险中等,影响每日支出速度;需始终展示当前预算、新预算和月度估算(每日 × 30.4)。
- 关键词出价:update_ad_group_bid / update_keyword_bid,参数为 ad_group_id 或 criterion_id、cpc_bid_micros,风险低至中等,影响竞价位置;需始终展示当前出价、新出价和预计位置影响。
- 否定关键词:create_negative_keyword,参数为 campaign_id、关键词文本、匹配类型(BROAD | PHRASE | EXACT),风险低,用于屏蔽不需要的流量;每次调用最多批量 50 个关键词;需始终展示所添加的关键词列表、匹配类型和受影响的广告系列。
- 创建响应式搜索广告(RSA):create_ad,参数为 ad_group_id、标题(3-15 个,每个最多 30 字符)、描述(2-4 个,每个最多 90 字符)、final_url,风险低,新广告以 PAUSED 状态创建以供审核;提交前检查字符限制;需始终展示带字符数的标题/描述预览。
- 创建广告系列:create_campaign,参数为名称、channel_type、daily_budget、bidding_strategy、network_settings,风险高,会新增支出能力;始终以 PAUSED 状态创建,供用户启用前审核。
- 应用建议:apply_recommendation(来自 Google 的优化建议),风险不定;需始终展示该建议将带来的变化。
三、安全规则
- 绝不跳过确认,即使用户说“直接全部执行”。
- 绝不合并破坏性操作,暂停和删除需分别确认。
- 始终展示前后状态,用户必须看到将发生的变化。
- 创建广告时一律为 PAUSED,绝不以 ENABLED 状态创建广告。
- 批量限制:每批最多 50 个操作,并提供逐项预览。
- 不使用原始 GAQL 变更,只使用结构化变更操作。
- 记录一切:每次写操作都记录,用于审计追踪。
四、回滚意识
任何写操作后,需注明:更改了什么、之前的状态是什么、如何撤销(例如“撤销方法:再次暂停广告系列 X”或“撤销方法:将出价设回 $2.50”)。
五、适用场景与限制
该技能适用于需要安全、可审计地修改 Google Ads 账户的运营与营销场景,例如暂停广告系列、调整预算与出价、添加否定关键词、创建广告和广告系列。资料未提供具体安装方式、配置要求、API 凭据细节、收费信息或平台支持范围,暂未提供。