| 1) Entry | Operator opens Marketing Material tab in the product editor. Seven platform tabs: Google Ads, LinkedIn, Facebook Ad, Instagram, Pinterest, Email, TikTok. |
| 2) Pre-checks | Product context and Gemini configuration must already be valid for generation. |
| 3) Core flow | "Generate Marketing Material" runs all-platform generation for Google Ads, LinkedIn, and Facebook Ad. Instagram, Pinterest, Email, and TikTok each have an individual per-tab Generate button. Per-platform Regenerate button re-runs a single platform. |
| 4) Output structure | Google Ads: headlines (3 × max 30 chars) + descriptions (2 × max 90 chars) with live char counts. LinkedIn: hook + body + hashtags. Facebook: primary text + headline + link description. Instagram: caption (up to 2200 chars) + hashtags (up to 10). Pinterest: pin title (≤100 chars) + description (≤500 chars) + hashtags. Email: subject line (≤60 chars) + preview text (≤90 chars) + body. TikTok: hook (≤100 chars) + script + caption (≤150 chars) + hashtags. |
| 5) Operator instructions | Per-platform instructions set in Settings → Content Engine → Operator Ad Instructions. Injected automatically into every generation. Active state shown in a bar below the Generate/Regenerate button — displays truncated instruction text or "None set — Add in Settings" linking directly to the Content Engine tab. |
| 6) Prompt templates | Ad copy prompt templates editable in Settings → Dev tab → Prompt Templates. Reset to default anytime. |
| 7) Platform Agents (all seven channels) | Each platform tab shows a channel specialist agent trigger button after first generation. The agent is a real conversational assistant: multi-turn session history, deep per-platform knowledge, and full context of the current product, business context, operator ad instructions, and generated ad copy. Opens as a shared slide-in right panel; platform title and context switch dynamically. Runs on /v1/generate/text with action_type: agent_chat — counts against client quota (weight 1). A product + channel context banner appears inside the panel. |
| 8) Data flow | Campaign outputs stay in the generated result set for review and copy, separate from WooCommerce product field writes. |
| 9) Failure handling | Provider or formatting errors surface readable messages. |
| 10) Write path | Campaign outputs are not automatically written into WooCommerce or ad platform integrations. |
| 11) Recovery | Clearing the current session removes campaign output panels alongside other generated state. |