Comps.gg Documentation

Appearance

Marketing ​

Manage email campaigns, push notifications, SMS campaigns, and audience segments to engage your users.

Marketing Dashboard

Routes ​

  • /admin/marketing - Email campaigns
  • /admin/marketing/push-notifications - Push notifications
  • /admin/marketing/segments - Audience segments
  • /admin/marketing/sms - SMS campaigns

Overview ​

The Marketing section provides comprehensive tools for communicating with your users:

  • Email Campaigns - Send scheduled or immediate email broadcasts
  • Push Notifications - Engage users with browser notifications
  • SMS Campaigns - Reach users via text message
  • Audience Segments - Create and save reusable targeting criteria

Email Campaigns ​

Email Campaigns

Route ​

/admin/marketing

Statistics ​

  • Total Verified Users - Users eligible to receive emails
  • Opt-In Rate - Percentage of users who opted in to marketing
  • Opt-Out Rate - Percentage of users who unsubscribed

Campaign Composer ​

Campaign Composer

Creating a Campaign ​

  1. Navigate to /admin/marketing
  2. Enter campaign details:
    • Subject Line - Email subject (keep it compelling!)
    • Preview Text - Text shown in inbox preview
    • Content - Email body (supports HTML and Markdown)
  3. Preview the email
  4. Select recipients:
    • All verified users
    • Specific segments
    • Custom filters
  5. Schedule or send immediately
  6. Click "Send Campaign"

Best Practices ​

  • Subject Lines: Keep under 50 characters
  • Preview Text: Complement the subject, don't repeat it
  • Content: Mobile-friendly, concise, clear CTA
  • Timing: Test different send times
  • Frequency: Don't over-email your users

Campaign Scheduling ​

Campaign Scheduling

Schedule email campaigns to send at a future time:

Scheduling a Campaign ​

  1. Compose your email campaign as usual
  2. Instead of "Send Now", click "Schedule"
  3. Select date and time (must be at least 5 minutes in future)
  4. Review scheduled time in your local timezone
  5. Click "Schedule Campaign"

Managing Scheduled Campaigns ​

  • View all scheduled campaigns in the "Scheduled" tab
  • See scheduled send time and recipient count
  • Cancel scheduled campaigns before they send
  • Reschedule campaigns if timing needs to change

Test Before Scheduling ​

  • Use "Send Test Email" to preview before scheduling
  • Test emails are sent immediately to your admin email
  • Verify content and formatting before committing to schedule

Campaign History ​

Campaign History

View past campaigns:

  • Campaign name and subject
  • Send date and time
  • Recipients count
  • Delivery stats
  • Open rate
  • Click rate
  • Actions (view, duplicate, archive)

Analytics ​

For each campaign:

  • Sent - Total emails sent
  • Delivered - Successfully delivered
  • Opened - Users who opened
  • Clicked - Users who clicked links
  • Bounced - Failed deliveries
  • Unsubscribed - Users who opted out

Push Notifications ​

Push Notifications

Route ​

/admin/marketing/push-notifications

Statistics ​

  • Active Subscriptions - Users with push enabled
  • Total Sent - All-time push notifications sent
  • Delivered - Successfully delivered notifications
  • Failed - Failed deliveries

Notification Composer ​

Notification Composer

Creating a Notification ​

  1. Navigate to /admin/marketing/push-notifications
  2. Enter notification details:
    • Title - Bold headline (keep it short!)
    • Body - Notification text (under 120 characters)
    • Icon - Notification icon (optional)
    • Image - Rich notification image (optional)
    • URL - Destination when clicked
    • Action Buttons - Up to 2 action buttons
  3. Preview on different devices
  4. Select recipients:
    • All subscribers
    • Specific segments
    • By device type (desktop, mobile)
  5. Schedule or send immediately
  6. Click "Send Notification"

Best Practices ​

  • Title: Under 40 characters
  • Body: Under 120 characters for best display
  • Images: 1200x630px for optimal display
  • Timing: Respect user time zones
  • Frequency: Limit to important updates only
  • Value: Make every notification count

Notification History ​

View past notifications:

  • Notification title
  • Send date and time
  • Recipients count
  • Delivery stats
  • Click-through rate
  • Actions (view, duplicate, archive)

Automatic Instant Win Notifications ​

The system automatically sends push notifications when users win instant prizes:

How It Works ​

When a user claims an instant win prize:

  1. Order is completed and payment confirmed
  2. User reveals their instant win prize
  3. System automatically sends push notification to winner
  4. Notification includes prize details and next steps

Notification Content ​

Automatic notifications include:

  • Title: "Congratulations! You've won!"
  • Body: Prize name and brief description
  • Icon: Platform icon
  • Action: Direct link to user's prizes page

