Paid ads

Plans honest sale structures (discount, bonus, extended guarantee, payment-plan concession) for the same fixed six holidays /holiday-content-calendar owns, priced against /offer-builder's own recorded price and master.md's margin -- never a fabricated discount, countdown, or scarcity claim. Every sale needs the user's own approval. Feeds /ads-campaigns mode plan as its seasonal campaign input, and hands the same calendar to /holiday-content-calendar/organic-content-creator for the organic tie-in.

Pulls real, currently-running competitor ads from the two public, no-login ad-transparency tools (Meta Ad Library, Google Ads Transparency Center), records hook/offer/format/run-length per ad with source URL and fetch date, and synthesizes repeating patterns and a differentiation gap. Run-length is used only as a cited heuristic for 'likely working' -- never presented as a real spend/conversion figure, since neither tool publishes those for an ordinary commercial advertiser. Feeds /ad-copy and /ad-creatives mode from-competitors.

Writes Meta and Google (RSA) ad copy inside each platform's own current character limits, fetched live every run rather than memorized. Grounds every claim in master.md/offer-builder's real offer and only APPROVED holiday-sale-planner rows, runs each draft through a pre-publish policy self-check (or /meta-account-monitor's real one once built), and delivers multiple testable variations per platform. Feeds /ads-campaigns.

Creates new ad creative images (OpenArt) or video briefs (handed to /new-edit) in three modes: characters (C51 - one consistent, reference-driven AI character reused across ads and UGC-style creative, disclosed as synthesized and never presented as a customer), from-winners (#70, built off this business's own real top-performing organic/ad content per /organic-metrics or /ads-metrics) and from-competitors (#72, informed only by /ads-research's actually-reported findings). Never fabricates a real customer photo, testimonial, or before/after claim. OpenArt spend is quoted and approved first, and every creative pairs with a real /ad-copy draft. Runs a visual pre-publish self-check pending /meta-account-monitor. An optional avatar-video route (HeyGen, C51) renders through /generate-assets only after the likeness-consent gate passes, disclosed as synthesized.

Sets up (#69/#74), plans/schedules (#75), and launches (#76) Meta and Google ad campaigns. setup builds campaign/ad-set/ad-group structure via the real Meta Marketing API and Google Ads API mutate pattern, always PAUSED, with a correct special_ad_categories declaration. plan builds a seasonal calendar from /holiday-sale-planner's APPROVED rows and /ad-copy//ad-creatives' checked drafts. launch is the only spend-triggering mode, gated on connector presence, a passed pre-publish check, an APPROVED sale, and the user's own explicit spend approval every time.

Manages (#77: pause/reallocate among live ad sets) and scales (#78: bounded budget increases on a proven winner) a business's own already-launched Meta/Google ad campaigns. Never acts on a campaign /ads-campaigns never actually launched; every performance call traces to a real /ads-metrics number; every budget/bid change is checked against the ~15-20% threshold that resets Meta's/Google's own learning phase, with the risk named rather than silently absorbed, and needs explicit approval before applying.

Tracks the full Contract A paid-ads metric list (#79, #82): impressions, relevancy/quality score, clicks, CTR, lead-form submissions or calls booked, call speed/answer/booking rates, show-ups, no-shows, purchases, revenue, and cash collected. Platform-side numbers come from the real Meta Marketing API / Google Ads API insights endpoints once a campaign is live; booking/pipeline numbers come from GHL, the same real source /outreach-metrics already reads. Cash collected is always named not available -- no payments/invoices connector exists. The entire report is honestly not available when no campaign was ever launched.

Monitors a business's Meta account health (ad-account status/disable reason, rejected ads, Page/IG policy issues, billing holds, verification status, pixel health, admin/2FA, messaging rate-limit responses) hourly for ad accounts and daily otherwise, via the official Meta Marketing + Graph APIs. Owns the shared account-health/cooldown state file /dm-outreach, /social-engagement, /ads-campaigns, and /organic-content-creator all read. Runs the rule-based pre-publish policy check /ad-copy and /ad-creatives defer to, and drafts (never submits) compliant revisions and appeal text. A disabled account or Page restriction is always URGENT. Never evades enforcement or creates a replacement account.

Wave 4j orchestrator: sequences the whole paid-ads motion in real dependency order — /meta-account-monitor's account health first, then /holiday-sale-planner's APPROVED sale rows and /ads-research's findings, then /ad-copy and /ad-creatives (each cleared by #102's pre-publish check), then /ads-campaigns setup -> plan -> launch, and only against a genuinely live campaign, /ads-metrics then /ads-optimize. Owns no copy, creative, campaign or metric of its own; never routes around a member's own refused gate. Also drives the P4j.gate one-sample-per-member routing convention, matching /life-planner's and /ghl-setup's role in their own waves.