> ## 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 Slot Machine?

> Engage your customers with Gameball's slot machine and ask them to try their luck.

## 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>

Add excitement to your customer experience with the Slot Machine campaign. This gamified feature lets customers try their luck -- if all three slots align, they win a prize! From discounts and free products to bonus points, the rewards keep them coming back.

<Frame>
  <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/slot-machine-preview.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=6e68eecee1aac0889271e759fdf88835" alt="Slot machine preview" width="2580" height="1544" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/slot-machine-preview.png" />
</Frame>

***

## Creating a Slot Machine Campaign

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

  <Step title="Select the Template">
    Select the **Slot Machine** 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="Trigger" icon="bolt">
    * **Machine 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 roll the machine.

    * **Deep Link:**
      Use the `#gameball-slot` deep link to trigger the slot machine 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="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="Repeatability" icon="repeat">
    By default, customers can roll the machine **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/slot-machine-rewards.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=6a1eb885b30e46bb68d90148953a2700" alt="Slot machine rewards setup" width="4088" height="1978" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/slot-machine-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 machine has been rolled.

    * 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.

    <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 trials, 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 machine 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.

    **Example:**

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

    After 10 trials: 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.
    </Note>
  </Accordion>
</AccordionGroup>

***

## End User Experience

**How it works:**

<Steps>
  <Step title="Roll the Machine">
    Customers earn rewards through rolling the machine.
  </Step>

  <Step title="Match All Three Windows">
    If all three windows match, they win a reward.
  </Step>

  <Step title="Receive a Prize">
    Prizes can include discounts, free items, 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 Slot Machine 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/slot-machine-customization-1.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=9082db50f7f1668b9c9359aaca45dda4" alt="Slot machine customization screens" width="2008" height="1152" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/slot-machine-customization-1.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/gameball/xysbvpvMWJQz49rc/images/product-docs/rewards-campaigns/templates/engagement-gamification/slot-machine-customization-2.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=6d85b0098b32db4386677322d52db8be" alt="Slot machine customization details" width="2008" height="1152" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/slot-machine-customization-2.png" />
</Frame>

***

## Important Notes

### Fraud Prevention

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

| Protection                        | Description                                                                                                                                              |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Single Play Per Session**       | Guest users can try the game only once per session. If they attempt to re-enter, a message displays: "You have already spun the Machine."                |
| **Multiple Machines in Campaign** | For campaigns with multiple machines, this restriction applies individually to each machine. Guests can still roll any other machine they haven't tried. |
| **Session Restriction**           | If a guest opens a new browser tab or window after playing, 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/slot-machine-lead-form.png?fit=max&auto=format&n=xysbvpvMWJQz49rc&q=85&s=7e8a07c3a4eb4e167ba212f296a0388c" alt="Slot machine anonymous lead form" width="1700" height="1978" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/slot-machine-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>
