Complete user journey from discovery to conversion tracking
╔══════════════════════════════════════════════════════════════════════════════╗
║ MEMBER SHARING EXPERIENCE - COMPLETE FLOW ║
╚══════════════════════════════════════════════════════════════════════════════╝
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 1: MEMBER ONBOARDING & SETUP │
└──────────────────────────────────────────────────────────────────────────────┘
Member joins studio
│
▼
┌────────────────────────────┐
│ MEMBER RECORD CREATED │
│ • user_id linked │
│ • studio_id assigned │
│ • status: active │
└────────────────────────────┘
│
▼
┌────────────────────────────────────────┐
│ GENERATE REFERRAL IDENTIFIER │
│ • 8-char code (e.g., A7K9M2XQ) │
│ • Unique link generated │
│ • app.com/refer/A7K9M2XQ │
└────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────┐
│ SHOW ONBOARDING TOUR (optional) │
│ 1. "Here's your referral link" │
│ 2. "Share these assets" │
│ 3. "Track your progress" │
│ 4. "Earn rewards" │
└────────────────────────────────────────┘
│
▼
Member lands on Dashboard
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 2: MEMBER DASHBOARD VIEW │
└──────────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐
│ MEMBER DASHBOARD LAYOUT │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 🔗 YOUR REFERRAL LINK │ │
│ │ app.com/refer/A7K9M2XQ │ │
│ │ [Copy Link] [Email] [SMS] [Share More] │ │
│ │ Code: A7K9M2XQ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ 🎯 Clicks │ │ 👥 Leads │ │ ✅ Converted │ │
│ │ 47 │ │ 12 │ │ 3 │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 🎁 REWARDS PROGRESS │ │
│ │ ████████░░░░░░░░ $45 / $100 │ │
│ │ 1 more conversion to unlock $25 reward │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 📸 SHAREABLE ASSETS │ │
│ │ [Filter: All ▾] [Style: Friendly ▾] │ │
│ │ │ │
│ │ ┌────┐ ┌────┐ ┌────┐ ┌────┐ ┌────┐ │ │
│ │ │img │ │img │ │img │ │img │ │img │ │ │
│ │ └────┘ └────┘ └────┘ └────┘ └────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 📊 MY REFERRALS │ │
│ │ • John D. - Converted ✅ (3 days ago) │ │
│ │ • Sarah M. - Scheduled 📅 (today) │ │
│ │ • Mike R. - New 🆕 (2 hours ago) │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 3: ASSET SELECTION & PREVIEW │
└──────────────────────────────────────────────────────────────────────────────┘
Member clicks on asset
│
▼
┌────────────────────────────────────────┐
│ ASSET PREVIEW MODAL │
│ │
│ ┌────────────────────────────────┐ │
│ │ │ │
│ │ [Asset Image Preview] │ │
│ │ │ │
│ └────────────────────────────────┘ │
│ │
│ Caption Style: [Friendly ▾] │
│ │
│ ┌────────────────────────────────┐ │
│ │ Caption: │ │
│ │ "I love working out at │ │
│ │ FitLife Gym! Join me and get │ │
│ │ a free 7-day trial: │ │
│ │ app.com/refer/A7K9M2XQ" │ │
│ │ │ │
│ │ #fitness #gym #health │ │
│ └────────────────────────────────┘ │
│ │
│ [Copy Caption] [Edit Caption] │
│ │
│ Share to: │
│ [📷 Instagram] [👥 Facebook] │
│ [💬 WhatsApp] [📧 Email] │
│ [📱 SMS] [⬇️ Download] │
│ │
└────────────────────────────────────────┘
│
├─► Instagram: Download image + Copy caption
├─► Facebook: Native share API
├─► WhatsApp: Open with caption
├─► Email: mailto: with caption
├─► SMS: sms: with caption
└─► Download: Save image to device
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 4: SHARE ACTION & TRACKING │
└──────────────────────────────────────────────────────────────────────────────┘
Member clicks "Instagram"
│
▼
┌────────────────────────────────────────┐
│ SHARE HANDLER │
│ • Download asset image │
│ • Copy caption to clipboard │
│ • Show confirmation toast │
└────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────┐
│ CREATE SHARE_EVENT RECORD │
│ { │
│ asset_id: "uuid", │
│ member_id: "uuid", │
│ platform: "instagram", │
│ share_method: "download_image", │
│ caption_used: "...", │
│ referral_code: "A7K9M2XQ", │
│ device_type: "mobile", │
│ timestamp: NOW() │
│ } │
└────────────────────────────────────────┘
│
▼
┌────────────────────────────────────────┐
│ UPDATE ASSET PERFORMANCE │
│ Asset.performance.total_shares++ │
└────────────────────────────────────────┘
│
▼
Toast: "Image downloaded & caption copied!
Now post to Instagram 📸"
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 5: REAL-TIME NOTIFICATIONS │
└──────────────────────────────────────────────────────────────────────────────┘
When events occur:
┌────────────────────────────────────────────────────┐
│ NOTIFICATION TRIGGERS │
├────────────────────────────────────────────────────┤
│ │
│ 1. Link Clicked │
│ → "Someone clicked your referral link! 🎯" │
│ → Show in-app badge │
│ │
│ 2. New Lead Signup │
│ → "Great news! A new lead just signed up! 🎉" │
│ → Push notification (if enabled) │
│ → Email notification │
│ │
│ 3. Trial Started │
│ → "Your referral started their trial! 💪" │
│ │
│ 4. Conversion │
│ → "🎊 Your referral became a member!" │
│ → "You earned $25! Check your rewards." │
│ → Confetti animation │
│ │
│ 5. Reward Earned │
│ → "💰 New reward unlocked: $25 credit" │
│ → Update rewards balance │
│ │
│ 6. Weekly Summary (Sundays) │
│ → "📊 Your week: 5 clicks, 2 leads, 1 win!" │
│ → Best asset: "Free Trial Post" │
│ → Suggestion: "Post more on weekends!" │
│ │
└────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 6: PERFORMANCE INSIGHTS │
└──────────────────────────────────────────────────────────────────────────────┘
Dashboard "Insights" Section:
┌────────────────────────────────────────────────────┐
│ 💡 INSIGHTS & TIPS │
├────────────────────────────────────────────────────┤
│ │
│ Your Best Performers: │
│ ✓ Asset: "Free Trial Offer" (3 conversions) │
│ ✓ Platform: Instagram (60% of clicks) │
│ ✓ Time: Weekday mornings (9-11am) │
│ │
│ 🚀 Try This Week: │
│ • Post "Community Vibes" asset (trending) │
│ • Share on Facebook (untapped audience) │
│ • Post Tuesday 9am for best engagement │
│ │
│ 🎯 Goal Progress: │
│ ████████░░░░░░░░ 2 of 5 referrals │
│ 3 more to unlock Platinum tier perks! │
│ │
└────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 7: ERROR HANDLING & EDGE CASES │
└──────────────────────────────────────────────────────────────────────────────┘
Error Scenarios:
┌────────────────────────────────────────────────────┐
│ 1. No Assets Available │
│ → "Your studio hasn't added shareable assets │
│ yet. Check back soon!" │
│ → Show placeholder illustration │
│ │
│ 2. Program Paused │
│ → "⚠️ The referral program is currently │
│ paused. You can still view your stats." │
│ → Disable share buttons │
│ → Show contact studio button │
│ │
│ 3. Member Suspended │
│ → "Your referral access has been suspended. │
│ Contact studio management." │
│ → Hide referral link │
│ → Show support contact │
│ │
│ 4. Invalid Referral Code │
│ → "Something went wrong. Your referral link │
│ needs to be regenerated." │
│ → [Contact Support] button │
│ │
│ 5. Self-Referral Blocked │
│ → "❌ You cannot refer yourself!" │
│ → "Share with friends and family instead." │
│ │
│ 6. Duplicate Lead │
│ → "This person has already been referred to │
│ our studio." │
│ → "Try sharing with someone new!" │
│ │
│ 7. Share Platform Unavailable │
│ → "Sharing to [platform] is not available on │
│ this device." │
│ → "Try copying the link instead." │
│ │
│ 8. Network Error During Share │
│ → "Failed to track share. Your link is still │
│ active - try again!" │
│ → [Retry] button │
│ │
└────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ PHASE 8: FRAUD PREVENTION UI │
└──────────────────────────────────────────────────────────────────────────────┘
When suspicious activity detected:
┌────────────────────────────────────────────────────┐
│ ⚠️ ACTIVITY FLAGGED FOR REVIEW │
├────────────────────────────────────────────────────┤
│ │
│ Why was this flagged? │
│ • Multiple referrals from same IP address │
│ • Unusual referral pattern detected │
│ │
│ What happens now? │
│ • Your referral is under review │
│ • You can continue sharing normally │
│ • Studio management will review within 24 hours │
│ │
│ Need help? │
│ [Contact Support] │
│ │
└────────────────────────────────────────────────────┘
Self-Referral Blocked:
┌────────────────────────────────────────────────────┐
│ ❌ REFERRAL NOT ALLOWED │
├────────────────────────────────────────────────────┤
│ │
│ You cannot refer yourself! │
│ │
│ The referral system is designed for you to share │
│ with friends, family, and colleagues. │
│ │
│ 💡 Tip: Share your link on social media, send to │
│ your contacts, or tell people in person! │
│ │
└────────────────────────────────────────────────────┘
{
"member_dashboard_data": {
"member_info": {
"id": "uuid",
"user_id": "uuid",
"full_name": "string",
"email": "string",
"referral_code": "string (8 chars)",
"referral_link": "string (full URL)",
"member_since": "date",
"tier": "enum: bronze | silver | gold | platinum",
"status": "enum: active | inactive | suspended"
},
"performance_metrics": {
"total_clicks": "number",
"total_leads": "number",
"total_trials": "number",
"total_conversions": "number",
"conversion_rate": "number (percentage)",
"avg_time_to_convert": "number (days)",
"last_30_days": {
"clicks": "number",
"leads": "number",
"conversions": "number"
}
},
"reward_progress": {
"current_balance": "number (USD)",
"pending_rewards": "number (USD)",
"lifetime_earned": "number (USD)",
"lifetime_redeemed": "number (USD)",
"next_milestone": {
"target_conversions": "number",
"current_conversions": "number",
"reward_amount": "number",
"progress_percentage": "number"
},
"recent_rewards": [
{
"id": "uuid",
"amount": "number",
"status": "enum: pending | approved | fulfilled | redeemed",
"earned_date": "datetime",
"expires_date": "datetime | null"
}
]
},
"asset_library": {
"total_assets": "number",
"categories": ["array of strings"],
"assets": [
{
"id": "uuid",
"name": "string",
"category": "string",
"format": "string",
"file_url": "string",
"thumbnail_url": "string",
"caption_variants": {
"friendly": "string",
"energetic": "string",
"calm": "string",
"luxury": "string",
"humorous": "string"
},
"hashtags": ["array of strings"],
"recommended_platforms": ["array of strings"],
"my_shares": "number (how many times I've shared this)",
"my_conversions": "number (conversions from my shares)"
}
]
},
"recent_referrals": [
{
"id": "uuid",
"status": "enum: new | contacted | scheduled | visited | converted | lost",
"created_date": "datetime",
"scheduled_visit": "datetime | null",
"conversion_date": "datetime | null",
"reward_earned": "number | null"
}
],
"notifications": [
{
"id": "uuid",
"type": "enum: click | lead | trial | conversion | reward | weekly_summary",
"title": "string",
"message": "string",
"read": "boolean",
"created_date": "datetime",
"action_url": "string | null"
}
],
"insights": {
"best_performing_asset": {
"asset_id": "uuid",
"asset_name": "string",
"conversions": "number"
},
"best_performing_platform": {
"platform": "string",
"percentage": "number"
},
"suggested_actions": [
{
"action": "string",
"reason": "string",
"priority": "enum: high | medium | low"
}
]
}
},
"share_event": {
"id": "uuid",
"asset_id": "uuid",
"member_id": "uuid",
"studio_id": "uuid",
"platform": "enum: instagram | facebook | whatsapp | email | sms | copy_link",
"share_method": "enum: native_share | download_image | copy_caption | direct_link",
"caption_style_used": "enum: friendly | energetic | calm | luxury | humorous",
"caption_text": "string (actual caption shared)",
"referral_code": "string",
"device_type": "enum: mobile | tablet | desktop",
"browser": "string",
"session_id": "string",
"ip_address": "string",
"resulted_in_clicks": "number (tracked clicks from this share)",
"resulted_in_leads": "number",
"resulted_in_conversions": "number",
"share_timestamp": "datetime",
"tracking_active": "boolean (true until link expires)"
},
"notification": {
"id": "uuid",
"member_id": "uuid",
"type": "enum: click | lead_signup | trial_started | visit_scheduled | conversion | reward_earned | weekly_summary | fraud_alert | program_paused",
"priority": "enum: low | normal | high | urgent",
"title": "string",
"message": "string",
"icon": "string (emoji or icon name)",
"read": "boolean",
"dismissed": "boolean",
"action_required": "boolean",
"action_url": "string | null",
"action_label": "string | null",
"metadata": {
"lead_id": "uuid | null",
"reward_id": "uuid | null",
"amount": "number | null",
"asset_name": "string | null"
},
"created_date": "datetime",
"expires_date": "datetime | null"
},
"member_preferences": {
"member_id": "uuid",
"notifications_enabled": "boolean",
"email_notifications": "boolean",
"push_notifications": "boolean",
"weekly_summary": "boolean",
"favorite_assets": ["array of asset_ids"],
"preferred_caption_style": "enum: friendly | energetic | calm | luxury | humorous",
"preferred_share_platforms": ["array of platform names"],
"privacy_settings": {
"show_in_leaderboard": "boolean",
"share_stats_with_studio": "boolean"
}
}
}Page Title: "My Referrals"
Welcome Message: "Start sharing and earn rewards! 🎁"
Empty State: "No referrals yet. Share your link to get started!"
Loading State: "Loading your referral dashboard..."
Copy Link Button: "Copy Link" → "Copied!"
Copy Caption Button: "Copy Caption" → "Caption Copied!"
Instagram: "Share to Instagram"
Facebook: "Share to Facebook"
WhatsApp: "Share to WhatsApp"
Email: "Share via Email"
SMS: "Share via SMS"
Download: "Download Image"
✓ "Referral link copied!"
✓ "Caption copied to clipboard!"
✓ "Image downloaded & caption copied! Now post to Instagram 📸"
✓ "Shared successfully! We'll notify you when someone signs up."
✓ "Asset added to favorites ⭐"
🎯 "Someone clicked your referral link!"
🎉 "Great news! A new lead just signed up!"
💪 "Your referral started their trial!"
📅 "Your referral scheduled their first visit!"
🎊 "Amazing! Your referral became a member!"
💰 "You earned $25! Check your rewards."
📊 "Your week: 5 clicks, 2 leads, 1 conversion!"
✗ "Failed to copy to clipboard. Please try again."
✗ "Sharing not supported on this device."
✗ "You cannot refer yourself!"
✗ "This person has already been referred."
✗ "The referral program is currently paused."
✗ "Your referral access has been suspended. Contact support."
✗ "Failed to load assets. Please refresh the page."
✗ "Network error. Please check your connection."
💡 Referral Link: "Share this link to track referrals"
💡 Referral Code: "Your unique code: A7K9M2XQ"
💡 Caption Styles: "Choose the tone that matches your personality"
💡 Best Time to Post: "Weekday mornings get the most engagement"
💡 Conversion Rate: "Percentage of clicks that became members"
💡 Pending Rewards: "Awaiting verification before you can use them"
How It Works:
Tips for Success: