# Advertisements Platform — Analysis & Roadmap

## Current state

The Ads module (`api/ads.php`, `assets/ads/`) supports:

- **Watch-to-earn** — Members watch video/image ads and earn a share of campaign budget
- **Post ads** — Advertisers upload campaigns; viewers earn when ads are completed
- **Revenue split** — 60% viewer / 40% platform (see migration `034-ads-economics-60-40.sql`)
- **Subscriptions** — Optional watcher plans for premium ad access and higher daily caps

## Strengths

1. Integrated with main wallet — no separate payout system
2. Admin dashboard for campaigns, completions, and active subscriptions
3. Documented user flows in `docs/ads/`

## Gaps & improvements

### 1. Advertiser analytics dashboard
- Impressions, completion rate, cost per completion, geo/device breakdown
- Export CSV for campaign performance

### 2. Campaign targeting
- Age tier, VIP level, hub activity, deposit history segments
- Day-part scheduling (peak hours in EAT)

### 3. Fraud prevention
- Device fingerprinting for duplicate views
- Minimum watch time + interaction proof (tap to confirm)
- Rate limits per user per campaign per day

### 4. Creative review workflow
- Pending → approved → rejected states with admin notes
- Auto-reject on policy violations (text scan for prohibited content)

### 5. Payout transparency
- Show viewer exactly: gross campaign budget, platform fee, net earn per view
- Real-time "earnings today" widget on Ads hub home

### 6. Social + Ads cross-promotion
- Boost an ad campaign via Social Posts module
- Shared wallet debit for cross-module campaigns

### 7. Developer / partner API
- API keys for external ad networks to push creatives
- Webhook on `ad.completed` for partner reconciliation

## Revenue model summary

| Party | Share | Notes |
|-------|-------|-------|
| Viewer | 60% | Credited to wallet on verified completion |
| Platform | 40% | Operations, fraud review, infrastructure |
| Poster | Pays CPM/CPC budget | Debited from balance when campaign runs |

## Recommended next sprint

1. Viewer earnings breakdown UI in Ads hub
2. Campaign analytics tab (admin + poster self-service)
3. Fraud signals: IP + device hash deduplication
4. Partner webhook for completion events

## Technical references

- `docs/ads/TECHNICAL-SPEC.md` — DB schema and API actions
- `docs/ads/USER-FLOWS.md` — Member and advertiser journeys
- `migrations/031-ads-platform.sql` — Core tables