Skip to main content

​
Raffle Management Guide

This guide details how to manage raffles (giveaways) in the Celtic Portal. Raffles are a powerful engagement tool that drives user participation, builds excitement, and rewards your community. Whether you’re running product giveaways, experience prizes, or promotional campaigns, this comprehensive guide covers creation, Webflow synchronization, entry management, payment integration, winner drawing, and analytics.

​
Common Use Cases

  • Product Launches: Generate buzz around new products with exclusive giveaway campaigns
  • User Acquisition: Attract new users with low-barrier or free entry raffles
  • Community Engagement: Reward loyal users with points-based entry options
  • Revenue Generation: Offer premium raffles with paid entries and tiered pricing
  • Partnership Campaigns: Run co-branded giveaways with partners and sponsors
  • Seasonal Events: Create time-limited holiday or special event raffles
API Integration Available: All raffle operations can be performed programmatically via the Celtic API, enabling integration with your custom applications, automation workflows, and third-party services. See the API Reference for complete documentation.

​
Table of Contents

  1. Accessing the Raffles Dashboard
  2. Creating Raffles
  3. Managing Raffles
  4. Entry Management
  5. Payment Integration
  6. Drawing Winners
  7. Reporting and Analytics

​
Accessing the Raffles Dashboard

Navigate to the Raffles section in the main dashboard sidebar. This page provides a grid view of all your raffle campaigns, along with key metrics and management tools.

​
Creating Raffles

There are two ways to bring raffles into the system: automatically syncing from Webflow (recommended for CMS-driven sites) or manually creating them.

​
Option A: Webflow Sync (Smart Sync)

This method imports raffle data directly from your Webflow CMS collection. Prerequisites:
  • The site configuration must have a valid webflow_token.
  • A raffles_collection_id should be configured (though you can override this during sync).
Steps:
  1. Click the Smart sync button (folder sync icon) in the top toolbar.
  2. A dialog will appear showing the configured Collection ID.
  3. Optional: Toggle “Change Collection ID” if you need to sync from a different collection for this specific run.
  4. Click Start sync.
  5. The system will import new raffles and update existing ones. A success message will confirm the number of synced items.
API Reference: Trigger Webflow synchronization programmatically using the Sync Raffles from Webflow endpoint.

​
Option B: Manual Creation

For raffles not managed in Webflow, you can create them directly in the portal.
  1. Click the + Create raffle button in the top right.
  2. You will be taken to the Create Raffle page, which contains several tabs for detailed configuration:
    • Basic: Name, Slug (URL friendly), Images (Main & Gallery), and Descriptions.
    • Status: Toggle Draft mode and set important dates (Start, End, Published, Drawn). Note: Timezone defaults to your browser’s local time but can be adjusted.
    • Pricing: Set the displayed price, currency, and points required for entry.
    • Content: Configure the Hero section, detailed HTML/Markdown description, and Prize details (“What You Can Win”).
    • Campaign: Marketing details like CTA text, Campaign Name, and Giveaway Type.
    • Checkout: Success/Failure URLs and checkout descriptions.
    • Discounts: Configure Discount Tiers (buy X get Y% off) and Upsells.
    • Email: Customize branding colors and content for transactional emails related to this raffle.
    • IDs: Manually link external IDs (Webflow Item ID, Revolut Product ID, etc.).
  3. Click Create Raffle to save.
API Reference: Create raffles via the Create Raffle endpoint. All fields available in the UI can be set programmatically.

​
Managing Raffles

​
Viewing and Filtering

  • Search: Use the search bar to find raffles by name.
  • Filter: Use the status dropdown to view All, Active, or Inactive raffles.
  • Sort: Raffles are sorted by End Date (latest first) by default.
API Reference: Retrieve raffles using List Raffles, get a specific raffle by ID with Get Raffle, by slug with Get Raffle by Slug, or by Webflow item ID with Get Raffle by Item ID.

​
Editing and Deleting

To Edit a Raffle:
  1. Click on the raffle card to view details.
  2. Click the Edit button.
  3. Make your changes across the various tabs.
  4. Click Save Changes.
API Reference: Update raffles using the Update Raffle endpoint.
To Delete a Raffle:
Deleting a raffle is permanent and will remove all associated entries and data. This action cannot be undone.
API Reference: Delete raffles via the Delete Raffle endpoint.

​
Bulk Actions

You can apply actions to multiple raffles at once.
  1. Select raffles by clicking the checkbox on their card/row.
  2. To apply discount tiers, click the Apply discount tiers button in the toolbar.
  3. Configure the tiers in the dialog and save to update all selected raffles.

​
Entry Management

​
Entry Types

