Advertisement Overview

The Advertisement module lets you centrally create and manage promotional banners / images / future video or text assets that can appear in multiple areas of the dashboard (e.g. home, side panels in later releases). Currently the Banner (image) type is supported first; additional types (text, video, etc.) will be added later.

Key Concepts

• Advertisement: A single display unit composed of title, description, type, content (image / text etc.), link URL, schedule (start/end date), targeting (language, device, countries), display order, and status.
• Ad Type: UI default is Banner. Each type can require different fields (e.g. image, video URL). Unsupported types will be introduced with extended UX later.
• Status: Active (eligible for display) or Inactive (stopped). Ads that pass their end date may automatically stop showing depending on implementation policy.
• Display Order (order): Determines priority when multiple ads occupy the same area. Lower numbers usually appear first (exact load logic may evolve).
• Targeting: Restrict exposure to specific user groups by language, device type, and selected countries (multi-select).

Screen Structure

1. List Page (/advertisement)
   • Top: title/description search, type filter, status filter, refresh, "New Ad" button
   • Table Columns: Title, Ad Type, Start Date, End Date, Status, Language, Device Type, Countries, Order, Created At, Actions
   • Empty State: "No advertisements" with pagination (page size 10/20/50/100)
2. Create Page (/advertisement/create)
   • Sections: Basic Information, Content Settings, Schedule Settings, Targeting Settings, Create button at bottom
3. Detail Page (/advertisement/[id])
   • (After load) Summary of Basic / Content / Schedule / Targeting + future edit & delete actions
4. Edit Page (/advertisement/[id]/edit)
   • Same form structure as create + prefilled existing data

If there is no data or the ID is invalid, the detail/edit pages may show a loading state ("Loading data"). In production a valid ID reveals all fields.

Typical Flow

1. Create a new ad (fill required fields)
2. Manage via list filters (status / period / type)
3. Edit as needed (extend schedule, replace image)
4. After exposure ends, deactivate or re-activate later

Usage Examples

• New feature announcement banner: Show only to users in selected countries/languages for 2 weeks
• Seasonal event banner: Clear start/end dates, auto stop after event
• Multi-device campaign: Create separate desktop and mobile variants

Planned Extensions (Roadmap)

• Additional ad types (text, video)
• Impression / click analytics dashboard
• A/B testing (automated rotation by performance or order)
• Advanced targeting integration with funnels and segments