descrybe/docs/marketing-suite-user-guide.md

Marketing Suite - user guide

Seasonal email campaigns, brand voice, SEO tips, WooCommerce reviews/orders audiences, and the in-app tutorial for Descrybe v2.

Start the tutorial (1 click)

1. Sign in and open Dashboard.
2. Click Start tutorial (welcome card or header).
3. Follow the highlighted controls — you must perform each action (no free Continue on action steps).
4. Use Resume tutorial after Pause, or Restart tutorial after Skip / Done.

Full step list: tutorial.md.

Black Friday campaign in 5 clicks

Assumes you already have products in the catalog (map a feed or import first).

1. Open /campaigns → Create campaign
   (or /marketing/calendar → Prepare Black Friday, then open Campaigns).
2. Pick the Black Friday season template.
3. Choose categories/products (or leave defaults for top catalog items). Optionally set audience to purchasers after syncing Woo orders.
4. Click Generate (template mode is free; AI generate needs Starter+ / credits -- Free returns 402).
5. Send test to yourself, then Schedule or Send once your email provider is verified under /integrations/email.

Optional: Content Calendar one-shot

/marketing/calendar → Prepare Black Friday creates a seasonal export-feed bundle for the BF window. Then open /campaigns to draft the email.

Free vs paid

Action	Free	Paid (Starter+)
Create campaign drafts, pick seasons	Yes	Yes
Template generate (no AI)	Yes	Yes
AI campaign / SEO / brand AI	No (can_use_ai=false, 0 monthly credits)	Yes (credits / BYOK)
Real email blast	Dry-run until upgrade + verified provider	Verified Resend/SMTP
Brand kit form	Yes	Yes
SEO recommendations (template fill)	Yes	AI fill on paid
Woo orders/reviews sync	Yes (connection required)	Yes

Details: free-tier.md. Upgrade from Pricing / Plans when you hit an AI or send gate.

Brand kit

/brand (nav: Marketing → Brand kit) — tone, do/don't, colors, preferred terms, logo URL, and logo file upload (POST /api/brand/logo). Product AI and campaign AI inject this voice when AI is enabled.

SEO

/seo (nav: Marketing → SEO) — missing meta, thin/duplicate titles, weak images. Template apply on Free; AI fill on paid.

Orders, reviews and purchase audiences

1. Connect the store under /woocommerce (Connection tab).
2. Open the Orders tab → Sync orders (worker pulls Woo REST orders into woo_orders / woo_order_items).
3. Open Reviews (/woocommerce?tab=reviews; nav /reviews redirects here) → Sync reviews.
4. In a campaign (/campaigns), choose a purchase-based audience. On send, campaigns call ResolveAudience against synced orders.

API: POST /api/woocommerce/sync-orders, sync-reviews; GET /api/woocommerce/orders, reviews; POST /api/woocommerce/audience.

Email provider

/integrations/email (nav: Email sending) — Resend or SMTP, verify from-address/domain, then send tests. Free plans force dry-run for real blasts. See email-sending.md.

Related docs

• QA local demo — login, Local Demo Co, uploads, nav status
• Demo user — credentials + company counts
• Marketing suite design
• Free tier gates
• Email sending