> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/bi-and-reporting/raffles.md).

# Raffles

## Overview

The Raffles Dashboard provides a statistical and analytical overview of your Raffles-related KPIs. It is designed to help you monitor, manage, and optimize your business usage of the Raffles Gamification feature, and make data-driven decisions.

The dashboard is divided into four tabs: **Raffles Effect**, **Raffles Info**, **Raffles Issuing**, and **Raffles Prizes**.

To access the Raffles Dashboard, navigate to **Reports** › **Gamification** › **"Raffles"**.

You can select filters including **Period**, **Raffle Name / ID**, **Brand**, and **User Value Score**.

***

## Summary

### Raffles Effect Tab

The **Raffles Effect** tab measures the behavioral impact of Raffle participation on players' financial activity. It compares key metrics between days when users had Raffle-related activity and days when they did not.

**Population (KPI ribbon)** Displays the total number of users the analysis is based on — specifically, users who had **at least 3 days with Raffle activity** and **at least 3 days without Raffle activity** during the last 90 days. This qualifying population ensures a fair like-for-like comparison.

**AVG Daily Bet Amount** A bar chart comparing the average daily Bet Amount on Raffle-active days versus non-Raffle days. A higher bar on the Raffle-active side indicates that participation in Raffles correlates with increased wagering.

**AVG Daily Bet Count** A bar chart comparing the average number of bets placed per day, split by Raffle activity. This helps identify whether Raffles drive more frequent betting behaviour, not just higher stakes.

**AVG Daily Deposit Count** A bar chart comparing the average number of deposits made per day between the two populations. This provides insight into whether Raffle participation correlates with higher deposit frequency.

**AVG Daily Deposit Amount** A bar chart comparing the average deposit value per day between Raffle-active days and non-Raffle days. Together with Deposit Count, this gives a full picture of the deposit impact associated with Raffle engagement.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FQBl0SYuZYuaVAMAvsnLJ%2Fimage.png?alt=media&amp;token=70618b71-74f0-4586-9ec6-4541b68dd3a0" alt=""><figcaption></figcaption></figure>

> **How to use this tab:** This tab is your primary tool for quantifying the ROI of the Raffles product. If the Raffle-active bars consistently outperform the non-active bars, it signals that Raffles are driving meaningful uplift in player activity. Use this to build the business case for scaling your Raffle programme or to validate whether a specific Raffle configuration is generating a measurable effect.

***

### Raffles Info Tab

The **Raffles Info** tab presents a management-level summary of all active Raffles and compares indicative versus actual ticket and prize metrics.

**Stats per Raffle / General (table)** A per-Raffle summary table providing a snapshot of each Raffle's overall performance. Key metrics include:

* **Raffle ID / Raffle Name** — identifier and name of the Raffle
* **Unique Participants** — count of unique users who received tickets and entered at least one draw
* **Total Wins** — total number of prizes awarded across all draws and runs
* **Tickets per User** — average number of tickets held per participating user

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FEEk6xnFE00Ccl1e6bNr1%2Fimage.png?alt=media&amp;token=7715df41-079e-42e5-bd85-52547edc47d7" alt=""><figcaption></figcaption></figure>

This table is the starting point for identifying your highest-engagement Raffles and comparing performance across your portfolio.

**Indicative VS Actual (table)** This table compares the **Max Raffle Cost** (indicative ticket cost multiplied by max tickets count) configured at setup against the **Actual Prizes Cost** (total tickets issued multiplied by indicative ticket cost). It helps operators monitor budget consumption based on ticket issuance relative to the maximum planned ticket capacity.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2F3ZV3qiXfmFjXkzSztsXZ%2Fimage.png?alt=media&amp;token=117b0c2e-ac38-47d2-bbfd-fa52ab96079e" alt=""><figcaption></figcaption></figure>

> **How to use this tab:** Use the **General** table to rank Raffles by participation and wins at a glance. Use **Indicative VS Actual** to audit whether your prize budgets are on track and identify Raffles where actual costs are running above or below expectations.

