--- name: google-ads-builder-branded-search description: > Builds a Branded Search campaign — defensive coverage on the business's own brand terms plus optional competitor conquesting — with trademark-aware ad copy and the brand-exclusion coordination that keeps PMax/Shopping from cannibalizing brand traffic. Emits a human .xlsx plus a campaign-spec.json (branded_search). Reads account-context.yaml. Use when the user says "branded search", "brand campaign", "defend my brand", "competitor conquesting", "bid on my own name". --- # Google Ads — Builder: Branded Search A focused Search campaign to (1) defend your own brand at near-certain ROAS and (2) optionally conquest competitors. Pushes cleanly via Editor CSV. Builds on `builder-search` patterns with brand-specific rules. ## Operating rules - Read `brand_terms` and `competitor_terms` from `account-context.yaml` (set by `setup`). Read guardrails. - Write to the working directory: `blueprint.xlsx` + `campaign-spec.json` (`campaign_type: "branded_search"`, `ad_groups[]`). - **Coordinate brand exclusion**: ensure PMax/Shopping have brand exclusion applied so they don't claim brand conversions (clean attribution). Honor the `pmax-brand-exclusion` guardrail. ## Model dispatch (run cheap, decide expensive) — see `${CLAUDE_PLUGIN_ROOT}/references/model-tier-dispatch.md` - **Scout (`haiku`)** — per-URL 200 checks; char-count validation; brand-misspelling expansion. - **Routine (`sonnet`)** — pulling competitor domains from auction insights as conquesting candidates. Dispatch as `general-purpose`; **return raw candidates, don't decide**. - **Judge (main session)** — STEP 1-2 ad-copy (brand-led, trademark-aware — **never a competitor TM in ad text**), STEP 3 separation, bidding, the brand-exclusion coordination call. Trademark safety is judgment; never delegate it. ## STEP 1 — Brand-defense ad group(s) - Keywords from `brand_terms` (own brand + variants + common misspellings), Exact + Phrase. No broad. - Copy uses your own brand prominently, your USPs, and your real offers. Target high impression share at low CPC (brand intent converts cheaply). - RSA: up to 15 headlines (≤30) / 4 descriptions (≤90), keyword-led, with CTA. ## STEP 2 — Competitor conquesting — optional, trademark-aware, a SEPARATE campaign - Only if `competitor_terms` exist and the user wants it. **Emit it as its OWN campaign-spec, not an ad group inside the brand-defense campaign** — because bid strategy is campaign-level and conquesting needs **Maximize Conversions**, not the defense campaign's Target Impression Share. (You do NOT want to bid to dominate a competitor's SERP at absolute-top 90% — expensive, low-intent.) - Keywords from `competitor_terms` (Phrase/Exact). - **Trademark rules**: do NOT put a competitor's trademark in the ad TEXT (headlines/descriptions/paths) — only as keywords. Emit the competitor terms as a spec-level `trademark_avoid[]` so the validator BLOCKS any in ad text. Lead with YOUR differentiators ("wholesale pricing", "free shipping", a **price extension** with your real prices on the competitor SERP), not the competitor's name. Expect lower CTR/QS, higher CPC. - Add YOUR `brand_terms` as negatives so conquesting never overlaps the brand-defense campaign. ## STEP 3 — Negatives & separation (Search levels: campaign OR ad-group) - **Negatives can sit at campaign level OR ad-group level** in Search (unlike PMax = campaign-only). Use campaign-level for account-wide junk (job-seeker, DIY, location) and **ad-group-level** only where it does real work — here, negate `brand_terms` in the conquesting ad group so defense and conquesting never cross-serve. Don't duplicate the same negative at both levels; pick the narrowest level that achieves it. - Keep brand-defense and conquesting ad groups cleanly separated. - **Extensions, likewise, can be campaign OR ad-group level in Search** (PMax forces campaign-level). Default to campaign-level; only push sitelinks/callouts down to ad-group level if the groups are different enough to need distinct ones (e.g. brand-specific vs conquesting sitelinks) — and only if it's worth the upkeep. ## STEP 4 — Bidding (Search ≠ PMax — pick a brand-appropriate strategy, NOT a "learning ramp") - **Check what the account already does for brand first.** If a brand campaign exists, read its `bidding_strategy_type` (a healthy brand campaign commonly runs `TARGET_IMPRESSION_SHARE`) and match it — don't reinvent. - **Brand defense → Target Impression Share** (absolute top of page, ~90%, with a max-CPC bid limit). The goal is to dominate your own brand SERP cheaply, not to maximize value. Brand has history, so do NOT frame it as "maximize conversion value, no target, learning" — that's a cold-prospecting default, wrong for brand. (Maximize Conversions is an acceptable alternative if you'd rather optimize to conversion volume.) - **Conquesting → Maximize Conversions** (watch CPA, don't over-invest). It's colder and pricier than brand. - **Bid strategy is CAMPAIGN-level.** Brand defense and conquesting want *different* strategies, so once conquesting has real budget, **split it into its own campaign** rather than forcing both under one strategy. ## STEP 4b — Conversion goal (use the account's REAL action — never invent one) **Pull the enabled conversion actions** (`conversion_action.name`, `primary_for_goal`) and use the account's actual primary purchase action by name — e.g. a store's only purchase action may be the store-channel purchase (Shopify's "Google & YouTube" channel tracks website purchases, Search-driven ones included), so the Search campaign optimizes on THAT, not a made-up name. Set `conversion_goals.scope: "campaign"`. If no web-purchase primary exists for Search, flag it for the operator to create. ## STEP 5 — Output + verification Emit `campaign-spec.json` (`branded_search`, `ad_groups[]` as in `builder-search`) + `blueprint.xlsx`. Set `campaign.status: "paused"`, `conversion_goals.scope: "campaign"`. Build the `extensions` block the same way as `builder-pmax` STEP 7b — sitelinks, callouts, structured snippets (the store carries many brands, so a `Brands` snippet IS correct here, unlike a single-brand PMax), and a **concrete `prices` asset built from real store data** (don't leave it a placeholder — pull "From" prices per category and a live URL each; a price extension is especially strong on a brand/conquesting SERP). On a conquesting campaign, **emit a `trademark_avoid` list** (the competitor terms) at the spec level — the validator BLOCKS any ad text containing one, enforcing the no-competitor-TM-in-copy rule. Render the human workbook from the spec (the shared renderer handles ad_groups → an AG sheet per ad group with keywords, RSA, negatives, paths): `python ${CLAUDE_PLUGIN_ROOT}/skills/builder-pmax/scripts/spec_to_xlsx.py --output blueprint.xlsx` Verify with `validate_spec.py`: RSA limits/counts (Google-accurate counting, `${CLAUDE_PLUGIN_ROOT}/references/google-ads-formatting.md`), keyword/negative match types (no broad), **no `trademark_avoid` term in any ad text** (enforced), brand_terms negated in conquesting groups, Final URLs live (200). Hand the JSON to `pusher` → Editor CSV (`spec_to_editor_csv.py`) + ready-to-copy blocks (`spec_to_paste.py`). ## Coordination note for the operator Branded Search + PMax brand exclusion are two halves of one decision: PMax excludes brand traffic, this campaign captures it deliberately. Surface this so reporting and credit stay clean. ## To build / refine later - [ ] Auto-generate brand misspellings; pull competitor domains from auction insights.