greeneclipse
8580c996c3
Drop one-shot tmp/axe scripts and agent i18n scratch so the Gitea tree is deployable.
71 lines
3.4 KiB
Markdown
71 lines
3.4 KiB
Markdown
# 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](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](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](email-sending.md).
|
|
|
|
## Related docs
|
|
|
|
- [QA local demo](qa-local-demo.md) — login, Local Demo Co, uploads, nav status
|
|
- [Demo user](demo-user.md) — credentials + company counts
|
|
- [Marketing suite design](marketing-suite-design.md)
|
|
- [Free tier gates](free-tier.md)
|
|
- [Email sending](email-sending.md)
|