***

### Raffles Issuing Tab

The **Raffles Issuing** tab focuses on how and when tickets are being distributed to players, and who is receiving them.

**Ticket Issuing Trend (mixed chart)** A dual-axis time series showing the daily number of **Unique Participants** (bar) and the **Tickets per User** average (line) over the selected period. This chart helps identify spikes in ticket issuance activity and trends in engagement depth — are more players receiving tickets, or are the same players accumulating more?

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fh27HfMvu9BqXMqkhvLyl%2Fimage.png?alt=media&amp;token=c51be117-b9bd-433e-865a-c1fecb82edee" alt=""><figcaption></figcaption></figure>

**Unique Participants by Raffle and RFM Segment (horizontal stacked bar)** A 100%-stacked horizontal bar chart breaking down unique participants per Raffle by their RFM (Recency, Frequency, Monetary) segment. This lets you assess whether your Raffles are reaching your most valuable player segments or primarily attracting lower-value users. The stacking shows segment composition at a glance for each Raffle.

**Unique Participants by Raffle and Value Score (horizontal stacked bar)** A 100%-stacked horizontal bar chart breaking down unique participants per Raffle by their 30-day User Value Score tier (Low, Medium, High, Top). This shows whether ticket issuance is concentrated among high-value players or distributed across lower tiers.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FDBW0mzt6V7ZXPMGHj6vR%2Fimage.png?alt=media&amp;token=b6fcd498-109d-4fe7-8e56-e5a97c4bbdc4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2F0iAGYn1y2LCIiunoQo0E%2Fimage.png?alt=media&amp;token=c8e7ecd1-b7e1-458a-a558-6a6c0b72afd3" alt=""><figcaption></figcaption></figure>

**Tickets By Source and Unique Receivers by Source (donut charts)** Two companion donut charts breaking down ticket acquisition by **ticket source type** (Campaigns, Automation Rules, Missions, Store Purchases, manual CRM grants, etc.). **Tickets By Source** shows the volume distribution of all tickets issued, while **Unique Tickets Receivers by Source** shows the distribution of unique participating players.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FwwWNYHTi0BBPu9vBV26Y%2Fimage.png?alt=media&amp;token=7e6820d7-8991-4933-ab92-f693fef818b4" alt=""><figcaption></figcaption></figure>

> **How to use this tab:** Monitor the issuance trend to catch unexpected drops or spikes in ticket distribution. Use the RFM breakdown to ensure your Raffles are engaging your target segments. The Ticket Source chart is particularly valuable for cost attribution — understanding which mechanics are generating the most participation informs future promotional investment.

***

### Raffles Prizes Tab

The **Raffles Prizes** tab provides a detailed view of prize distribution and claim behaviour across all draws.

**Prizes Claims (table)** A prize summary table showing all claimed prizes grouped by Raffle and prize claim date. Key metrics include Unique Winning Users, Total Winning Prizes, and Total Claimed Prizes per claim date.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FMJJMDnAJ45EsGkrM76qN%2Fimage.png?alt=media&amp;token=feebc2db-8bf9-480f-9ecf-a41b197566aa" alt=""><figcaption></figcaption></figure>

**Prizes Claimers (table)** A breakdown of winners and their claim behaviour. Key metrics include claimed prizes count per user as well as the user's RFM Segment and Value Score. This table is essential for identifying users that claimed a high amount of Raffle prizes and actioning marketing activities for those clients.

<figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FbGrr0ZglgUqOrz2sWTWt%2Fimage.png?alt=media&amp;token=e733d9e0-c17d-42a4-a176-20c35da1e6d7" alt=""><figcaption></figcaption></figure>

> **How to use this tab:** Use **Prizes Claims** to validate the prize claim trend — whether it matches your configured rules and that there are no cases of prize over- or under-awarding. Use **Prizes Claimers** to monitor claim health on the user level.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.smartico.ai/welcome/products/bi-and-reporting/raffles.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.