> ## Documentation Index > Fetch the complete documentation index at: https://memberpulseptyltd.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # UJ-S-005: Create and Manage Ad Campaign > Sponsor creates and manages advertising campaigns ## Journey Overview | Attribute | Value | | -------------- | --------------------------------------------- | | **Journey ID** | UJ-S-005 | | **Actor** | Sponsor Admin | | **Goal** | Create and manage ad campaigns for visibility | | **Trigger** | Sponsor wants to promote products/services | | **Outcome** | Campaign running and generating impressions | ## Preconditions * Sponsor has active sponsorship tier * Campaign credits available (if credit-based) * Ad placements configured by organization ## Journey Flow ```mermaid theme={null} flowchart TD A[Access Campaigns] --> B[Click Create Campaign] B --> C[Set campaign details] C --> D[Select placements] D --> E[Upload creative assets] E --> F[Set budget/schedule] F --> G[Review and submit] G --> H{Auto-approve?} H -->|Yes| I[Campaign active] H -->|No| J[Pending approval] J --> K[Admin reviews] K --> I I --> L[Monitor performance] ``` ## Detailed Steps Navigate to Campaigns: * Sponsor Portal → Campaigns * Dashboard → "Create Campaign" widget Campaign creation form: ``` ┌─────────────────────────────────────────────────────────────┐ │ Create Campaign │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Campaign Details │ │ ──────────────── │ │ │ │ Campaign Name * │ │ [Spring Product Launch ] │ │ │ │ Campaign Objective │ │ ○ Brand Awareness (impressions) │ │ ● Lead Generation (clicks) │ │ ○ Event Promotion │ │ │ │ Landing Page URL * │ │ [https://acme.com/spring-offer ] │ │ │ │ Campaign Description │ │ [For internal tracking purposes ] │ │ │ └─────────────────────────────────────────────────────────────┘ ``` Choose where ads appear: ``` ┌─────────────────────────────────────────────────────────────┐ │ Select Placements │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Available Placements: │ │ │ │ ☑ Homepage Banner (728x90) │ │ Premium visibility • Est. 5,000 impressions/month │ │ Credits: 100/month │ │ │ │ ☑ Event Listings Sidebar (300x250) │ │ High engagement • Est. 3,000 impressions/month │ │ Credits: 75/month │ │ │ │ ☐ Resource Library Banner (728x90) │ │ Contextual • Est. 2,000 impressions/month │ │ Credits: 50/month │ │ │ │ ☐ Email Newsletter │ │ Direct reach • Est. 10,000 recipients │ │ Credits: 150/send │ │ │ │ Selected: 2 placements │ │ Total Credits: 175/month │ │ │ └─────────────────────────────────────────────────────────────┘ ``` Upload ad images: ``` ┌─────────────────────────────────────────────────────────────┐ │ Creative Assets │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Homepage Banner (728x90) * │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ [Preview of uploaded banner] │ │ │ │ spring-banner-728x90.png │ │ │ │ [Change] [Remove] │ │ │ └─────────────────────────────────────────────────────────┘ │ │ Requirements: 728x90px, PNG/JPG, max 150KB │ │ │ │ Event Sidebar (300x250) * │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ [📷 Upload Image] │ │ │ │ Drag & drop or click to upload │ │ │ └─────────────────────────────────────────────────────────┘ │ │ Requirements: 300x250px, PNG/JPG, max 100KB │ │ │ │ Ad Copy (for all placements) │ │ Headline: [Discover Our Spring Collection ] │ │ CTA Text: [Learn More ] │ │ │ └─────────────────────────────────────────────────────────────┘ ``` Configure campaign timing: ``` ┌─────────────────────────────────────────────────────────────┐ │ Budget & Schedule │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Campaign Schedule │ │ Start Date: [March 15, 2025 ] │ │ End Date: [April 15, 2025 ] or ☐ Run indefinitely │ │ │ │ Credit Budget │ │ Your Balance: 500 credits │ │ Campaign Cost: 175 credits/month │ │ Duration: 1 month │ │ Total Cost: 175 credits │ │ │ │ ☐ Pause campaign when budget depleted │ │ ☑ Notify me when 75% budget consumed │ │ │ └─────────────────────────────────────────────────────────────┘ ``` Campaign summary: ``` ┌─────────────────────────────────────────────────────────────┐ │ Review Campaign │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Campaign: Spring Product Launch │ │ Objective: Lead Generation │ │ URL: https://acme.com/spring-offer │ │ │ │ Placements: │ │ • Homepage Banner (728x90) │ │ • Event Listings Sidebar (300x250) │ │ │ │ Schedule: March 15 - April 15, 2025 │ │ Cost: 175 credits │ │ │ │ ☐ I confirm assets comply with advertising guidelines │ │ │ │ [Save Draft] [Submit for Approval] │ │ │ └─────────────────────────────────────────────────────────────┘ ``` After approval: * Campaign goes live * Ads displayed in selected placements * Impressions and clicks tracked * Credits deducted ## Campaign Management ### Campaign Dashboard ``` ┌─────────────────────────────────────────────────────────────┐ │ My Campaigns │ ├─────────────────────────────────────────────────────────────┤ │ │ │ Spring Product Launch 🟢 Active │ │ March 15 - April 15, 2025 │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ Impressions: 12,450 │ Clicks: 342 │ CTR: 2.75% │ │ │ │ Credits Used: 87/175 │ Remaining: 88 │ │ │ └─────────────────────────────────────────────────────────┘ │ │ [View Details] [Pause] [Edit] │ │ │ │ Winter Webinar Series ⏸️ Paused │ │ Ended: February 28, 2025 │ │ [View Report] [Clone] [Archive] │ │ │ └─────────────────────────────────────────────────────────────┘ ``` ### Campaign Analytics | Metric | Description | | ----------- | ---------------------------------- | | Impressions | Times ad was displayed | | Clicks | Times ad was clicked | | CTR | Click-through rate | | Leads | Form submissions from landing page | | Cost | Credits consumed | ## Related Entities * [`Sponsorship`](/entities/core/sponsorship) * [`Company Profile`](/entities/core/company-profile) ## Related Journeys * [UJ-S-004](/sponsor/journeys/manage-sponsorships) * [UJ-S-016](/sponsor/journeys/view-analytics) ## Acceptance Criteria ### Frontend * [ ] Campaign creation wizard * [ ] Placement selection with previews * [ ] Creative asset upload with validation * [ ] Budget/schedule configuration * [ ] Campaign dashboard * [ ] Performance analytics * [ ] Pause/resume functionality ### Backend * [ ] `POST /api/sponsor/campaigns` - Create campaign * [ ] `PUT /api/sponsor/campaigns/{id}` - Update campaign * [ ] `POST /api/sponsor/campaigns/{id}/pause` - Pause * [ ] `GET /api/sponsor/campaigns/{id}/stats` - Analytics * [ ] Ad serving integration * [ ] Credit tracking ### Permissions * [ ] Sponsor admins can manage their campaigns * [ ] Organization approves campaigns (if required) ### Business Rules * [ ] Credits validated before activation * [ ] Asset dimensions enforced * [ ] Content guidelines checked * [ ] Schedule validated ### Error Handling * [ ] Asset validation errors * [ ] Insufficient credits warning * [ ] Approval rejection feedback