--- title: "Open the Box" slug: "open-the-box" updated: 2026-07-03T13:21:20Z published: 2026-07-03T13:21:20Z canonical: "docs.xtremepush.com/open-the-box" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt > Use this file to discover all available pages before exploring further. # Open the Box An overview of the Open the Box game and the game campaign setup process. ## Game Overview *Open the Box* is a game in which a player makes a single selection, for example, opening a box or picking a card. A short animation then plays, and the player either wins a prize or doesn't. Whether they win depends on the customer segment they belong to and the weight you've set for each prize. For more information, see [Prizes in Open the Box](https://xtremepush.document360.io/docs/en/open-the-box#prizes-in-open-the-box) below. This game is highly customizable and doesn't need to involve boxes at all. It can be reskinned into different experiences, from opening a box to picking a card or a horse race. There are three templates you can select from: - **Open the Box**: Players choose from three gift boxes to reveal their prize. [Embedded content](https://app.screencast.com/gDSzNtQt4aEF7/e) - **Pirate's Plunder**: Players choose from three treasure chests to reveal their prize. [Embedded content](https://app.screencast.com/RB8WUqSrToAxH/e) - **Card Opener**: A sports-themed variant set in a stadium. Players open a card to reveal their prize. [Embedded content](https://app.screencast.com/KW7WRVk83q4R8/e) You're not limited to these three built-in templates. Xtremepush also provides ready-made asset packs that reskin the game with different visuals and animations, which you can upload and apply to your campaign. For example: - **Derby Dash**: A horse-racing asset pack. Players pick one of six horses, watch a race animation, and the winning horse determines their prize. [Embedded content](https://app.screencast.com/Kvz8Ssyg6ZLZl/e) Regardless of which template you use, the likelihood of a player winning a prize is determined by the prize weight and the customer segment they belong to. For more information, see [Prizes in Open the Box](https://xtremepush.document360.io/docs/en/open-the-box#prizes-in-open-the-box) below. The entire game is built and managed within the Xtremepush platform and then embedded directly on your website for your users to play. ### Prerequisites [](https://docs.xtremepush.com/docs/thunderboard#prerequisites) - User Segments: To target your game to specific players, you'll need pre-configured segments. These must be created on the Xtremepush platform before you start. For more information, see [Before You Create a Game Campaign](/documentation/docs/before-you-create-a-game-campaign). - Game Assets: Have your game assets prepared. These include images for the game background, the tiles for the grid, prizes, and other branded elements. Assets are uploaded directly within the game in the **Assets** tab when you select a template during the campaign configuration. ## Game Setup [](https://docs.xtremepush.com/docs/thunderboard#game-setup) The following sections provide a high-level overview of the steps required to set up a *Open the Box* game. The infographic below highlights the four key stages of the game launch workflow, from creation to monitoring: ### Create Campaign Define the rules of your new game. ✏️ 🎨 ### Configure Mechanics Configure prizes and optional time slots. ### Customise Design Replace assets and update texts. βš™οΈ πŸš€ ### Launch & Monitor Embed your game and view player activity. ### Create Game Campaign The first step in creating your game is creating a game campaign. A campaign acts as the container for your game, allowing you to define crucial aspects like target audiences, campaign duration and more. It also contains your game’s design, text, and prize configurations. For more information on the required fields when setting up campaigns, see [Create a Game Campaign](/documentation/docs/create-a-game-campaign) Selecting a template automatically loads a complete layout file and the necessary assets into your campaign's **Assets** tab. This streamlines configuration, allowing you to easily replace the default assets with your own without needing to build the game's layout from scratch. ### Customise Game Design [](https://docs.xtremepush.com/docs/thunderboard#customise-game-design) After creating the campaign, the next step is to customize the game's visual design and text to match your brand. This involves three key areas: - Replace or Add Assets : The template you select provides a standard asset pack, which includes default images for the background, game board, and prizes. You have two options for customization: - You can replace any of the default assets with your own branded versions. For more information, see [Replace Assets](/documentation/docs/replace-assets). - You can also add new assets that are not part of the standard pack. For more information on adding new assets, see [Manage Assets](/documentation/docs/manage-assets). For a general overview on game assets, see [Assets Overview](/documentation/docs/assets-overview) - Update Game Texts: In the **Texts** tab, you can update all the standard text that appears in your game's interface. However, the text displayed when a player wins or loses is configured separately in the **Prizes** tab. For more information, see [Update Texts](/documentation/docs/update-game-texts) - Make Design Changes in the Editor: For granular control over the game's front-end appearance, use the Editor. It allows you to make detailed visual adjustments, such as resizing or repositioning elements, modifying fonts and colours, or adding new components. For more information, see the following pages: - [Editor Overview](/documentation/docs/editor-overview) - [Editor Use Cases](/documentation/docs/handle-prize-redirects-from-your-website). ### Configure Game Mechanics [](https://xtremepush.document360.io/docs/en/open-the-box#configure-game-mechanics) #### Prizes in Open the Box In the **Prizes** tab of your campaign, you configure the prizes available in your game. For more information on the different prize configuration fields, see [Configure Prizes](/documentation/docs/configure-prizes). You can configure as many prizes as you like for your game. For example, a three-box game does not need to be limited to a single win prize. You could instead configure several different win prizes, each with its own weight and target segment. The example table further down this section shows what this looks like for a three-box game. Whether a player wins a specific prize depends on: - **Weight**: Sets the likelihood of the prize being awarded relative to the other prizes in the game. A higher weight increases the chance of a player winning that prize. - **Customer Segment**: The customer segment or segments the prize is assigned to. Because prizes are tied to customer segments, a player can only win a prize that is assigned to their segment. You must also configure a **No-win** prize to handle the outcome where a player does not win a prize. Assign it a weight in the same way as your win prizes to set the likelihood of this outcome. The table below shows an example prize configuration for a three-box game with nine overall prizes: | Prize | Prize Reference | Customer Segment | Weight | | --- | --- | --- | --- | | 🎟️ 5 Free Spins | Win | New Users, Occasional Players | 15 | | 🎟️ 10 Free Spins | Win | New Users | 10 | | πŸ’° €10 Bonus | Win | Occasional Players | 20 | | πŸ’° €10 Bonus | Win | VIP Players | 30 | | πŸ’° €30 Cashback | Win | VIP Players | 10 | | πŸ† €50 Cashback | Win | VIP Players | 5 | | No-win | No-win | New Users | 75 | | No-win | No-win | Occasional Players | 65 | | No-win | No-win | VIP Players | 55 | In this example above, the winning chances for each segment are: - **New Users**: 15% chance of winning *5 Free Spins*, 10% chance of winning *10 Free Spins*, 75% chance of *No-win*. - **Occasional Players**: 15% chance of winning *5 Free Spins*, 20% chance of winning the *€10 Bonus*, 65% chance of *No-win*. - **VIP Players**: 30% chance of winning the *€10 Bonus*, 10% chance of winning the *€30 Cashback*, 5% chance of winning the *€50 Cashback*, 55% chance of no win. The no-win weight is different for each segment. **VIP Players** are the most exclusive segment, so their no-win prize has a lower weight than **New Users** or **Occasional Players**, giving them a better chance of winning a prize. #### Configure Time Slots [](https://docs.xtremepush.com/docs/thunderboard#configure-time-slots) You can control your game's daily availability by setting up specific time slots when it can be played. For example, you could make the game available only during a 'happy hour' promotion from 5 PM to 7 PM. For more information, see [Manage Time Slots (Optional)](https://docs.xtremepush.com/docs/manage-time-slots-optional). ### Launch and Monitor Game [](https://docs.xtremepush.com/docs/thunderboard#launch-and-monitor-game) **Launch Your Game** [](https://docs.xtremepush.com/docs/thunderboard#launch-your-game) To launch your game, you must embed it on your website. For added security, you can also use a JWT token to ensure that only authenticated users are able to play. For more information, see the following pages: - [Launch your Game](/documentation/docs/launch-your-game) - [JWT Authentication Details](/documentation/docs/jwt-authentication-details). #### Monitor Player Activity [](https://docs.xtremepush.com/docs/thunderboard#monitor-player-activity) The Xtremepush platform automatically tracks the following engagement data for the *Open the Box* game, which you can view in the **Games** tab of your campaign: - A record of every player that played the game, the prize they won, and no-win outcomes. - Timestamps for when the user opened the game (**Created At**) and when they played it (**Spun At**). - Timestamps for when a prize was accepted (**Accepted At**) or declined (**Declined At**).