> ## 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 Match Cards?

> Test your customers' memory and let them win a reward with an engaging game such as match cards.

| Platform     | Plan       |
| ------------ | ---------- |
| Shopify      | Pro & Guru |
| Salla        | Pro & Guru |
| Non-Platform | Add-on     |

An interactive gamification tool that boosts engagement and brand awareness. Customers match item pairs to unlock rewards, driving interaction, visibility, and new revenue opportunities.

**Use Cases:**

1. **Brand Sponsorships:** Let brands sponsor in-game challenges for added revenue and engagement.
2. **Promote New Products:** Feature new products in the game to boost visibility and interest.
3. **Boost Activity:** Encourage daily or weekly logins with regular gameplay and rewards to drive retention.

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-preview.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=ac06cb3f4026eb40a4c93be7ebff0436" alt="Match cards preview" width="3574" height="1720" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-preview.png" />
</Frame>

***

## How to Set Up

<Steps>
  <Step title="Open Gameball">
    Log in to your Gameball dashboard.
  </Step>

  <Step title="Add a Reward Campaign">
    Click **Add Reward Campaign**.
  </Step>

  <Step title="Select the Template">
    Choose the **Match Cards** template.
  </Step>

  <Step title="Configure the Campaign">
    Edit the campaign's setup to match your goals.
  </Step>

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

***

## Campaign Trigger

Customers can access the match card through the **Badges** section in the widget. Tapping the badge redirects them to a screen where they can start playing and trigger the campaign to begin playing.

Use the `#gameball-match` deep link to trigger the match cards campaign from a custom banner or button on your website or app. [Learn more](/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign).

**Audience**

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

**Repeatability**

* By default, customers can play **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>

**Platform Visibility**

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>

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.

## Game Rules

**Game Cards**

Go to **Customize Design -> Game** to set up the rules.

1. The game includes **6 pairs of images** by default.
2. Customers must match all pairs **before the timer runs out**.

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-game-rules.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=0401a1ac9e800d0dda4b9b7f5670ed3c" alt="Match cards game rules" width="2670" height="1484" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-game-rules.png" />
</Frame>

**Time**

Specify the duration (in seconds) during which the customer is allowed to play the game.

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-time.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=c5f54edefc01c0a2aa8439a1ff145f00" alt="Match cards time setting" width="1940" height="702" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-time.png" />
</Frame>

**Flips**

* To add difficulty, you can **limit the number of flips**. If flips run out before all matches are made, the user **loses** the game.
* The min number of flips accepted is 12 flips.

***

## How It Works for Customers

<Steps>
  <Step title="Flip Cards">
    Customers tap cards to reveal hidden images.
  </Step>

  <Step title="Match Pairs">
    Matching pairs leads to a win.
  </Step>

  <Step title="Game Ends">
    The game ends when all pairs are matched or time runs out.
  </Step>

  <Step title="Notification">
    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

**Design & Content**

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

* **Banner (For game-based campaigns)**
* **Intro / Main Screen**
* **Success Screen**
* **No Luck Screen**
* **Game General Rules Customizations:**
  * **Time Duration**: Set how long each game lasts (e.g., 10s, 20s, 60s).
  * **Number of Flips**: Choose how many lives a customer has (e.g., 20, 25, or unlimited).
  * **Dashboard Controls**: Easily configure these settings in the game setup screen.
  * **Default Values**: Existing defaults remain if no customization is made.
  * **Tooltips**: Added help text explaining how time and lives impact gameplay.

For each screen, you can tailor the following elements:

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

This allows you to create a fully branded, on-theme experience that aligns with your business identity.

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-customization-1.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=4ed7b35b64a0584c50bee2bb4d64d552" alt="Match cards customization screens" width="2822" height="1524" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-customization-1.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/gameball/7MhWO6bij8idxYce/images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-customization-2.png?fit=max&auto=format&n=7MhWO6bij8idxYce&q=85&s=0a727632c2125e8cbf58b4bd51af8f8a" alt="Match cards customization details" width="2670" height="1484" data-path="images/product-docs/rewards-campaigns/templates/engagement-gamification/match-cards-customization-2.png" />
</Frame>

***

## Important Notes

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

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Set up a reward campaign" icon="flag" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Step-by-step guide to configuring any reward campaign.
  </Card>

  <Card title="Reward types in Gameball" icon="gift" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Explore the different reward types you can offer customers.
  </Card>

  <Card title="Notification after earning a reward" icon="bell" href="/product-documentation/rewards-campaigns/start-from-scratch/setup-reward-campaign">
    Configure how customers are notified when they earn a reward.
  </Card>
</CardGroup>
