Wagering

BetSync Wagering Module Documentation

Overview

The BetSync Wagering Module is a comprehensive system designed to track user wagering activities across various casino platforms, manage leaderboard competitions, and provide detailed statistical insights. This documentation outlines the key features, functionality, and technical implementation of the module.

Supported Casino Platforms

BetSync currently supports integration with the following casino platforms:

  • Roobet: Full integration with multiplier tracking

  • Stake.com: Integration via Google Sheets data

  • Stake.us: Integration via Google Sheets data

  • PackDraw: API integration

  • Shuffle: API integration

  • Rain.GG: API integration with optional campaign code support

  • EmpireDrop: API integration using public/private key authentication

Casino Platforms Management

Overview

The Casino Platforms section allows administrators to integrate and manage connections with various casino providers. Each platform integration enables tracking of user wagering data for analytics and leaderboard competitions.

Key Features

  • Platform Integration: Connect with multiple casino platforms through their respective APIs

  • API Status Monitoring: Test API connections to ensure data is being properly tracked

  • Platform Statistics: View detailed wagering statistics for each integrated platform

  • Custom Leaderboards: Create and manage multiple wagering leaderboards for each platform

Managing Platforms

  1. Adding a Platform:

    • Click the "Add Platform" button

    • Enter a name for the platform

    • Select the platform type from the dropdown

    • Configure API credentials specific to the selected platform type:

      • Roobet: API Key and User ID

      • Stake.com/Stake.us: Google API Key, Current Month Sheet ID, Past Month Sheet ID

      • PackDraw/Shuffle/Rain.GG: API Key

      • EmpireDrop: Public Key and Private Key

    • Configure platform-specific settings (if applicable):

      • Roobet: Multiplier Threshold

    • Save to establish the connection

  2. Editing a Platform:

    • Click the edit icon for an existing platform

    • Update name, API credentials, or settings as needed

    • Save changes to update the connection

  3. Managing Platform Status:

    • Toggle the visibility/status of a platform using the eye icon

    • Active platforms will track wagering data and display on the frontend

    • Inactive platforms are hidden from users but retain all historical data

  4. Testing API Connection:

    • Click "Test Connection" to verify the API credentials are working

    • The system will communicate with the platform's API and report the result

  5. Removing a Platform:

    • Click the delete icon for an existing platform

    • Confirm deletion in the prompt

    • Note: This action will remove all associated leaderboards and data

Leaderboard Management

Overview

Leaderboards allow you to create wagering competitions for users across integrated casino platforms. Users earn positions based on their total wager amounts during the competition period.

Key Features

  • Multiple Time Periods: Create weekly, bi-weekly, or monthly competitions

  • Flexible Start Days: Configure when each competition period begins

  • Custom Prize Pools: Set prize amounts and distribution across positions

  • Currency Options: Support for USD, EUR, and GBP prize pools

  • Active/Inactive Toggle: Easily enable or disable leaderboards

Creating and Managing Leaderboards

  1. Creating a Leaderboard:

    • Navigate to a platform's Leaderboards page

    • Click "Create Leaderboard"

    • Configure the following settings:

      • Leaderboard Name: Display name for the competition

      • Timeframe: Weekly, Bi-Weekly, or Monthly

      • Start Day:

        • For weekly/bi-weekly: Choose a day (1-7, Monday to Sunday)

        • For monthly: Choose a day (1-31)

      • Prize Pool: Total amount to be distributed

      • Currency: USD, EUR, or GBP

      • Prize Distribution: Amount for each ranking position

    • Click "Save Leaderboard" to create

  2. Editing a Leaderboard:

    • Click the edit icon for an existing leaderboard

    • Update any settings as needed

    • Prize distributions can be completely restructured

    • Save changes to update the leaderboard

  3. Managing Status:

    • Toggle the active status of a leaderboard using the eye icon

    • Active leaderboards will be visible to users and track wagering data

    • Inactive leaderboards are hidden but retain all data

  4. Viewing Leaderboard Details:

    • Click "View Details" to see the full leaderboard configuration

    • Review prize distribution and current competition data

  5. Deleting a Leaderboard:

    • Click the delete icon for an existing leaderboard

    • Confirm deletion in the prompt

    • This action permanently removes the leaderboard and its data

