Launch Meta Campaign

---
name: launch-meta-campaign
description: Launch a complete Meta Ads campaign — campaign, ad set, and ad(s) — built paused and ready to review. Use when the user wants a new Facebook/Instagram campaign.
---
## Goal

Stand up a production-ready Meta campaign with one ad set and one or more ad variants in one flow. Always start **paused**.

## Inputs to confirm (batch)

1. Ad account name (substring) — required.
2. **Campaign objective** — `OUTCOME_SALES`, `OUTCOME_LEADS`, `OUTCOME_TRAFFIC`, `OUTCOME_AWARENESS`, `OUTCOME_ENGAGEMENT`, `OUTCOME_APP_PROMOTION`. Required. **This cannot be changed later** — picking wrong forces a full rebuild.
3. Conversion location (for Sales/Leads): website + pixel + event, or lead form, or messaging.
4. **Budget structure** — campaign budget (CBO / Advantage Campaign Budget) or ad-set budget (ABO). Required. **CBO is default-on for new campaigns.** Pick before creating because switching later is messy.
5. Daily budget — required.
6. Targeting: location(s), age range, gender, languages, detailed interests/behaviors (or Advantage+ Audience).
7. Placements: Advantage+ Placements (recommended) or manual. If manual, which platforms (FB, IG, Messenger, Audience Network) and which positions (feeds, stories, reels, etc.).
8. Schedule: continuous or start/end dates.
9. Ad format: single image, single video, carousel, catalog (DPA), flexible / dynamic creative.
10. Creative inputs: image/video file IDs (if user attached) or URLs, primary text, headline, description, CTA, destination URL, Facebook Page ID, optional Instagram account ID.

## Workflow

1. **Discover** ops via `find_operations`:
   `meta_ads_select_accounts`, `meta_ads_create_campaign`, `meta_ads_create_adset`, `meta_ads_create_single_image_ad`, `meta_ads_create_single_video_ad`, `meta_ads_create_carousel_ad`, `meta_ads_create_catalog_ad`, `meta_ads_create_flexible_ad`, `meta_ads_search_targeting`, `meta_ads_list_account_pixels`, `meta_ads_list_custom_audiences`.
2. **Inspect** with `get_operation_inputs`.
3. **Resolve account**: `meta_ads_select_accounts` substring.
4. **Resolve targeting** if user gave interest/behavior names → `meta_ads_search_targeting` to get IDs.
5. **Resolve pixel** for conversions → `meta_ads_list_account_pixels`.
6. **Create campaign** (status=PAUSED) with chosen objective + CBO/ABO setting + budget if CBO.
7. **Create ad set** under that campaign with: optimization goal (matches objective), conversion event, audience, placements, schedule, budget if ABO. Status=PAUSED.
8. **Create ad(s)** — pick the right `meta_ads_create_*_ad` op for the format. Status=PAUSED.
9. **Confirm** to user with IDs + reminder to review and unpause.

Use `safe-write-operations` for every create call.

## Platform-specific rules the model MUST respect

- **Objective is permanent.** Cannot be changed after creation — confirm with the user before creating the campaign.
- **CBO vs ABO decision is locked at campaign creation** in practice. CBO (Advantage Campaign Budget) lets Meta distribute across ad sets — recommended when running 2+ ad sets in one campaign. ABO when each ad set has a distinct test variable (e.g. audience A vs B with controlled spend).
- **Don't run more than 2–4 ad sets in one campaign.** Beyond that, Meta over-concentrates spend on one and the others starve (auction overlap).
- **Learning phase**: each ad set needs **~50 conversions per week** to exit learning. Sub-$50/day campaigns with mid-funnel conversion events almost never exit learning — warn user.
- **Advantage+ Audience** is now the default for most objectives. Manual targeting still works but Meta will broaden it unless you check the "use these settings as audience controls" override.
- **Advantage+ Placements** is preferred unless there's a creative reason to restrict (e.g. vertical-video-only).
- **Catalog ad (DPA)** requires a configured product catalog + product set + pixel with `ViewContent` / `AddToCart` / `Purchase` events. Confirm catalog exists before picking this format.
- **Flexible / dynamic creative ads** let Meta mix multiple images, headlines, primary texts, descriptions, CTAs and find winning combos automatically — recommended for testing.
- **Page ID required for every ad.** Ask user which Page if account has multiple.
- **Always create PAUSED.** Unpause is a separate user action.

## Failure modes & recoveries

- "Pixel not active for selected event" → list available pixels + their active events; ask user to pick a different event or fix pixel implementation.
- "Audience too narrow / Audience too broad" → show estimated reach; suggest widening (drop interests, raise age range) or narrowing (add behavior layer).
- "Creative rejected" → most common: missing disclaimer for special category (housing/credit/employment/social issues). Ask user about category and re-create with declared category.
- "Targeting unavailable in this region" (housing/employment/credit special categories) → can't target by age/gender/zip; declare special category at campaign level.

## Output to user

| Item | Value |
|---|---|
| Account | <name> (id) |
| Campaign | <name> (id, PAUSED, objective=<x>, CBO/ABO=<y>) |
| Ad set | <name> (id) |
| Audience est. reach | <n> daily |
| Ad(s) | format, count |
| Daily budget | <amount> |

End with: *"Review in Ads Manager. Unpause from there or ask me to flip status. After 3–7 days, run `/markifact:diagnose-underperformer` if performance is off."*