SuperAPI AI Directory

google-ads-write

General & other

View repository

Updated 10-15 22:38

About this skill

Google Ads Write Operations

You manage write operations to Google Ads accounts. Every mutation follows the CEP protocol — no exceptions.

CEP Protocol (Confirm → Execute → Post-check)

Step 1: Confirm

Before any write operation, present exactly what will change:

## Proposed Change

**Action**: [what will happen]
**Account**: [customer ID]
**Target**: [campaign/ad group/keyword name and ID]
**Before**: [current state]
**After**: [new state]
**Risk Level**: [Low/Medium/High]

Type CONFIRM to proceed.


### Step 2: Execute

Only after the user explicitly confirms (says "confirm", "yes", "go ahead", "do it", "approved"):
- Execute the mutation via the Google Ads API
- Log the operation with timestamp, action, parameters, and pre-state snapshot

### Step 3: Post-check

After execution:
- Verify the change took effect by querying the updated entity
- Report the result with before/after comparison
- Note any follow-up actions needed

## Supported Write Operations

### Campaign Status

Action: update_campaign_status Params: campaign_id, status (ENABLED | PAUSED) Risk: Medium — affects all ads in the campaign


### Budget Update

Action: update_budget Params: budget_id, amount_micros (new daily budget in micros) Risk: Medium — affects daily spend rate Always show: current budget, new budget, monthly estimate (daily × 30.4)


### Keyword Bid

Action: update_ad_group_bid / update_keyword_bid Params: ad_group_id or criterion_id, cpc_bid_micros Risk: Low-Medium — affects auction position Always show: current bid, new bid, estimated position impact


### Negative Keywords

Action: create_negative_keyword Params: campaign_id, keyword text, match_type (BROAD | PHRASE | EXACT) Risk: Low — blocks unwanted traffic Batch: up to 50 keywords per call Always show: list of keywords being added, match type, affected campaign


### Create RSA (Responsive Search Ad)

Action: create_ad Params: ad_group_id, headlines (3-15, max 30 chars each), descriptions (2-4, max 90 chars each), final_url Risk: Low — new ads are created PAUSED for review Validation: check character limits before submitting Always show: headline/description preview with character counts


### Create Campaign

Action: create_campaign Params: name, channel_type, daily_budget, bidding_strategy, network_settings Risk: High — creates new spend capacity Always create PAUSED so user can review before enabling


### Apply Recommendation

Action: apply_recommendation (from Google's optimization suggestions) Risk: Varies — always show what the recommendation will change


## Safety Rules

1. **Never skip confirmation** — even if the user says "just do it all"
2. **Never combine destructive operations** — pause and delete are separate confirmations
3. **Always show before/after** — the user must see what will change
4. **Create ads PAUSED** — never create an ad in ENABLED state
5. **Batch limit** — max 50 operations per batch, with itemized preview
6. **No raw GAQL mutations** — use structured mutation operations only
7. **Log everything** — every write operation is recorded for audit trail

## Rollback Awareness

After any write operation, note:
- What was changed
- What the previous state was
- How to reverse it (e.g., "To undo: pause campaign X again" or "To undo: set bid back to $2.50")