# AZCHESS Streamer Growth Plan (Deferred Track)

Status: Deferred for future implementation
Owner: Product + Growth + Engineering
Last updated: 2026-03-22

## 1) Objective

Build a streamer toolset that helps creators promote AZCHESS and brings measurable user growth through trackable campaigns, while keeping integration lightweight for live streams.

## 2) Current decision

This track is intentionally paused while coaching features are prioritized.
No active engineering execution should happen for streamer items until coaching milestones are completed.

## 3) Success metrics (to track when implementation starts)

- Attribution
  - % of new signups attributed to streamer links/codes
  - Click -> signup conversion rate per streamer
- Activation
  - % of attributed signups that play at least 1 game in first 24h
  - % of attributed signups that complete onboarding
- Retention
  - D1/D7 retention for attributed users
- Creator performance
  - Top streamer leaderboard by qualified signups
  - Campaign-level performance (events, overlays, promo windows)

## 4) MVP scope (Phase 1)

1. Streamer profile + identity
   - Internal streamer record linked to AZCHESS user
   - Public alias/display name
2. Referral links and promo codes
   - Unique referral URL per streamer
   - Optional short promo code for manual entry
   - Cookie + server attribution capture
3. Streamer dashboard
   - Clicks, signups, activation, active users
   - Date range and simple export (CSV)
4. On-stream promo assets
   - Dynamic QR code that embeds referral URL
   - Copy-ready panel text ("Play on AZCHESS with my link")
5. Basic anti-abuse controls
   - Bot filtering heuristics
   - Duplicate attribution guardrails

## 5) Phase 2 scope (post-MVP)

- Campaign management (time-bound events, tournament-linked campaigns)
- Overlay widget endpoints (OBS/browser source friendly)
- Revenue share or reward ledger (if business model requires it)
- Team/agency support (multiple creators under one manager account)
- Enhanced fraud analytics and anomaly alerts

## 6) Functional requirements

- Create, rotate, and disable referral links
- Attribute installs/signups using URL params and first-touch timestamps
- Preserve attribution on auth/login redirects when possible
- Show per-streamer analytics with near-real-time counters
- Generate branded QR code assets in multiple sizes
- Support localization for streamer-facing and user-facing promo text

## 7) Technical outline

- Data model (proposed)
  - `streamers` (id, user_id, alias, status, created_at)
  - `streamer_links` (id, streamer_id, code, destination, active, created_at)
  - `streamer_attribution_events` (id, link_id, event_type, session_id, user_id, ts, metadata)
  - `streamer_campaigns` (id, streamer_id, title, starts_at, ends_at, settings)
- API (proposed)
  - `POST /api/streamers/register`
  - `POST /api/streamers/links`
  - `GET /api/streamers/analytics`
  - `GET /api/streamers/qr`
- Frontend (proposed)
  - Streamer dashboard page
  - Referral link manager UI
  - Promo asset generator UI

## 8) Non-functional requirements

- Fast dashboards (target p95 under 500ms for summary cards)
- Event ingestion resilient to traffic spikes during live streams
- Privacy-safe analytics (no unnecessary personal data exposure)
- Observability: event counts, attribution drop-off alerts

## 9) Risks and mitigations

- Attribution loss due to cross-device journeys
  - Mitigation: fallback code entry + post-signup linking
- Fraud/low-quality traffic
  - Mitigation: quality filters and delayed qualification windows
- Scope creep into full creator economy features too early
  - Mitigation: hard-gate to Phase 1 MVP deliverables

## 10) Delivery order when resumed

1. Tracking foundation (events + attribution)
2. Link management + redirect handling
3. Dashboard summary metrics
4. QR/promo asset generation
5. Anti-abuse improvements

## 11) Dependencies

- Product policy for creator eligibility
- Analytics/event storage strategy
- Legal/privacy review for tracking disclosures
- Design assets for branded overlays and QR cards

## 12) Definition of done for Phase 1

- Streamer can self-serve a referral link and QR code
- New users can be attributed reliably in analytics
- Dashboard shows conversion funnel metrics by date range
- Internal team can identify top-performing streamers from data