Configuration ​

Instant win notifications are:

  • Sent automatically (no manual action required)
  • Only sent if user has push notifications enabled
  • Delivered immediately upon prize claim
  • Tracked in notification history
  • Include order and prize reference for tracking

Viewing Automatic Notifications ​

All automatic instant win notifications appear in:

  1. Push Notification History
  2. Marked with "Instant Win" tag
  3. Include prize and order details
  4. Show delivery status

Benefits ​

  • Immediate Engagement - Users know instantly they've won
  • Increased Excitement - Real-time prize notification
  • Better Communication - Automated, consistent messaging
  • Reduced Support - Winners don't need to check manually
  • Improved Experience - Seamless winner notification flow

User Control ​

Users can:

  • Enable/disable push notifications in their settings
  • Continue to see prizes in their account regardless of notification settings
  • Receive email confirmation as a fallback

Note: Instant win notifications are sent in addition to the standard order confirmation email, which also includes prize details.

Audience Segments ​

Route ​

/admin/marketing/segments

Overview ​

Create and manage saved audience segments for targeted marketing campaigns. Segments allow you to define reusable groups of users based on specific criteria.

Audience Segments

Built-in Segments ​

Target specific user groups:

  • Active Users - Recently active on platform
  • Inactive Users - Haven't visited recently
  • High Spenders - Users with high order values
  • Competition Entrants - Users who entered competitions
  • Winners - Past winners
  • New Users - Recently registered

Creating Custom Segments ​

Create Segment

  1. Navigate to /admin/marketing/segments
  2. Click "Create Segment"
  3. Enter segment name and description
  4. Define criteria using available filters:

Available Criteria ​

  • Purchase History

    • Minimum total spent
    • Number of orders
    • Last purchase date

  • Last Activity

    • Active within days
    • Inactive for days

  • Account Age

    • Registered within period
    • Account older than period

  • Campaign Engagement

    • Opened previous campaigns
    • Clicked campaign links
    • Never engaged with campaigns

Logic Operators ​

Combine multiple criteria using:

  • AND - User must match all criteria
  • OR - User must match any criteria

Managing Segments ​

  • View Count - See how many users match each segment
  • Edit - Update segment criteria
  • Delete - Remove unused segments
  • Use in Campaign - Quick action to start campaign with segment

Using Segments in Campaigns ​

When creating email or push notification campaigns:

  1. In the recipient selection step
  2. Choose "Custom Segment"
  3. Select from your saved segments
  4. Preview recipient count before sending

Best Practices ​

  • Name segments descriptively (e.g., "High Value - 90 Days Inactive")
  • Review segment counts periodically as membership changes
  • Test campaigns with smaller segments first
  • Create segments for common marketing scenarios

SMS Campaigns ​

Route ​

/admin/marketing/sms

Overview ​

Send SMS marketing messages to users who have opted in to SMS communications.

SMS Campaigns

Creating an SMS Campaign ​

  1. Navigate to /admin/marketing/sms
  2. Compose your message:
    • Message Content - SMS text (keep under 160 characters for single SMS)
    • Recipients - Select audience segment
  3. Preview message and recipient count
  4. Schedule or send immediately
  5. Click "Send Campaign"

SMS Best Practices ​

  • Keep it short - SMS charges by message; stay under 160 characters
  • Clear CTA - Include a clear call to action
  • Identify sender - Start with your brand name
  • Include opt-out - Always provide unsubscribe option
  • Timing matters - Avoid early morning or late night sends
  • Compliance - Only send to users who have opted in

SMS History ​

View past SMS campaigns:

  • Campaign message
  • Send date and time
  • Recipients count
  • Delivery status
  • Opt-out count

SMS Queue ​

Monitor pending SMS deliveries:

  • View messages in queue
  • Track delivery status
  • Identify failed deliveries

Unsubscribe Handling ​

  • Users can unsubscribe via reply or web link
  • Unsubscribes are processed automatically
  • Suppressed numbers are excluded from future campaigns

Compliance ​

GDPR & Privacy ​

  • All marketing requires user opt-in
  • Unsubscribe link in every email
  • Honor opt-outs immediately
  • Keep records of consent
  • Allow users to manage preferences

Email Regulations ​

  • Include physical address
  • Provide clear sender identity
  • Honor suppression lists
  • Follow CAN-SPAM Act guidelines
  • Respect time zones for scheduling

Tips ​

  • Test emails before sending to all users
  • A/B test subject lines for better open rates
  • Segment for more relevant messaging
  • Monitor unsubscribe rates
  • Analyze performance to improve
  • Use push sparingly for best impact
  • Provide value in every communication
  • Respect user preferences and opt-outs