Skip to content

Audit and fix campaign names against the naming convention, in Google Sheets

Writes an account's naming audit to a new Google Sheet with export_naming_audit_to_sheet (one tab per level, each name's verdict against the convention, an editable New name column, an About tab), reads the typed names back with read_naming_sheet as the changes of a rename, previews and applies them with change_campaigns after the person confirms, and writes each outcome back with write_naming_sheet_outcomes.

Recipe

Intent The naming audit written by Get MCP Ads into a Google Sheet of the workspace's linked Google account, the team's typed names read back, renamed after one preview and one confirmation, and each outcome written into the sheet.

Steps
4
Tools
0
Rules
3
Failure modes
3
skills/naming-audit-in-google-sheets.md

When to use it

Use it when

  • Someone asks for the naming audit in Google Sheets, or wants the team to fix names in a shared Google Sheet.

Do not use it when

  • Google Sheets not linked to the workspace: give the link the refusal carries, or offer the audit in a Claude Sheet (naming-audit-in-a-sheet) or in the conversation.
  • No convention saved and none given: ask for the convention first.

What it needs first

No single source is required: this one reads across whatever you have connected.

Preconditions

  • The account is among the chosen accounts, confirmed via list_accounts.

Evidence every conclusion must carry

  • The sheet's rows are check_campaign_names' reading at the time in its About tab; the preview reads each new name against the convention again.
Inputs
InputRequiredWhat it is
accountrequiredOne ad account of the workspace, on any ad platform.
windowMeta, Google Ads and TikTok: the period whose delivering objects are read, with their spend.Default: last 30 complete days.

Procedure

In order. Every tool named is one the gateway ships, and links to its reference.

Steps

  1. Call export_naming_audit_to_sheet with the account, the levels, the period on Meta, Google Ads and TikTok, the convention when none is saved, and a new request_id kept for retries. Give the person the link, the Google account that holds it and the counts to fix and to rewrite.
  2. When the person says the names are ready, call read_naming_sheet with the sheet's link: it returns the changes of the rename, each with ids, current names, new names and rename details.
  3. Call change_campaigns with those changes and no confirm token, show the one preview (each name before and after and its verdict), and apply only after the person confirms, with the confirm token and their reason.
  4. Write each item's result back with write_naming_sheet_outcomes (id, ok, new_name, the platform's words when refused), and report renamed and refused counts.

Decision rules

The observable condition, what it lets you conclude, and what takes the conclusion back.

  • When A retry after a timeoutConclude Repeat export_naming_audit_to_sheet with the same request_id: it answers the same sheet and never writes over names already typed.
  • When read_naming_sheet skips rowsConclude Those rows lost their hidden ID, level, platform or account: say which, and leave them out of the rename.
  • When More than 12 changes or 100 namesConclude Preview them in batches, one after the other.

Where the agent stops

Nothing is renamed by the sheet or by reading it. Only change_campaigns with the token of a preview the person confirmed renames.

How it goes wrong quietly

The cases where the analysis is wrong and still looks right. Read them before trusting a number.

  • Reading the sheet as live data: its cells are what was read at the time written in its header, never a link to the platform. Read the platform again before any preview.
  • Renaming from read_naming_sheet's answer without showing the change_campaigns preview.
  • Writing an outcome as renamed when change_campaigns said refused.

What the answer contains

What Naming audit in Google Sheets returns
SectionWhat it holds
SheetThe link, the Google account that holds it, and the counts to fix and to rewrite.
ResultRenamed and refused counts, each refused name with the platform's words, and the outcomes written in the sheet.

Manage your ads from your AI assistant

Start for free

Free with 1 ad account, no card. Pro is free for 7 days.