← Back to Dashboard
📋 Admin Help Guide
Learn how to create, customize, and manage your scratchcards effectively.
🚀 Quick Start: Create Your First Card
1
Sign In — Click "Sign in with Google" on the admin dashboard.
2
Click "+ New Card" — Opens the creation form.
3
Set Title & Win Rate — Give your card a name and set the win percentage (e.g., 20%).
4
Add Prizes — Enter at least one prize (e.g., "Free Coffee", "10% Discount").
5
Add Losing Messages — Enter messages shown when users don't win.
6
Click "Create Scratchcard" — You'll get a shareable link!
🎨 Design & Branding
Background Presets
Choose from 5 theme presets: Simple Gradient, Dark Geometric, Soft Pastel, Neon Vibes, and Gold Luxury. Each preset sets the page background, card colors, and accent colors automatically.
Google Fonts
Type any Google Font name (e.g., "Lobster", "Playfair Display"). The font loads dynamically on the player's page.
Scratch Layer Image
Upload an image URL to replace the default silver scratch surface. Great for branded scratch-off experiences. The image covers the entire card area.
Revealed Image (Behind Scratch)
Set an image that appears behind the scratch layer — the image players see when they scratch. Perfect for brand logos, promotional graphics, or themed artwork.
Custom CSS
For advanced users: inject your own CSS rules to fine-tune the player page appearance.
💡 Tip: Use the Custom CSS field to target .card-wrapper, .card-title, or .result-layer for precise control.
🌍 Localization
Override the default English text strings for any language:
- Instructions — Text on the scratch hint (default: "Scratch here!")
- Win Title — Heading shown on a win (replace "You Won!")
- Lose Title — Heading shown on a loss (replace "Better luck next time")
- Claim Button — Text on the code copy button
💡 Example: For Spanish, set Instructions to "¡Rasca aquí!", Win Title to "¡Ganaste!", Lose Title to "Mejor suerte la próxima vez"
🎰 Prize Configuration
Unlimited Pool (Default)
Prizes are randomly selected from your list with no quantity limits. The win rate determines how often someone wins — not which prize they get.
Finite Pool
Toggle "Finite Prize Pool" to set a specific quantity for each prize. When all quantities are claimed, the card shows "All prizes claimed!" and no more plays are possible.
⚠️ Note: When editing a card, you can choose to "Reset Progress" which resets all play counts and claimed prizes to zero. Use carefully!
🎣 Lead Generation
Enable lead capture to collect user information before they scratch:
- Name — Always collected (required).
- Email — Optional, toggle on/off.
- Phone — Optional, toggle on/off.
Leads appear on your dashboard and can be downloaded as CSV files.
🔗 Integrations
Webhooks
Enter a webhook URL (Zapier, Make, Slack) to receive real-time notifications for every win and lead. Use the "Test Connection" button to verify.
🎮 Gamification
- Second Chance Action: Show a CTA button to losers (e.g., "Get 10% Off Anyway" → links to your store).
- Social Share: Enable share buttons (WhatsApp, Twitter, Link Copy) after scratching.
- Win Effects: Choose from Confetti 🎊, Fireworks 🎆, Stars ⭐, or None.
🔒 Access Control
- Public — Anyone with the link can play.
- Password — Requires a password to unlock the card.
- Email List — Only whitelisted emails can access.
- Signed Link — Requires a cryptographic signature (for programmatic distribution).
📊 Understanding Your Stats
- Views — Page loads (including bots, multiple visits).
- Plays — Actual scratch attempts.
- Wins — Winning outcomes.
- Leads — Form submissions.
- CTR — (Plays ÷ Views) × 100%. Higher is better.
🛡️ Fairness Guarantee
All outcomes are determined server-side using cryptographically secure randomness (crypto.randomInt). The client never controls or predicts the result. Each browser session gets a unique token — refreshing the page returns the same result, preventing users from gaming the system.