> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Set Up Spin the Wheel?

> Engage your customers with Gameball's gamified tool and let them spin to win!

## Plan Availability

<Tabs>
  <Tab title="Shopify & Salla">
    | Plan       | Available |
    | ---------- | --------- |
    | Starter    | Yes       |
    | Pro & Guru | Yes       |
  </Tab>

  <Tab title="Non-Platform">
    | Plan   | Available |
    | ------ | --------- |
    | Add-on | Yes       |
  </Tab>
</Tabs>

Introduce an element of chance with the Spin the Wheel template. Customers can earn a spin as a reward for their actions, allowing them to win various prizes, from discounts to free products or bonus points. You can also organize weekly contests or lucky draws to encourage customers to return to your platform regularly.

<Frame>
  <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-preview.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=e90cf5e43afb86bd81163aac8225bfd5" alt="Spin the wheel preview" width="2658" height="1550" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-preview.png" />
</Frame>

***

## Creating a Spin the Wheel Campaign

<Steps>
  <Step title="Open Gameball and Create Campaign">
    Open Gameball and click **Add Reward Campaign**.
  </Step>

  <Step title="Select the Template">
    Select the **Spin the Wheel** template.
  </Step>

  <Step title="Edit Campaign Setup">
    Edit the campaign's setup (see configuration sections below).
  </Step>

  <Step title="Go Live">
    Click **Set Live** to activate the campaign.
  </Step>
</Steps>

***

## Campaign Configuration

<AccordionGroup>
  <Accordion title="Audience" icon="users">
    * **Registered Customers:**
      Customers who have an account on your platform (signed up)

    * **Anonymous Customers:**
      Visitors browsing anonymously without providing any contact information or identifiable details (not signed up)

          <Note>
            * Visitors can open the game, submit basic information through the lead form, play, and receive rewards, matching the standalone game URL experience.
            * Widget deep links that open a specific game work for guests as well. The widget would open directly into the game screen and allow participation without login.
          </Note>

    * **Specific Customers:**
      You can choose for a specific selection of customers to participate in this campaign by filtering using segments, tags or customer attributes.
  </Accordion>

  <Accordion title="Trigger" icon="bolt">
    * **Wheel Banner on Widget:**
      A banner will display on your widget's homepage. When customers click the banner, they'll be taken to the game screen where they can spin the wheel.

    * **Deep Link:**
      Use the `#gameball-wheel` deep link to trigger the Spin the Wheel campaign from a custom banner or button on your website or app. [Learn more](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign).
  </Accordion>

  <Accordion title="Repeatability" icon="repeat">
    By default, customers can spin the wheel **once per day**. A new opportunity to replay it begins at 00:00 AM based on the chosen time zone.

    All Games campaigns support only the Limit per day/week/etc. [Learn more](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign).

    <Frame>
      <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/game-repeatability.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=ddb5385fc678972f06c15663b7349a02" alt="Repeatability settings" width="1084" height="594" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/game-repeatability.png" />
    </Frame>
  </Accordion>

  <Accordion title="Platform Visibility" icon="desktop">
    You can choose whether the game campaign is shown on web, mobile, or both, giving you better control over engagement strategies across platforms.

    <Frame>
      <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/platform-visibility.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=f6b1fc3352e42ce4595332795e3b94b9" alt="Platform visibility settings" width="1322" height="312" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/platform-visibility.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

<Info>
  This template uses the standard reward campaign setup. See the [Generic Setup Guide](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign) for details.
</Info>

***

## Rewards Setup

<Frame>
  <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-rewards.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=e59a87b49b6296105b8df3fb6eee0de6" alt="Spin the wheel rewards setup" width="4088" height="1978" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-rewards.png" />
</Frame>

<AccordionGroup>
  <Accordion title="Reward Types" icon="tag">
    Choose from any of the reward types supported by Gameball. [Learn more](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign).

    | Setting                 | Value |
    | ----------------------- | ----- |
    | Minimum rewards allowed | 2     |
    | Maximum rewards allowed | 8     |
  </Accordion>

  <Accordion title="Probability" icon="dice">
    Enter a numerical value (e.g., 2, 3, 4) to represent the probability of a customer receiving this reward. Every spin is completely independent of the previous ones, and the chance of landing on a specific reward is always the same, no matter how many times the wheel has been spun.

    * The probability input can accept a value of 0, meaning the reward will not be available.
    * Probabilities are calculated based on the sum of all assigned probabilities across the rewards.
    * **Probability Adjustments:** The new probability will take effect immediately for future spins.

    <Warning>
      While each reward has a set probability, it doesn't guarantee that all rewards will be won equally over time. Some rewards might appear more often, while others might be less frequent. It's all part of the random nature of the game!
    </Warning>

    **Example:**

    * Reward #1: Probability 1
    * Reward #2: Probability 1
    * Reward #3: Probability 1

    After 100 spins, you might see results like this:

    * Reward #1: 27 times
    * Reward #2: 36 times
    * Reward #3: 37 times
  </Accordion>

  <Accordion title="Reward Limits" icon="lock">
    The maximum number of times a specific reward can be claimed by all customers throughout the campaign.

    * **Optional Feature:** You can choose to add a reward limit when configuring the campaign.
    * **Tracking Wins:** Gameball will track how many times each reward has been won. After the limit is reached, the reward will still appear on the wheel but will no longer be winnable.
    * **Reward Limit Adjustment:**
      * **Increase the Limit:** If the new limit is higher, customers can win the reward again.
      * **Decrease the Limit:** If the new limit is lower, the system will prevent the reward from being won if the initial limit was already reached.
      * **Removing a Reward:**
        * Setting a probability to 0 effectively makes the reward unavailable. The reward will still appear on the wheel, but will no longer be winnable.
        * Removing a reward completely will make the reward unavailable on the wheel and unwinnable.

    **Example:**

    * Reward 1: Probability 1, Limit: 1
    * Reward 2: Probability 1, No Limit
    * Reward 3: Probability 1, No Limit

    After 10 spins: Reward 1 hits 1 win (limit reached), Reward 2 hits 5 wins, Reward 3 hits 4 wins.

    <Note>
      * If all rewards have limits and they are reached, customers will see a "No rewards available at the moment" message.
      * Drag and drop the created reward to reorder them on the wheel.
    </Note>
  </Accordion>