Platform Statistics

Overview

The Statistics module provides comprehensive insights into user wagering activity across all connected platforms, helping administrators understand user behavior and platform performance.

Key Features

  • Time Period Filtering: View data for current month, last month, all time, or custom date ranges

  • Key Metrics: Track total wagered amounts, daily averages, user counts, and average wagers per user

  • Game Analysis: Identify popular games and track player preferences

  • Multiplier Tracking: View highest multipliers and payouts across the platform (for supported platforms)

  • Detailed User Data: See ranked user lists with comprehensive wagering information

  • Search Functionality: Quickly find specific users in the data table

Navigating Statistics

  1. Selecting Time Periods:

    • Use the period controls at the top of the page to switch between:

      • Current Month

      • Last Month

      • All Time

      • Custom Date Range (select specific start and end dates)

  2. Viewing Key Metrics:

    • The dashboard displays critical KPIs:

      • Total Wagered: Overall wagering volume with period-over-period comparison

      • Daily Average: Average daily wagering amount

      • Total Users: Number of unique players, with linked vs. unlinked breakdown

      • Average Per User: Average wagering amount per player

  3. Exploring Game Data:

    • The Popular Games section shows the most played games with:

      • User counts

      • Total wagered amounts per game

      • Game-specific details

  4. Analyzing Top Multipliers (for supported platforms):

    • View the highest multipliers achieved by users

    • See associated bet amounts and payouts

    • Track which games produce the highest multipliers

  5. Using the Data Table:

    • The detailed wagering table shows ranked user data

    • Search for specific users using the search input

    • View comprehensive user metrics including:

      • Wagered amounts

      • Linked account status (if the platform connects to BetSync user accounts)

      • Favorite games

      • Campaign attribution (when available)

      • Avatar (when available)

Technical Implementation

Data Fetching and Caching

  • The system uses platform-specific API integrations to fetch wagering data

  • All data is cached for performance optimization (default: 1 hour for wagering data, 10 minutes for leaderboard data)

  • Period-specific statistics are calculated on-demand based on the selected date range

Platform-Specific Implementations

  1. Roobet:

    • Uses direct API integration with authentication via API key

    • Supports multiplier tracking and game-specific data

    • User account linking is supported

  2. Stake.com/Stake.us:

    • Integration via Google Sheets API

    • Requires separate sheet IDs for current and past month data

    • Data is structured with separate ranges for different time periods

  3. EmpireDrop:

    • Uses public/private key authentication

    • Supports timestamp-based date filtering

    • Provides detailed user data including avatars and user levels

  4. PackDraw:

    • Uses API key authentication

    • Requires dates in m-d-Y format with explicit start/end of day

  5. Rain.GG:

    • Uses API key authentication via x-api-key header

    • Supports optional campaign code filtering

    • Provides user avatars and IDs

  6. Shuffle:

    • Simple API key authentication

    • Timestamp-based date filtering

    • Includes campaign code data when available

Statistics Calculation

The system calculates various statistics for the selected time period:

  • Basic Metrics: Total wagered, weighted wagered, user counts, averages

  • User Categories: Classification of users into high, medium, and low wagers

  • Game Statistics: Popular games, top wagered games, unique game counts

  • Multiplier Statistics: Top multipliers, average multipliers, highest payouts

  • Trend Analysis: Daily and weekly trends, averages, user activity patterns

Data Presentation

  • Statistics are displayed with period-over-period comparisons when available

  • The system adapts the UI based on platform capabilities (e.g., showing multiplier data only for supported platforms)

  • Trend data is available for detailed analysis of patterns over time

Best Practices

  • Create leaderboards with reasonable timeframes to maintain user engagement

  • Distribute prizes across multiple positions to encourage broader participation

  • Regularly test API connections to ensure continued data flow

  • Use custom date ranges for detailed analysis of promotional periods

  • Configure start days strategically to align with your community's peak activity

  • For Stake integrations, ensure Google Sheets are properly formatted with required headers

  • For platforms with campaign tracking, use consistent campaign codes across promotions

For additional support with the BetSync Wagering Module, please contact [email protected].

PreviousQuestsNextSetup Stake/Stake.us

Last updated