The Celtic platform supports multiple entry methods to maximize participation and engagement:
  • Free Entries: Users can submit one free entry per raffle without any cost, encouraging maximum participation
  • Paid Entries: Users purchase entries at the configured price point, with support for multiple entry purchases
  • Points Entries: Users redeem their loyalty points to enter raffles, driving platform engagement
  • Bonus Entries: Additional entries can be awarded through promotional campaigns or special actions

​
Joining Raffles

Users can join raffles through the platform interface or programmatically: Through the Platform:
  1. Browse active raffles in the giveaways section
  2. Select desired number of entries (for paid/points raffles)
  3. Complete the entry process (payment or points redemption)
  4. Receive confirmation and entry details
Entry Methods:
  • Direct Purchase: Pay for entries using supported payment methods
  • Points Redemption: Use earned points to enter without payment
  • Free Entry: Submit a single free entry if available
API Reference: Manage raffle entries programmatically:

​
Payment Integration

The Celtic Portal integrates with Revolut and other payment providers to handle paid raffle entries securely and efficiently.

​
Checkout Flow

  1. Entry Selection: User selects the number of raffle entries to purchase
  2. Checkout Session: System creates a secure checkout session with payment provider
  3. Payment Processing: User completes payment through the payment provider’s interface
  4. Webhook Notification: Payment provider sends webhook to confirm transaction status
  5. Entry Confirmation: Upon successful payment, entries are added to the user’s account
  6. Email Confirmation: User receives detailed confirmation email with entry details
API Reference: Manage checkout sessions and payment flows:

​
Webhook Handling

The platform uses webhooks to receive real-time notifications about payment events:
  • Payment Success: Automatically credit entries to the user’s account
  • Payment Failure: Log the failed transaction and notify the user
  • Refund Processing: Handle entry removal if a payment is refunded
  • Security Validation: All webhooks are validated using provider-specific signatures
Security: Always validate webhook signatures to ensure requests are authentic. The system automatically handles webhook signature verification.
API Reference: Handle payment webhooks with the Handle Revolut Webhook endpoint for Revolut payments.

​
Reporting and Analytics

The portal provides comprehensive reporting and analytics to help you track raffle performance and optimize campaigns.

​
Available Reports

Raffle Reports: Access detailed analytics for individual raffles or across all campaigns.
  • Entry Metrics: Total entries, unique participants, entry types breakdown
  • Revenue Data: Total revenue, average revenue per user, payment method distribution
  • Engagement Stats: Conversion rates, social sharing metrics, time-based entry patterns
  • User Demographics: Participant locations, account ages, previous participation history
API Reference: Access comprehensive raffle analytics:

​
Key Performance Indicators

Track these metrics to measure raffle success:
  • Total Entries: Overall participation level across all entry methods
  • Unique Participants: Number of distinct users who entered
  • Revenue Generated: Total income from paid entries
  • Average Entry Value: Revenue divided by total paid entries
  • Points Redeemed: Total loyalty points used for entries
  • Free vs Paid Ratio: Balance between free and paid participation

​
Export and Integration

  • Export Options: Download reports in CSV or JSON format for external analysis
  • API Access: Integrate raffle analytics into your custom dashboards and BI tools
  • Real-time Data: All endpoints provide real-time data for up-to-date insights

​
Drawing Winners

When a raffle has ended, you can perform a fair, random draw to select a winner. The platform uses Random.org to ensure true randomness and transparency in the selection process.

​
Why Random.org?

Random.org generates true random numbers using atmospheric noise, which is superior to the pseudo-random number algorithms typically used in computer programs. This ensures:
  • True Randomness: Results are unpredictable and cannot be manipulated
  • Transparency: Third-party verification of the randomness source
  • Fairness: Equal probability for all entries, regardless of entry method
  • Auditability: Complete logs of the random number generation process

​
The Draw Process

  1. Navigate to the raffle’s detail view (click on the raffle in the grid).
  2. Click the Draw tab or button (typically found in the raffle details or context menu).
  3. The Draw page will show the total number of entries.
  4. Click Draw Winner.
    • The system uses Random.org to ensure true randomness.
    • It selects from all individual entries (if a user bought 10 tickets, they have 10 chances).
  5. Once complete, the winner’s Email and User ID will be displayed.
API Reference: Perform draws and retrieve winner information:

​
Audit Logs

For transparency and compliance, every draw generates a complete audit log.
  • After the draw, click the Download button in the “Audit Log” section.
  • This JSON file contains:
    • Timestamp of the draw.
    • Total unique users and entries.
    • Breakdown of entries per user (Paid, Free, Points, etc.).
    • Exact details of the random number generation process.
    • Random.org API response data for verification.
Keep audit logs for regulatory compliance and to provide transparency to participants. These logs can be used to verify the fairness of the draw if questions arise.