</AccordionGroup>

***

## End User Experience

**How it works:**

<Steps>
  <Step title="Spin the Wheel">
    Customers earn rewards through spinning the wheel.
  </Step>

  <Step title="Win a Prize">
    Spinning offers a chance to win rewards: discounts, free products, bonus points, and more.
  </Step>

  <Step title="Get Notified">
    The customer is notified via the widget or email, depending on your configuration when they earned a reward. [Learn more](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign).
  </Step>
</Steps>

***

## Customization

You can fully customize each stage of the campaign through dedicated tabs representing the different screens in the flow:

<Tabs>
  <Tab title="Banner">
    Configure the banner that appears in the widget to promote the Spin the Wheel campaign.
  </Tab>

  <Tab title="Intro / Main Screen">
    Set up the main game screen with headlines, descriptions, and call-to-action messages.
  </Tab>

  <Tab title="Lead Form">
    Shown when audience is set to **Anonymous Customers (Not logged in)**. Collect visitor information before gameplay.
  </Tab>

  <Tab title="Success Screen">
    Customize the message and visuals shown when a customer wins.
  </Tab>

  <Tab title="No Luck Screen">
    Configure the message shown when a customer does not win.
  </Tab>
</Tabs>

For each screen, you can tailor:

* **Branding**: Adjust background colors, text colors, and upload custom artworks.
* **Content**: Edit the headlines, descriptions, and call-to-action messages to match your tone and messaging.

<Frame>
  <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-customization-1.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=61c43c725284c36ee1d84cf632731c75" alt="Spin the wheel customization screens" width="2096" height="1152" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-customization-1.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-customization-2.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=30fbf62150c660841dad2960bf8a6028" alt="Spin the wheel customization details" width="2114" height="1152" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-customization-2.png" />
</Frame>

***

## Important Notes

### Fraud Prevention

In the "Spin the Wheel" campaigns for guests (**Audience is Anonymous/Not Logged-in**), the following protections apply:

| Protection                      | Description                                                                                                                                         |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Single Spin Per Session**     | Guest users can spin the wheel only once per session. If they attempt to re-enter, a message displays: "You have already spun the wheel."           |
| **Multiple Wheels in Campaign** | For campaigns with multiple wheels, this restriction applies individually to each wheel. Guests can still spin any other wheels they haven't tried. |
| **Session Restriction**         | If a guest opens a new browser tab or window after spinning, the same restriction message will appear.                                              |

<Note>
  **Customer Eligibility**

  Games in the widget update dynamically based on customer eligibility, ensuring customers only see games they can still participate in.

  **Games are hidden when customers become ineligible.**

  If a customer no longer belongs to the game's target segment, the game is automatically removed from the widget and won't reappear unless eligibility is restored.
</Note>

### Anonymous Option

* If you choose **Anonymous** as the audience, the campaign will be available to visitors who are not yet identified on your store.
* Once enabled, a lead form will automatically appear prompting the customer to enter their information (e.g. name, email).
* This is a great way to collect leads and retarget potential customers later.
* You can fully customize this form by navigating to **Customize Design -> Lead Form**.

<Frame>
  <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-lead-form.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=79ac75cc64df8162ce23baba7084ec80" alt="Spin the wheel anonymous lead form" width="1700" height="1978" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/spin-the-wheel-lead-form.png" />
</Frame>

<Tip>
  Customizing the lead form also allows you to add a hyperlink to the **"terms and services"** so that customers can read and accept them before clicking submit.
</Tip>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Set Up a Reward Campaign" icon="gift" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Learn the full setup process for creating and activating reward campaigns.
  </Card>

  <Card title="Reward Types in Gameball" icon="tag" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Explore all reward types available and how to configure each one.
  </Card>

  <Card title="Notification After Earning a Reward" icon="bell" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Configure in-app and email notifications triggered when customers earn rewards.
  </Card>
</CardGroup>
