MOP 3.2 — Digital Signage & Ad Creation¶

Audience: super_admin, society_admin Outcome: A library of banner / video creatives that can be placed in the mobile app, the captive Wi-Fi portal (MOP 3.4) and on physical digital-signage displays inside the society.

1. Concepts¶

advertising_types         # category (banner, splash, native, video, …)
ad_slot_templates         # canvas size & duration constraints per surface
advertising_assets        # the actual PNG/MP4 in MinIO
advertisements            # campaign: asset + slot + targeting + schedule
ad_interactions           # impressions / clicks / dismisses

Targeting rules: society_id list, child_society_id list, role list (resident / vendor / guest), date window, frequency cap.

2. Create an ad¶

Sidebar → Ads → + Create Ad. 1. Pick the Type (Splash / Top Banner / Coaching Card / Wi-Fi Portal / Digital Signage Display). 2. Pick the Slot template that fits (auto-validates dimensions / duration on upload). 3. Upload the asset (PNG ≤ 5 MB or MP4 ≤ 30 s). 4. Set targeting: society / phase / role / start–end / frequency. 5. Pricing comes from MOP 3.2-pricing (per slot, per society subscription plan); revenue is shown live in Revenue sidebar.

3. Manage Ad Types (super admin only)¶

Sidebar → Ads → Manage Types → add / edit slot templates so society admins can pick the right canvas size when uploading.

4. APIs touched¶

Method	Endpoint
GET / POST	`/api/admin/ad-types`
GET / POST	`/api/admin/ad-slot-templates`
POST	`/api/admin/advertising-assets` (multipart upload to MinIO)
GET / POST	`/api/admin/advertisements`
GET	`/api/ads/active?surface=&society_id=` (public; consumed by mobile / portal)
POST	`/api/ads/{ad_id}/interaction` (impression / click)

5. Edge cases & FAQ¶

Asset reused across surfaces → keep one advertising_assets row, but one advertisements row per surface (different slot template).
Phase-bound admin can only target their own phase.
Frequency cap is evaluated client-side using ad_interactions last N days. Soft eviction once cap is hit.

MOP 3.4 — Wi-Fi Portal Ads
MOP 1.3 — Phase Isolation (targeting honours it automatically)