> 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/mini-games/ballanza.md). # Ballanza Ballanza is an engaging and dynamic mini-game where players drop a ball that bounces between pegs before landing on a prize at the bottom of the board. Players control where to drop the ball from a moving launcher, adding an exciting element to the game.

**How it works?** The ‘Ballanza’ mini-game comes with 6 pre-built global skins (ready to use), but it is fully customizable, and it allows you to create your own skin. You can also specify the type and quantity of prizes, determine the cost type for attempts (free, gamification points, or spin attempts), define the user segment eligible to access the game, and much more. **Gameplay:** When the player opens the game, a moving launcher appears holding the ball. The player decides when to release it by pressing the ‘Drop the ball’ button. The ball then bounces through pegs until it lands on one of the prizes at the bottom - whichever slot it falls into determines the reward. #### Configuration You can configure Ballanza in the Back Office → Gamification → Mini-Games section.\ Its setup template is similar to other random mini-games (Spin the Wheel, Scratch Card, Gift Box), featuring the following tabs: * General Settings * Advanced Settings * Prizes * Winnings * Not claimed prizes * Analytics * Used In The main difference is that Ballanza supports between 2 and 7 prizes only. ### Board Layout and Prize Slots The Ballanza board features 7 physical landing slots at the bottom. When you configure between 2 and 6 prizes, the system automatically distributes and repeats your configured prizes across the 7 available slots so every slot has an assigned prize. To display exactly one unique prize per slot without duplicate icons on the board, configure exactly 7 prizes. ### Attempt Costs, Limits, and Supported Prize Types Ballanza supports flexible attempt pricing models: * **Free:** Players can drop the ball free of charge. * **Gamification Points / Currency:** Players spend a configured amount of gamification points, gems, or diamonds per attempt. * **Spin Attempts:** Players consume spin attempts granted from Missions, Campaigns, Levels, Tournaments, or Store item purchases. You can configure throttle limits (maximum attempts per hour, day, or lifetime), cooldown countdown timers, and expiration rules for awarded attempts. Supported prize types include Points, Casino or Sport Bonuses (such as Free Spins), Mini-Game Tickets, Tournament/Raffle Tickets, Jackpots, and Tangible/Manual gifts. Prize probabilities are calculated proportionally from active prize pool counts, which can be automatically refilled on a recurring schedule.

#### Standalone Mode You can launch Ballanza in standalone mode directly from a campaign or via a deep link. This makes it easy to trigger the game from missions or other features. Examples: * `dp:gf_saw&id=123` → opens the game with ID 123 in the Gamification Widget context * `dp:gf_saw&id=123&standalone=true` → opens the same game in standalone mode * `dp:gf_saw&id=123&embeddableMode=1` → opens the game in embeddable mode inside an iframe without extra navigation chrome

**You can find all the skins here:** {% embed url="" %} ### Frequently Asked Questions **Why does one of my prizes appear duplicated on the Ballanza board?** The Ballanza board contains 7 physical landing slots. When you configure between 2 and 6 prizes, the system automatically fills all 7 slots by repeating prizes across the board. To show each prize exactly once, configure exactly 7 prizes. **Can playing another mini-game (such as Spin the Wheel) award drops in Ballanza?** Yes. In the prize settings of your Spin the Wheel template, create a prize of type **Mini-game ticket** and select your Ballanza template. When a player wins that prize, they receive attempts to play Ballanza. **What assets are required for a custom Ballanza skin, and can I disable sound?** A custom Ballanza skin package requires specific image files (including background images, pegs, ball, moving dropper, start button, slot dividers, and popup frames) and audio files. If you do not want background music or sound effects, you can upload silent MP3 files in the skin archive. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.smartico.ai/welcome/products/mini-games/ballanza.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.