Alternative Design

Alternative Designs Alternative Designs allow you to create multiple visual designs for the same game without changing how the game works. Use them to support Light and Dark Mode, create different color themes, or provide accessibility options such as color-blind-friendly designs. When Alternative Designs are enabled, your current default design becomes the Light design. You can then add a Dark design and any number of custom alternative designs. How to Add Alternative Designs Go to Alternative Designs in Game Settings and enable the setting. Your current design will automatically become the default Light design. Add a Dark design or create additional custom designs. Edit the design name to choose how each option is displayed to players. Select each design from the design mode bar and customize the graphical elements to create your alternative design. You can add as many custom designs as you need, but only one design can be set as Light and one as Dark. This allows the game to automatically match the Light or Dark Mode preference of the player's device. Design Mode Bar After enabling Alternative Designs, a design mode bar appears on the left side of the settings panel. The default Light design is always displayed at the top and is represented by a sun icon. A Dark design is represented by a moon icon, while custom designs are represented by a color palette icon and a number. Select a design from the bar to edit its visual appearance. When an alternative design is selected, text fields and other non-visual settings are locked. You can only change graphical elements that are supported by Alternative Designs. This ensures that the game's content, settings, and functionality remain consistent across all designs. Player Design Selector When Alternative Designs are enabled, a design selector appears in the top-right corner of the Start Game view. Players can use it to switch between the available designs. You can disable the design selector if you don't want players to manually change the design. When disabled, designs can still be selected automatically or through the game URL. How a Design Is Selected When a player opens the game, the design is selected using the following priority: Design specified in the game URL Player's system preference for Light or Dark Mode Player's previously saved selection for that specific game Default design For example, if a player's device is using Dark Mode and you have configured a Dark design, the game can automatically display that design. If no matching design or other selection is available, the game uses your default Light design. Alternative Designs give you flexibility to adapt the visual experience for different players, campaigns, and accessibility needs while keeping the same game content and functionality.

Event Mode Event Mode lets multiple players take turns playing the same Game on a shared device. Each new player starts with a fresh session, preventing data from the previous player from carrying over. This is useful for live events, booths, in-store activations, and competitions where many participants use the same device. Enable Event Mode Add Event Mode from the Game Settings and select how a new player session should start. There are two registration methods available: New Player Button A New Player button is added below the Start Game button. Players select New Player when it's their turn to start a fresh session. The button can be customized and styled in the same way as the Start Game button. This option is useful when you want players or event staff to control when a new session begins. New Player Each Round With New Player Each Round, a fresh player session is automatically created every time the Start Game button is pressed. No additional New Player button is displayed, making it quicker for participants to move from one player to the next. This option is ideal for high-traffic events where each game round should automatically belong to a new player. Which method should I use? Use New Player Button when the same player may play multiple rounds before passing the device to someone else. Use New Player Each Round when every game round should be treated as a new player session.

Style Toolbar The Style Toolbar is used to customize the appearance and position of components across Games, Game Centers, and Surveys. The options available in the toolbar depend on the component you are editing. Only styling options supported by that component will be shown. Typography For text-based components, you can customize settings such as: Font Font size Bold Text alignment Line height Letter spacing Text color Text color supports solid colors. Shape and positioning Shape settings control the size, position, and appearance of the component. Depending on the component, you can adjust: X and Y position Width and height Z-index Corner radius Padding Stroke Drop shadow Fill Position and size values can be entered using either pixels (px) or percentages (%). Fill Fill controls the background of the component. Available fill types may include: Solid color Gradient Image Image fill is only available for supported components. When available, you can upload an image to use as the component background. Animation Combine multiple filters to narrow down the Game Library and quickly find games that match both your branding needs and engagement goals. You can add a simple entrance animation to supported components. Choose: How the component enters pick from 5 animations Which direction it animates from Animation duration in ms Use animations to add movement without changing how the component functions. Custom CSS For more advanced customization, you can add your own CSS in the CSS field. Custom CSS gives you additional control when the standard Style Toolbar settings are not enough. Import styling If you have already styled a similar component, you can reuse those settings instead of recreating them. Open the options menu in the Style Toolbar. Select Import Settings. Choose the game you want to import styling from, the game needs to have that component for it to be styled. The available styling settings will be copied to the current component.

Multi Entry Motivate your players with an increased chance of winning by entering the challenge multiple times. The Multi Entry feature rewards players with additional competition entries for achieving a target score multiple times. This encourages repeat play by giving players more chances to win the more they play. Enable Multi Entry To use Multi Entry, first add the feature from Game Settings. Once enabled, configure the following: Target Score – The score a player must reach to earn an additional entry. Entry Limit – The maximum number of entries a player can earn within the selected time period (for example, three entries per day). Limiting the number of entries per player is a great way to encourage players to return and play again over time. Entry View When a player earns a new entry, an entry view is displayed on the start game view showing how many competition entries they have collected. You can customize the appearance of this popup to match your game's design, including its text and styling. Example If you set a Target Score of 500 points and an Entry Limit of 3 entries per day, players who reach 500 points can earn up to three entries each day. After reaching the daily limit, they can continue playing but won't earn additional entries until the limit resets the next day.

Persona Analytics Persona Analytics helps you understand how players interact with your Survey and how results are distributed. The analytics view is divided into three tabs: Persona Answers Branch Persona analytics The Persona tab shows how many players reached each persona result. For each persona, you can view: Total number of players Percentage of players based on total survey completions This gives you a clear overview of persona distribution across the Survey. Answer analytics The Answers tab shows how players answered each question. For each question and answer, you can view: Number of players selecting each answer Percentage distribution per answer This helps identify trends in player behavior and understand how answers contribute to persona outcomes. Branch analytics The Branch tab visualizes the full survey flow. This view shows: How players move through the survey Percentage of players following each branch path Answer distribution for each question Hovering over a question displays additional details about answer selections and player distribution. This is useful for identifying dominant user paths or potential drop-off points in the Survey.

Introduction to Surveys Surveys in Flarie Studio let you create interactive quiz and persona experiences that help you engage users, collect insights, and guide players toward personalized outcomes. Unlike traditional forms, Surveys are built around branching flows, questions, and persona results, making them ideal for product recommendations, personality quizzes, onboarding flows, or audience segmentation. Surveys share many of the same design and styling capabilities as Games, while introducing survey-specific functionality such as personas, branching logic, answer-based paths, and detailed survey analytics. With Surveys, you can: Create personality or recommendation quizzes Guide users through different question paths using branches Assign players to personas based on their answers Customize backgrounds, styling, and result views Track answer selections and persona distribution through analytics Send survey events through webhooks to external systems Surveys can also be connected to webhook integrations, allowing you to send persona results and answer data directly to your CRM, analytics platform, or external services in real time.

Create a Persona Survey A Persona Survey allows you to guide players through a series of questions and assign them to a specific persona based on their answers. Create a new Survey Navigate to the Surveys section in the header. Click Create Survey. Surveys use a similar structure to Games and Game Centers, with dedicated settings for personas and survey flow. Customize the design You can style your Survey to match your brand. Available customization options include: Mobile background image Full screen background image Colors Question styling Answer styling Persona-specific backgrounds Background images support different fit and alignment options such as Fill, Fit, and Tiled. Add personas At least one persona is required in every Survey. Go to the Personas section. Configure the persona settings Click Add Persona to add more personas. For each persona, you can add: Internal name Persona attribute (optional) Persona key (optional) Persona-specific backgrounds Custom elements that will appear as persona results, such as text, images or ctas. Persona attributes and keys are mainly used for webhook integrations. Build the survey flow The Flow section is where you build the survey structure. The survey is displayed as a visual flow chart with a fixed Start and End point. Using the “+” icon in the flow, you can add: Questions Branches Views Add questions Click the + icon in the flow. Select Add Question. For each question, you can configure: Internal name Question text Answers Persona score assignment Skip question option Shuffle answers option Custom styling and backgrounds Each question must contain between 2 and 12 answers. Answers are connected to personas through score assignments, determining which persona the player receives at the end of the survey. The highest score will determine the persona result. Add branches Branches allow you to create conditional survey paths based on selected answers. Click the + icon in the flow. Select Add Branch. Branch rules include: Multiple answers can lead to the same branch One answer can only belong to one branch path Available answers depend on the connected question This allows you to create more dynamic and personalized survey experiences. Add views Views are non-interactive pages used to display information between questions or before the final result. Views can include: Text Images Buttons Custom backgrounds Players continue through the survey by clicking the Next button. Configure survey settings Survey settings are adapted from standard Game settings. With this you can add data collection forms, challenges, luck based rewards and more to make the survey fit your purpose. Notable survey-specific behavior includes: Leaderboards and ranking are not available if you want to create a competitive quiz its recomended to use the game "quiz" or "quizzie" Start Button functionality is adjusted for surveys Trigger functionality can control how many times a survey can be completed Example: You can hide the Start button after a player completes the survey once.

AI Game Developer [BETA - v.1.0.1] Welcome to the AI Game Developer! Bring your ideas to life in seconds with fully playable, Flarie-ready games - automatically built and compatible with all Flarie Studio settings and integrations. This guide is designed to help you move from concept to launch faster than ever, all within a completely no-code environment. Writing a great Game Concept prompt A strong prompt helps the AI understand your vision and build a playable game that behaves exactly how you expect. Here’s how to write prompts that consistently produce great results: Do:✅ Be clear, specific, and simple. It’s better to start small and then add features later - overly complex, multi-phase games may confuse the AI.✅ Describe what the player does and how the game ends.✅ Explain player actions and feedback, e.g. “Tap to shoot,” “Swipe to dodge.”✅ State the goal and success or failure conditions, e.g. “Reach 100 points to win,” “The game ends when the player hits an obstacle.”✅ Include control details, e.g. “Tap to make the player jump,” “Use arrow keys to move left and right.”✅ Mention objects and how they appear, e.g. “Avoid enemies that appear from the sides,” “Collect pickups that fade in from the top.” ✅ Call out randomness if needed, e.g. “Random enemies appear from the top.” Avoid: ❌ Vague ideas like “a fun adventure” or “something with animals.”❌ Requests for menus, audio, or long storylines.❌ Non-supported gameplay types (e.g. 3D, multiplayer games ). 🧠 Example - Good Prompt:“Create a classic snake game where the player controls a growing snake using the arrow keys. The goal is to collect apples to increase length and score. Add moving enemies that the snake must avoid - colliding with an enemy, wall, or itself ends the game.” 🚫 Example - Poor Prompt:“Make a cool football game with lots of stuff happening.” ⚙️ What’s Not Supported (Yet)The AI Game Developer currently does not support: ❌ Audio or sound effects ❌ Menus or story cutscenes❌ Local storage or persistent save data❌ 3D Games ❌ Multiplayer Games❌ Text-based Games Focus on gameplay logic and interactions - everything else can be configured later in Flarie Studio after export. Useful Shortcuts The AI responds best to a set of clear shortcuts that let you fine-tune game logic, timers, backgrounds, and object behavior directly through your prompt. Use the examples below as quick references to guide the AI effectively. ScorebarThe Scorebar automatically manages all logic related to Lives, Moves, and Timers. It’s responsible for tracking progress and determining when the game should end. Examples: - “Make sure the game ends when the user runs out of lives.” - “Make sure the game ends when the user runs out of moves.” - “Change the amount of moves from 20 to 10.” Game TypesThe Game Type defines the overall rule set - whether the game is based on lives, moves, time, or pure luck. You can switch type at any time by simply describing it in your prompt. Examples: - “Switch the game type to lives-based.” - “Make the game use limited moves instead of endless play.” - “Turn this into a luck-based game where the outcome is random.” TimerbarThe Timerbar is a built-in timer displayed within the Scorebar. It can limit gameplay time, create bonus effects, or trigger events when time runs out. Examples: - “Make sure the game ends when the user runs out of time in the timerbar.” - “Deactivate the timerbar when the bonus mode ends.” - “Create a timerbar in the scorebar when the player picks up a bonus item. Deactivate it automatically after 10 seconds During this time give double points.” Background (TileSprite)The background acts as a TileSprite, allowing seamless movement in any direction for dynamic effects such as scrolling skies or moving terrain. Examples: - “Make the background scroll slowly to the left to simulate forward motion.” - “Move the background upward to create a falling effect.” Changing SizesYou can directly define object dimensions (e.g., player, enemy, pickup) in your prompt to get precise proportions. Examples: - “Change the player size to width: 80, height: 120.” - “Make enemies half the size of the player.” - “Increase the pickup item size by 50%.” Lifecycle (Game Start & Game Over)Every game follows the same lifecycle - starting, running, and ending smoothly. You can customize transitions or effects using simple instructions. Examples: - “Make all objects fade in at game start.” - “Add a 2-second fade-out animation at game over.” - “Reset the game automatically after the game over sequence ends.” Collisions & BodiesThe AI supports basic collision detection and physics body setup for all objects. Every object in your game has an invisible body that defines how it interacts with others - whether it’s solid, bouncy, or passable. You can use prompts to control which objects collide, overlap, or ignore each other, as well as the shape of their collision area (rectangular or circular). Examples: - “Make the player collide with the walls” - “Allow pickups to overlap the player and disappear when collected.” - “Add a circular body to the player instead of a rectangular one.” VelocityVelocity controls how fast and in which direction an object moves. You can use it to simulate speed, directional movement, or bouncing effects. Positive or negative values determine the direction along the X or Y axis. Examples: - “Add horizontal velocity to enemies so they move left and right.” - “Increase the player’s jump velocity for a stronger bounce effect.” - “Double the velocity of the ball so it moves faster.” GravityGravity defines how strongly an object is pulled down (or in any direction if specified). It can be adjusted per object in the game. Examples: - “Give the player a constant downward gravity so it falls naturally.” - “Set gravity to zero so all objects float freely.” - “Increase the gravity strength to make everything fall faster.” Building your Game The AI Game Developer is trained on Flarie’s internal game engine and a large collection of existing Flarie games. It follows strict coding conventions to ensure every game it creates is fully compatible with all standard Flarie Studio settings and integrations. All Flarie games share a common foundation - they must include specific methods for loading, initializing, starting, and ending the game. These ensure the game lifecycle runs smoothly and that player scores are tracked and saved correctly within Flarie Studio. Each game file includes predefined “zones” where the AI applies its creativity - writing logic, defining visuals, and bringing your idea to life. Your prompt (game concept) serves as the blueprint the AI uses to fill in these zones and generate a complete, ready-to-play Flarie game. Game TypesWhen you create your first prompt, the AI automatically selects one of its four supported game types based on your concept. Each type follows a slightly different structure, which the AI sets up automatically - and you can switch modes at any time. If you want a specific type, mention it in your prompt. Type Description Normal Standard Arcade gameplay Moves Limited moves / turns Lives 3 Lives before game over Luck Pure chance outcome. Game always have a win / lose condition instead of ordinary points Lifecycle Game LoadDuring the load phase, all assets are preloaded and every object is initialized - but remains hidden until it’s meant to appear. This ensures the game is fully prepared before the player starts interacting with it. Game StartWhen the game starts, gameplay always resets to its initial state. Objects fade in or appear dynamically based on the flow of the game, creating a clean and engaging start for each new play session. Game OverThe game over phase gracefully concludes gameplay with a short, cinematic sequence — typically lasting around two seconds - where the scene fades out or triggers a simple animation before ending. This ensures a polished and consistent ending across all games. Background All Flarie games are built on a 750×1334px canvas, which defines the visible game area across all devices. The background functions as a TileSprite, meaning it can be moved or scrolled seamlessly in any direction - horizontally, vertically, or diagonally - without visible edges or breaks. This allows you to create effects such as moving skies, scrolling terrain, or endless runners. You can instruct the AI to move, loop, or animate the background to match your gameplay. For example: - “Make the background slowly scroll to the left to simulate forward movement.” - “Move the background downward to give a falling effect.” Keep in mind: - The AI does not generate custom background art - it uses a placeholder asset by default that you can change once you have exported your game to Flarie Studio Assets & Images Each build uses placeholder images so your game can run instantly. Don’t worry about visuals yet - focus on gameplay and feel. You’ll see simple colored PNGs labeled with names like “PLAYER,” “ENEMY,” or “PICKUP,” making it easy to identify and reference specific objects in your prompts if you want to adjust their behavior. At this stage, the AI does not support replacing these placeholders with real images, generating graphics, or embedding image URLs. All objects are rendered in square or rectangular shapes - so even if you request a circular object, it will behave circularly in the game but still appear as a rectangular placeholder. Once you export your game to Flarie Studio, you can freely replace and configure all assets - images and other visuals - directly within Flarie Studio, without modifying any code. Please note:- Audio is not supported at this stage. - The AI will not add text elements unless you explicitly include them in your prompt. For now, we recommend ignoring text entirely and focusing on core gameplay. Restore to an earlier Version Every time the AI creates or updates your game, a new version is automatically saved. This lets you experiment freely without worrying about losing previous work. If you ever want to revert changes, you can restore your project to any earlier version with a single click. The restored version will instantly become your active working copy, allowing you to continue building or exporting from that specific state. Exporting your game to Flarie Studio Once you're happy with your game, you can export it directly to Flarie Studio. A new game will be created there based on the exact version you exported. Inside Flarie Studio, you’ll be able to edit and replace all assets and images, as well as access the full library of Flarie settings and integrations — everything from data collection and challenges to rewards and webhooks is automatically available. If you notice anything that needs tweaking, simply return to the AI Game Developer, adjust your prompt, and export again. You can export as many times as you like until your game feels just right. AI Credits Every time the AI apply an update to the code it will cost you 1 AI Credit, as simple as that! Tips & Tricks Start fresh when needed. If your generated game drifts too far from your intended idea, it’s usually faster to start over with a new prompt rather than trying to fix everything within an existing version. Clean starts often produce better, more consistent results. Add features gradually. When expanding your game, it’s best to add logic and features one at a time instead of stacking multiple complex changes into a single prompt. This allows you to test and validate each update individually - and easily restore to a stable version if something doesn’t behave as expected. Iterate like a designer. Treat each version as an experiment. Small, focused prompts usually guide the AI more effectively than large, complicated ones. Use clear cause-and-effect language. The AI responds best when you describe what should happen and when, e.g. “When the player collects a star, increase the score by 10.”

Game Center Language The Language feature lets you create one Game Center enter with multiple language versions without having to manage separate game centers. This feature allow you to create localised game centers for players while keeping the same Game Center. Let’s walk through how to set it up. By default, the game center language is set to English. You can change this in the Language Settings under your game's settings or in Assets & Settings > Language. Changing the default language in Assets & Settings ensures that all newly created games will use that language by default. How to set up additional languages in Game Center: Navigate to your game centers's Language Settings. Toggle on 'Enable Additional Languages.'This will open the settings for adding additional languages, as well as a sticky sidebar listing all the languages you add. Click + Add and select the desired language from the dropdown menu. Choose how the language name will be displayed to players: - English: Displays the standard English name for the language. - Custom: Enter a custom display name. The language will be added to the Languages List and in the side panel. You can update your game center texts in two ways: 1. By clicking on the 'Edit texts for all languages button on Languages or the icon at the bottom of the bar. This opens a popup with all editable texts. If you proceed to add any additional settings to the game, the related texts will automatically be added to the popup for easy access. 2. Navigating to the language version and specific game settings you wish to update. (Optional) Upload an icon for the language selector button and style the dropdown to match your game's design. Game Settings and Language Once additional languages are added, a language bar appears on the left side of the settings panel: The default language is listed at the top. Full game settings can only be modified when the default language is selected. When an additional language is selected, only text fields can be edited for translation purposes. At the bottom of the language bar, click the “Edit texts for all languages” icon to open the popup where you can update all translatable fields in one place. When an additional language is selected, only text fields can be edited. All functional changes needs to be done on the main language version.

Publish Game Center Publish Game Center The Publish function lets you control when changes to your Game Center go live, ensuring you can make edits without disrupting the active version. Key Features of the Publish Function: Initial Published Version: When you create a new Game Center, it’s automatically published as the first version. Game Center Cards: On the Games Center Dashboard, the card for each Game Center shows the published version. A banner will appear if there are unpublished changes, prompting you to take action Excluded Sections: Some areas like the 'Game Center Status' are excluded from the publish workflow. Changes here are immediately published in the Game and cannot be unpublished. The excluded sections are highlighted with an orange message. Sharing Your Game Center: Use the 'Share Published Link' to copy a link to the most recent published version of your Game. Steps to Publishing a Game Center: Make Edits: Modify your Game Center as needed. While you’re editing, your changes are automatically saved. Check the Publish Button: As soon as changes are made, the 'Publish' button becomes active, and a message will indicate there are unpublished changes. Click Publish: When you are ready to make your edits live, click the 'Publish' button. Your changes will now be visible to your audience and the 'Share Published Link' will show the Game Center with the changes you published. This feature ensures smooth game updates while keeping control over what your players see.

Competition modules Competition modules are an excellent way to increase engagement in your Game Center, motivate players to return and play more frequently and distribute prizes based on performance or participation at the end of a defined competition period How to use Competition modules Competition Modules are available for Advanced Game Centers and allow you to add different types of competitions to drive engagement and reward players. You can choose from three types of competition modules: Challenge, Entries and High Score. These modules can be added individually or combined, depending on your campaign goals. Note:Each competition module requires at least one Game Module with a game connected to function properly. Learn how to set up each module: How to set up a Challenge How to set up Entries How to set up a High Score module

Game UI The Game UI settings allow you to customize the interface elements that appear during gameplay. This includes elements such as score bars, life icons, and action buttons. Customizing the Game UI helps you align the gameplay experience with your campaign design and brand identity. What You Can Customize in the Game UI Top score bar The score bar displays the player's current score during the game. You can upload a custom image to replace the default score bar design. You can also adjust the colors of the bar to better match the game theme or campaign design. Star icon The star icon indicates how well the player is performing based on their score. Players earn stars when they reach specific score thresholds. You can upload a custom star icon to match the visual style of your game. Heart icon (lives) The heart icon represents the number of lives a player has remaining. You can replace the default heart icon with your own design to better match your game's branding. Action button (pause/info) The Action Button is located in the top-left corner of the game screen and appears as an information icon. It allows players to pause the game or exit the game early. You can choose whether to enable or disable this button. If the Action Button is enabled, you can customize how it behaves and what content is shown to the player. Action button options If the Action Button is enabled, you can configure the following options. Pause view or exit gameChoose whether clicking the button opens the pause view or exits the game immediately. Tutorial imageUpload a custom tutorial image that explains how to play the game. Tutorial descriptionAdd a custom description that explains the gameplay instructions. Button labelsCustomize the labels for the Resume and Exit Game buttons. Tip Use the Game UI settings to ensure the interface elements match the visual style of your game. Small details such as icons and buttons can help create a more consistent branded experience.

Voyado Integration This integration will create or update a Voyado contact. It ensures that user data collected via Flarie Studio is passed to Voyado for email marketing, automation, and segmentation purposes. Configuration The following Voyado credentials are required to authenticate and correctly pass data to Voyado. API Key - used to authorize access to your Voyado account. How to generate your Api Key. 1. Go to Administration -> Configure Engage -> Intergrations & External Systems -> Api Connections -> + Add Connection Base Url The base URL uses your Engage tenant name, which is the unique name connected to your Engage account. For example, if your tenant name is "example" then your base URL would be: https://example.voyado.com If you are connecting an Engage staging environment, you would use: https://example.staging.voyado.com For customers using the previously eclub url schema, please use: https://example.eclub.se Use the full Base Url as the provided Url in Flarie Studio. Payload Requirements This section defines what is mandatory to send to Voyado. You must select the appropriate Public Identifier based on your settings within Voyado. Flarie Studio support the below four Public Identifiers: email mobilePhone externalId memberNumber Pass additional Flarie Attributes to Voyado You may pass additional attributes to Voyado. This can be done by passing a value on either a default attribute within Voyado or by creating a custom attribute. How to create and manage Voyado Attributes 1. Go to Administration -> Configure Engage -> Contacts -> Contact Attributes Create an attribute or grab the ID for an already created attribute that you want to populate. In this example we will use firstName which we also use in the below Flarie Studio example, along with customParam1 and lastName. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

[POST] Reset Attempts for a Single Player This guide is for resetting the Attempts for a single player for a Gamification Attempts Scenario created in Flarie Studio. Please note that this will reset all attempts for a single player to 0. [POST] https://prod-api.flarie.com/rest/gamification-service/v1/public/player/reset-attempts Payload { "accessKey": "string", "gamificationId": "string", "playerIdentifier": "string", } Name Type Description accesskey string Brand Access Key. You can generate your accessKey in Flarie Studio → Manage Brand Assets gamificationId string The gamificationId of your gamification setup playerIdentifier string The playerIdentifier you would like to reset Response Message Status code Message 200 Success 400 Bad Request Your accessKey / gamificationId / playerIdentifier is invalid. 403 Forbidden. Your accessKey is not permitted to access the api 404 playerIdentifier does not exist 500 Internal Server Error. This error will also be thrown if you already have a running operation and trying to start another one.

Competition Challenge Module The Competition – Challenge module lets you create time-based competitions in your Game Center. Players complete tasks or reach goals to qualify, and winners are selected at the end of each competition period. This is useful for driving engagement and encouraging repeat visits. Before You Start Make sure your Game Center includes at least one Game Module with a connected game. The competition uses these games to track player progress. Add a competition challenge Click Add Module. Select Competition – Challenge. Set the module status to Active when you are ready to start collecting data. Set module visibility to Visible or Hidden. Note The competition can run in the background even if the module is hidden. Set competition periods Add one or more time periods for the competition.You can: Add periods one by one Add multiple periods at once You can also enable a message for inactive periods if there are gaps between competitions. Set challenge type Choose how players qualify for the competition. Play onlyPlayers only need to play the game to qualify. Use game settingsUses the requirements defined in the selected games. Reach min. scorePlayers must reach a minimum score to qualify. Set competition requirement Choose how many games players need to complete.Complete allPlayers must complete all selected games. Complete onePlayers only need to complete one of the selected games. Select games Select which games should be included in the competition. Only games already added to a Game Module can be selected. Customize challenge text You can customize text shown before and after the challenge. This is useful for explaining how the competition works and how players can participate. Set prizes Configure prizes in the winner settings. You can: Add multiple prizes Select which periods they apply to Set when prizes should be distributed Winners are randomly selected from players who qualify for the challenge. You can also limit: How many times a player can win Whether a player can win the same prize multiple times Reward types Coupon code – same for everyoneAll winners receive the same code. Coupon code – unique for everyoneEach winner receives a unique code. URL – same for everyoneAll winners receive the same link. URL – unique for everyoneEach winner receives a unique link. NoneNo reward is distributed.All rewards (except none) are sent by email.Make sure to upload enough codes or URLs for the number of winners.

Competition Entries Module The Competition – Entries module lets you create time-based competitions where players collect entries for a chance to win prizes. The more entries a player collects, the higher their chance of winning. This is useful for encouraging repeat gameplay and ongoing engagement. Before You Start Make sure your Game Center includes at least one Game Module with a connected game. The selected games must also have entries enabled in their individual game settings. Add a competition entries module Click Add Module. Select Competition – Entries. Set the module status to Active when you are ready to start collecting entries. Set module visibility to Visible or Hidden. NoteThe competition can run in the background even if the module is hidden. Set competition periods Add one or more time periods for the competition.You can: Add periods one by one Add multiple periods at once You can also enable a message for inactive periods if there are gaps between competitions. Select games Select which games should be included in the competition.Only games that are added to a Game Module and have entries enabled can be selected. Configure entries display You can customize how entries are shown to players. Set the number of entries displayed Choose whether the entries counter appears above or below the text Customize competition text You can style the text shown before and after the competition.Use this to explain how players earn entries and how to participate. Set prizes Configure prizes in the winner settings.You can: Add multiple prizes Select which periods they apply to Set when prizes should be distributed Winners are randomly selected from players who have collected entries. Players with more entries have a higher chance of winning.You can also limit: How many times a player can win Whether a player can win the same prize multiple times Reward types Coupon code – same for everyoneAll winners receive the same code. Coupon code – unique for everyoneEach winner receives a unique code. URL – same for everyoneAll winners receive the same link. URL – unique for everyoneEach winner receives a unique link. NoneNo reward is distributed.All rewards (except none) are sent by email.Make sure to upload enough codes or URLs for the number of winners.

Competition High Score Module The Competition – High Score module lets you create time-based competitions where players compete for the highest score. Players are ranked on a leaderboard, and winners are selected based on their position at the end of each competition period. Before You Start Make sure your Game Center includes at least one Game Module with a connected game. Add a competition high score module Click Add Module. Select Competition – High Score. Set the module status to Active when you are ready to start collecting data. Set module visibility to Visible or Hidden. Note The competition can run in the background even if the module is hidden. Set competition periods Add one or more time periods for the competition.You can: Add periods one by one Add multiple periods at once You can also enable a message for inactive periods if there are gaps between competitions. Set competition periods Add one or more time periods for the competition.You can: Add periods one by one Add multiple periods at once You can also enable a message for inactive periods if there are gaps between competitions. Select score type Choose how scores are calculated on the leaderboard. Best scoreDisplays the highest score a player has achieved. Accumulated scoreCombines scores from selected games into one total score. Select games Select which games should be included in the competition. NoteDifferent games may use different scoring systems. Customize leaderboard You can adjust how the leaderboard appears in the Game Center.Options include: What player data is shown Visual styling You can also enable a leaderboard popup to display more players beyond the main view. Set prizes Configure prizes in the winner settings.You can: Add multiple prizes Select which periods they apply to Set when prizes should be distributed Winners are determined based on their position on the leaderboard. Reward types Coupon code – same for everyoneAll winners receive the same code. Coupon code – unique for everyoneEach winner receives a unique code. URL – same for everyoneAll winners receive the same link. URL – unique for everyoneEach winner receives a unique link. NoneNo reward is distributed. All rewards (except none) are sent by email.Make sure to upload enough codes or URLs for the number of winners.

Introduction to Game Design The design of your game plays an important role in how players experience your campaign. Flarie Studio allows you to customize the visual elements of a game so it aligns with your brand and design guidelines. Most elements in the games available in Flarie Studio can be customized. This gives you the flexibility to adjust visuals, branding, and interactive elements to match your campaign. The platform also includes advanced design features that allow you to create more dynamic and engaging experiences. Advanced design features Flarie Studio includes several features that help you enhance the visual experience of your game. Parallax effects Parallax effects create a sense of depth by moving background layers at different speeds. This can make the game feel more dynamic and visually engaging. Desktop backgrounds Desktop backgrounds allow you to customize how the game appears when played on desktop devices. This helps ensure the experience remains visually consistent across different screen sizes. Spritesheets Spritesheets allow you to control animations and visual elements within the game. They can be used to create smoother animations and more detailed visual interactions. Learn more If you want to explore ways to improve your game design and create more engaging experiences, see the onboarding guide below. Level up your game design https://flarie.com/help-station/level-up-game-design

Introduction to Game Settings Game Settings help you configure how your game works and how players interact with it. These settings allow you to control important parts of the game experience, including data collection, gameplay timing, language options, and interactive elements. In this chapter, you will learn about the different settings available in your game and how they affect the player experience. What you can configure Game Settings allow you to configure several aspects of your game, including: Data collection from players Custom terms and conditions Language settings Time periods for when the game is available Custom buttons with different actions or triggers These settings help you adapt the game to fit the needs of your campaign. Gamification features This section also introduces the gamification features available in Flarie Studio. These features are designed to increase engagement and encourage players to interact with your game. Gamification settings allow you to create experiences such as: Competitions Prize draws Leaderboards Using these features can help motivate players to return, compete, and interact more with your campaign. Learn more about gamification settings If you want to learn more about when and how to use different gamification settings, see the onboarding guide below. Tailor your game settings https://flarie.com/help-station/tailor-settings

Introduction to Game Center A Game Center is a customizable hub where you can bring multiple games, rewards, and promotions together in one place. It works like a digital arcade where players can access different games and interact with your campaign in a single environment. You can add games, create a reward store, and include promotional modules that link to external pages. What you can include in a game center A Game Center can contain several elements that work together to create a complete campaign experience. You can add: Multiple games A reward store Promotional modules linking to external URLs Wallet-based rewards All elements can be styled to match your brand. Wallet and rewards If the Wallet feature is enabled, players can earn in-game currency by playing games. This currency can then be used to redeem rewards in the reward store. This allows you to create a reward-based system that encourages players to keep returning and interacting with your games. Share your game center A Game Center can be shared in multiple ways: Direct link (URL) QR code Embedded inside an app This makes it easy to include the experience in campaigns, apps, or external platforms. When to use a game center Game Centers are useful when running campaigns that include more than one game or interaction. Common use cases include: Loyalty programs Seasonal campaigns Multi-game events Ongoing engagement campaigns By bringing games, rewards, and promotions together, the Game Center helps increase engagement and encourages players to return.

Custom Buttons Introduction Custom Buttons in Flarie are flexible elements—either text or image-based—that you can add to your games to create interactive or visual enhancements. They can link to external URLs, trigger image overlays, or simply serve as static design elements. You enable them via Game Settings, then customize their style, positioning, and behavior. Buttons can appear before gameplay, after it, or remain visible throughout the session, depending on your intent—like promoting offers, guiding users, or just adding polish. For efficiency, you can create and save reusable buttons in Assets & Settings, making it easy to apply consistent elements across multiple games.

Introduction to Assets & Settings Assets & Settings helps you standardize design, content, and configurations across your games. It allows you to reuse settings instead of setting them up manually for each new game. This helps save time and ensures consistency across your campaigns. What you can manage In Assets & Settings, you can define reusable elements such as: Colors and fonts Form parameters Email design Default settings for games These settings can then be applied automatically when creating new games. Redirection links Redirection Links allow you to create and manage links centrally. Instead of updating links in each game, you can update them in one place. This ensures that all games use the same link at all times. Why use assets and settings Using Assets & Settings helps you: Keep a consistent design across games Reduce manual setup when creating new games Avoid errors from repeated configuration This makes it easier to manage multiple campaigns and maintain a consistent brand experience.

Game Language The Game Language feature allows you to create multiple language versions of a game without duplicating the campaign or managing separate setups. All language versions remain connected to the same game. This means that winner generation, player statistics, prize distribution, and other gameplay data are shared across all languages. This feature is useful for global campaigns, multi-market launches, or any campaign where you want players to experience the game in their preferred language. Default language By default, the game language is set to English. You can change the default language in one of the following places: In the game’s Language Settings In Assets & Settings > Language Changing the default language in Assets & Settings ensures that all newly created games will use that language automatically. Add additional languages To create additional language versions of a game: Open your game’s Language Settings. Enable the toggle Enable Additional Languages. Click + Add. Select the language you want to add from the dropdown menu. Choose how the language name should appear to players. You can choose between two display options: EnglishDisplays the language name in English. CustomAllows you to enter a custom display name for the language. Once added, the language will appear in the Languages List and in the language sidebar. Editing game texts You can update translated texts in two different ways. Edit texts for all languages Click Edit text for all languages or the icon at the bottom of the language bar. This opens a popup containing all editable texts in the game. When new settings are added to the game, the related texts will automatically appear in this popup for easy translation. Edit texts in specific settings You can also navigate to a specific language and update the text fields directly within the relevant game settings. Language selector customization You can optionally customize how players switch between languages. Available options include: Uploading an icon for the language selector button Styling the language dropdown to match your game design How language settings affect game configuration When additional languages are enabled, a language bar appears on the left side of the settings panel. The default language is always listed at the top. All game settings can only be fully edited when the default language is selected. When an additional language is selected, only text fields can be edited. This ensures that translations remain consistent while the main game configuration stays controlled by the default language. At the bottom of the language bar, you can click the Edit texts for all languages icon to update all translatable fields in one place.

Authenticated UUID The Authenticated UUID feature adds an extra layer of security to your Game or Game Center. It ensures that only verified users can access your game by requiring a signed token. This is useful for integrations where you want to control exactly who can enter and interact with your game. How it works When enabled, the uuid parameter in your game URL must be a signed JWT (JSON Web Token). The token is validated by Flarie to ensure: It is correctly signed It has not been altered It was generated using your secret key If the token is invalid, the game will not load. Step 1: Generate a UUID Secret Key Go to Access Keys in Flarie Studio. Generate a UUID Secret Key. Keep this key secure. It is used to sign your tokens. Step 2: Set UUID as Player Identifier Open your game in Flarie Studio. Go to Game Settings → Data Collection. Set Unique Identifier to URL Parameter. This makes uuid a required parameter in your game URL. Step 3: Enable Authenticated UUID Enable the Authenticated UUID setting in your game. Once enabled, the uuid must be a signed JWT token. JWT structure A valid token contains: Header Defines the algorithm used. { "alg": "HS256", "typ": "JWT" } Payload Contains the player identifier: { "uuid": "example-player-uuid" } Signature Created using your UUID Secret Key. Example (Node.js) const jwt = require('jsonwebtoken'); const uuid = 'player-1234-abcd'; const secretKey = 'YOUR_UUID_SECRET_KEY'; // Replace with your actual key const token = jwt.sign({ uuid: uuid }, secretKey, { algorithm: 'HS256' }); const gameUrl = `https://your-game-url.com?uuid=${token}`; console.log(gameUrl); What happens during gameplay When a player interacts with the game: The token is validated The signature is verified using your secret key Invalid or tampered tokens are rejected Only users with valid tokens will be able to access and interact with the game.

Setting up your Account Please follow the below steps to get everything set up in your account and make sure the game creation will be as easy as possible. Invite Users Depending on your subscription you have a certain no of users included. Users you invite will receive an email where they can pick a password and activate their account. Go to the Manage Users page in Flarie Studio Add information to your Organization and Brand Account You will not be able to set your games to active until you have done this. Draft games will always have a draft banner on top of the start game image. Organization Page Brand Page Update Brand settings in Assets & Settings In Assets & Settings you can set things you want to use as standard in your games, such as Form Parameters, Terms, Language, Default Time Zone, and your Brand Prefix. By setting any of these 👆 they will automatically be used as the default for all games created afterwards. Read more about Assets & Settings Go to Assets & Settings in Flarie Studio

Level up your Game Design There are a lot of possibilities to style your game to really get the design that you are looking for. Sprite Sheets In a lot of games you can add Sprite sheets to create animations or multiple versions of objects or enemies in the games. Animation Object Randomization Read more about Sprite sheets here Style every object in the player flow Flarie Studio provides you with a lot of standard settings to design every element or text box in the way you want. You can also upload images instead of colors or gradients to really customize your design. If the standard settings are not enough you can also add Custom CSS to customize your design even further. Component Settings Most of the games have some possibilities to change the game mechanics. These settings you can find under Component Settings, and usually consists of the following: Change the sizes of objects. Change the positioning of elements. Change the difficulty of the game. Please open the Component Settings in your selected game to see the possibilities for that exact game.

Data Collection Games can be tailored to collect first party data ("1PD") in various ways, which can be collected directly in Flarie Studio or being sent to your system directly through our Data Integration if you have a Sky or Space Subscription. Flarie Studio is fully compliant with GDPR. (Read more here) Game Forms Pre Game Round If your main goal is to collect 1PD we recommend using the Data Collection setting to collect the data before the players initiate their first game round. This ensures that you collect data from everyone the plays your game. Post Game Round If your main goal is to get as many players as possible we recommend collecting data after the person has played the game. This lowers the threshold of starting the game, but will result in some people playing without leaving their information. By selecting the reward type "Form - Ask Users for Data" under Reward Details in Challenge or Luck Based Wins, it enables the post-game form for the user to fill in. Select player identifier By choosing your preferred identifier, you control how the game recognises unique players. Browser: The unique browser is used to identify players, which means there’s no requirement to provide any information before playing the first game round. However, if someone returns to the game using a different browser or has cleared their cache, the game will treat them as a new player, and they won’t see their previous results or progress. Email: When using email as an identifier, the game will always prompt the player to enter their email before starting the first round (unless they’ve been recognized from a previous session). This allows the experience to continue seamlessly, even if the player returns from a different browser. Phone Number: Works the same way as email, but uses the player’s phone number instead. UUID: If you're distributing the game through your own channels, you have the possibility to pass in a UUID as a URL parameter to identify the player. This way, the player doesn’t need to enter any information in the game, but can still continue their experience across sessions and devices — as long as the same UUID is passed every time. Data Integration (Requires Sky or Space subscription) Flarie Studio’s Webhook and Integration tools give you the power to connect your games with the rest of your tech stack in real time. Whether you want to respond instantly to in-game events, sync player data to your CRM, trigger automated email campaigns, or fuel analytics, these tools make it easy to pass data and activate actions across your favorite platforms. It’s a flexible way to make your game experiences smarter, more connected, and more impactful. Read more about Webhooks here Read more about Integrations here

Tailor your gamification settings To get the most out of your game and align it with your goals, it’s important to set it up in the right way. While our premium branded games perform exceptionally well even without competitions or prizes, adding a competitive element almost always amplifies the impact. In this section, we’ll walk you through different types of competition formats and how to distribute prizes effectively. Whether you're aiming to drive repeat play, increase time spent, or reward top performers, there’s a setup that fits your goals. Competitions Formats within the Challenge Feature Read more about Challenge and Multi Entry here Challenge - RaffleInstead of rewarding only top scorers, Flarie Studio's Raffle feature allows you to randomly select winners from all players who have reached a predefined minimum score. By setting a lower score threshold, you make it easier for more players to qualify — increasing inclusivity and boosting participation. Challenge - Multi Entry Raffle Enabling Multi Entry encourages your audience to engage with your game multiple times, as each successful attempt increases their chances of winning. This not only boosts excitement but also significantly enhances player retention and time spent. Challenge - Instant Reward Instead of randomizing winners, you can instantly reward players as soon as they reach the target score. This approach ensures every qualifying player gets a prize, driving immediate actions like redeeming a discount code or claiming a product sample — effectively incentivizing real-time engagement and conversion. Competitions Formats within the Luck Based Win Feature Read more about Luck Based Wins here Luck based - Wins Instant Reward By using Luck-Based Wins, every player who successfully completes the game is given a predefined chance to win a prize. This mechanic adds excitement and anticipation to the experience and can be combined with both Skill and Luck based games. You can tailor the probability to match your goals — for instance, setting a high win rate to reward many players with discount codes and boost conversion, or a lower win rate with more exclusive prizes to build prestige and drive engagement through scarcity. It's a flexible and effective way to balance mass participation with impactful rewards. Competitions Formats within the Leaderboard Feature Read more about the Leaderboard here Leaderboard - Highscore WinnersAdding a leaderboard allows players to compete for rewards based on their rank and performance — creating a fun, skill-based experience that encourages repeat play and deeper engagement. Whether you're hosting a local event or launching a broader activation, the format adds a layer of excitement that motivates players to keep coming back. You also have the option to display a player’s own ranking without showing the full leaderboard. This is particularly effective for broader activations, as it avoids potential issues like inappropriate usernames or players feeling discouraged by unreachable high scores — while still offering a sense of progress and achievement. Periods and Frequency You can of course run competitions with fixed start and end dates, but we consistently see the best results when using recurring formats. Not only does this encourage players to return regularly, it also reduces the need for ongoing admin — making the concept both more engaging and easier to manage over time. You can easily divide your game into daily, weekly, or monthly competitions — all set up in one go. Read more about Time Periods here Incentives and Prizes You can easily add any type of prize or incentive to your game, and the platform includes built-in tools for uploading and managing rewards directly — making it simple to distribute them to winners in a smooth and scalable way. You can either describe the prize in text and distribute it manually after winners have been selected, or upload the prizes directly into the platform for automatic delivery — giving you full flexibility depending on how you want to manage your game. The platform supports the upload of both generic and unique codes or URLs — allowing you to control whether rewards can be reused or are limited to one-time use. Read more about Prizes here By using webhooks or integrations between our platform and your system or CRM, you can automate data transfer and ensure that rewards are distributed and communicated directly through your own channels. Read more about Webhooks here Read more about connected providers

Platform Demo Watch this quick demo where we walk you through the basics of selecting and designing your first game in Flarie Studio. You'll learn how easy it is to get started, explore key features, and see how to bring your branded game to life in just a few steps. Ready to dive in? Hit play and follow along!

Flarie Studio Use Cases Over the years, we’ve seen what truly drives results and long-term ROI with Flarie Studio – and that’s what this section is all about. The examples and structures outlined below represent the use cases and strategies that have consistently delivered the strongest impact for our partners. But don’t worry, you don’t need to start there. We usually divide the strategies into two groups: For many brands, this is a journey. Some start with smaller, supporting use cases to explore the potential of gamification and build from there. Others dive straight into their core business goals. Both approaches are valuable and what matters most is taking that first step and evolving over time. At Flarie, we believe in long-term partnerships and building value gradually. Success doesn’t happen overnight — but with the right foundation and focus, you’ll build real momentum.

Choose the right games for you With insights from over 2,000 game activations, we've learned what matters most when selecting the right game for your campaign — and how to get the best possible results. 1. Start with Your Audience The single most important factor is choosing a game your audience enjoys playing. In Flarie Studio, you can filter games by demographics to help you find a match that fits your target group. 2. Match the Purpose of Your Activation Next, choose a game that aligns with your goals. Are you looking to maximize time spent? Or do you need a faster-paced game where players complete rounds within a short timeframe? In Flarie Studio, you can filter games on different KPIs. 3. Fit Your Message and Creative Assets Within the above criterias, pick a game that works well with the assets and messaging you want to communicate. Think of the game as a communication format, just like an image or video ad, designed to capture attention and drive engagement (meaning same communication you would have communicated in an image or video ad as well). Sorting Games in Flarie Studio To help you choose more easily, Flarie Studio offers several sorting options: Recommended: Based on performance metrics like time spent, number of rounds, retention, and popularity across different audiences. Latest: Discover newly added games. A–Z / Z–A: Sort games alphabetically for quick navigation. Pro Tip ☝️ Focus on the Player, Not the Product The most effective branded games are the ones that resonate with your audience, rather than trying to tie the game too closely to the product's attributes.. When players genuinely enjoy the game and it supports your campaign’s purpose, you’ll see stronger ROI and higher brand affinity. In contrast, games built strictly around product details often struggle to capture attention and engagement Average time spent in two of our games: Zidande vs Jewel 👆 See here how these companies did it

Introduction We have put together a step-by-step guide covering each phase of your onboarding, including scheduled meetings, platform walkthroughs, and best-practice use cases. You can follow the content at your own pace or jump directly to the section that’s most relevant to you. Onboarding Meetings Flarie Studio Use Cases Platform Demo Choose the right games for you Tailor your gamification settings Data Collection Level up your Game Design Setting up your account From setup to strategy, we’ve got you covered 🙌 Let’s begin your journey with Flarie Studio. Just hit the button below to go to the next step!

Onboarding Meetings 1. Onboarding Meeting We walk through everything to get you started and onboarded to Flarie Studio. 2. Launch of your first activation Getting your first activation ready to go. Q&A session Deep dive into relevant Settings and Features 3. First follow up (∼2 months in) Evaluation of the initial period Platform feedback Game Performance Walkthrough of new features and relevant Case Stories Plan forward 4. 6-months check in Evaluation of the first 6 months Deep dive - Ambtition and Performance Feature Requests Explore additional use cases for Flarie Studio Walkthrough of new features and relevant Case Stories Plan forward and your ambitions for the coming years

[GET] Game Details This api will list the details of your games in your account. An optional query parameter for status can be used to filter the games the api will return. Default status is ACTIVE. [GET] https://prod-api.flarie.com/v1/public/games Authentication The API expects an Authorization header with a value of Bearer . Learn more about Access Keys here. Authorization: Bearer {your api access key} Query Params You can use a query parameter "status" to filter what games the api should return. If status is not provided ACTIVE games will be returned by default. Name Type Description status string Game Status: ACTIVE, DRAFT, EXPIRED, REMOVED Example: below url will only return the games with status EXPIRED. https://prod-api.flarie.com/v1/public/games?status=EXPIRED Response 200 [ { "gameId": "3g18913e-74ee-4se6-b154-7d7a5e4dad61", "status": "ACTIVE", "startDate": "", "endDate": "2025-01-09 14:42:00", "timeZone": "Europe/Stockholm", "createdAt": "2025-01-21T14:42:17.000Z", "game": "knock", "name": "Winter-game-Newsletter", "type": "SINGLE_PLAYER", "language": "", "background": "https://dwfedcf5lscmq.cloudfront.net/skins/5c0a6c9a4c67e.png", "identifierFormInputType": "EMAIL", "gameCenterId": "", "gamificationConditionId": "", "gamificationId": "", "hasSplitGame": false, "timePeriods": [ { "id": "ae65908e-8563-4b1e-a0d5-945e7a21a356", "startDate": "", "endDate": "2025-01-09 14:42:00" } ] } ] Status code Message 200 Success 400 Api Access Key can not be empty 404 Api Access Key not found 500 Internal Server Error.

Events & Payload in Webhooks Flarie Studio allows you to trigger webhooks and CRM/ESP integrations based on a wide range of in-game events - giving you full control over when data is sent and exactly what’s included. In this guide, you’ll get a detailed overview of all available events and their corresponding payload structures. You’ll also learn how to customize the payload format, map Flarie parameters to your system, and - if needed - batch data for specific events like Winners & Prizes (webhook only). Events Game - Triggers First Game Start Description: Event sent the first time the Player starts the Game. Payload options: Event, Player, Game, Custom Form Submission - StartGame Description: Event sent every time the form is submitted when the Player starts the Game. Payload options: Event, Player, Game, Custom Game Start Description: Event sent every time the Player starts the Game. Payload options: Event, Player, Game, Custom Challenge Completed Description: Event sent when the Player completes the challenge by reaching the set target in your Game, This event will only be sent once per Game Period. Payload options: Event, Player, Game, Game Score, Custom Form Submission - Challenge Completed Description: Event sent when the Player submits the form after a Challenge has been completed. This event can be sent multiple times, since the Player can access the form and modify the details. Payload options: Event, Player, Game, Game Score, Custom Form Submission - Luck Based Winner Description: Event sent when the Player submits the form once a Luck Based game has been won. This event can be sent multiple times, since the Player can access the form and modify the details. Payload options: Event, Player, Game, Custom Game over Description: Event sent every time the Player completes a Game Round and submits a Game Score. Payload options: Event, Player, Game, Game Score, Custom Winners & Prizes Description: Event sent with the generated winners when a Game or Game Period expires. Here you have the option to receive the winners by bulk or as single winner (one request sent per winner). Payload options: Event, [Winners], Custom Luck Winner Created Description: Event sent when the Player is defined as a winner in Luck Based Wins. Payload options: Event, Player, Game, Custom Game Center - Triggers Game Center SignUp Description: Event sent when the Player successfully registers in your Game Center. Payload options: Event, Player, Game Center, Custom Game Center Additional Form Submission Description: Event sent when the Player submits the form of additional parameters in your Game Center. This popup will appear for the player if you add parameters to your Game Center and the Player has previously already registered. Payload options: Event, Player, Game Center, Custom Game Center Store Purchase Description: Event sent when the Player purchase a Store Item in the Game Center. Payload options: Event, Player, Game Center, Store Purchase, Custom Game Center Competition Winners Description: Event sent when a Game Center Competition time period expires. Payload options: Event, Game Center, Game Center Winners, Game Center Competition, Custom Surveys - Triggers First Survey Start Description: Event sent the first time the Player starts the Survey. Payload options: Event, Player, Survey, Custom Survey Start Description: Event sent every time the Player starts the Survey. Payload options: Event, Player, Survey, Custom Form Submission - Start Survey Description: Event sent every time the form is submitted when the Player starts the Survey. Payload options: Event, Player, Survey, Custom Form Submission - Challenge Completed Description: Event sent when the Player submits the form after a Challenge has been completed. This event can be sent multiple times, since the Player can access the form and modify the details. Payload options: Event, Player, Survey, Game Score, Custom Form Submission - Luck Based Winner Description: Event sent when the Player submits the form once a Luck Based game has been won. This event can be sent multiple times, since the Player can access the form and modify the details. Payload options: Event, Player, Survey, Custom Challenge Completed Description: Event sent when the Player completes the challenge by reaching the set target in your Game, This event will only be sent once per Game Period. Payload options: Event, Player, Survey, Game Score, Custom Winners & Prizes Description: Event sent with the generated winners (array) when a Survey or Survey Period expires. Here you have the option to receive the winners by bulk or as single winner (one request sent per winner). Payload options: Event, [Winners], Custom Luck Winner Created Description: Event sent when the Player is defined as a winner in Luck Based Wins. Payload options: Event, Player, Survey, Custom Persona Completed Description: Event sent when a player completes a Survey and receives a personal result. Payload options: Event, Player, Survey, Persona, Custom Persona Answer Description: Event sent when a player selects an answer in a survey. Payload options: Event, Player, Survey, Answer, Custom Payload options - Flarie Values Event Description: Data about the event itself. Flarie Value JSON value Description eventId @event.eventId The id for the event eventName @event.eventName The name of the webhook eventType @event.eventType The type of event, e.g. GAME_START PlayerDescription: Data about the Player from your userbase. Flarie Value JSON value Description playerId @userbase.playerId Default Flarie Parameter uuid @userbase.uuid Default Flarie Parameter username @userbase.username Default Flarie Parameter email @userbase.email Default Flarie Parameter firstName @userbase.firstName Default Flarie Parameter lastName @userbase.lastName Default Flarie Parameter fullName @userbase.fullName Default Flarie Parameter company @userbase.company Default Flarie Parameter phone @userbase.phone Default Flarie Parameter age @userbase.age Default Flarie Parameter gender @userbase.gender Default Flarie Parameter birthday @userbase.birthday Default Flarie Parameter address @userbase.address Default Flarie Parameter country @userbase.country Default Flarie Parameter city @userbase.city Default Flarie Parameter zipCode @userbase.zipCode Default Flarie Parameter src @userbase.src Deprecated. Will be removed soon. businessRegion @userbase.businessRegion Default Flarie Parameter consent @userbase.consent Default Flarie Parameter consentMandatory @userbase.consentMandatory Default Flarie Parameter playerLanguage @userbase.playerLanguage Default Flarie Parameter param1 @userbase.param1 param1 is locked to Marketing Consent param2-10 @userbase.param2-10 Custom Parameter created in Assets & Settings terms1-5 @userbase.terms1-5 Deprecated. Will be removed soon. other1-5 @userbase.other-1-5 Deprecated. Will be removed soon. Game Description: Data about the Game Flarie Value JSON value Description gameId @game.gameId The gameId gamePeriodId @game.gamePeriodId The gamePeriodId if split game is enabled game @game.game The name of the game in the library gameName @game.gameName The name you have given your game Game Score Description: Data about the Score of the current Game Round Flarie Value JSON value Description score @gameScore.score The score in the game round timeSpent @gameScore.timeSpent the amount of seconds played in the game round Game Center Description: Data about the Game Center Flarie Value JSON value Description gameCenterId @gameCenter.gameCenterId The gameCenterId gameCenterName @gameCenterme.gameCenterName The name of your Game Center Game Center: Store Purchase Description: Data about the Store Item Flarie Value JSON value Description gameCenterStoreId @gameCenterStore.gameCenterStoreId The Store Item Id gameCenterStoreName @gameCenterStore.gameCenterStoreName The Store Item name gameCenterStoreCoinPrice @gameCenterStore.gameCenterStoreCoinPrice The Store Item cost in coins Game Center: Competition Description: Data about the Game Center Competition Flarie Value JSON value Description competitionModuleId @gameCenterCompetition.competitionModuleId The Game Center Competition Id competitionModuleName @gameCenterCompetition.competitionModuleName The Game Center Competition Name competitionModuleType @gameCenterCompetition.competitionModuleType The Game Center Competition Type competitionModuleTimePeriodId @gameCenterCompetition.competitionModuleTimePeriodId The Game Center Competition Time Period Id competitionModuleTimePeriodEndDate @gameCenterCompetition.competitionModuleTimePeriodEndDate The Game Center Competition Time Period End Date competitionModulePrizeId @gameCenterCompetition.competitionModulePrizeId The Game Center Competition Prize Id competitionModulePrizeName @gameCenterCompetition.competitionModulePrizeName The Game Center Competition Prize Name Game Center: Winners Description: Data about the Game Center Competition Winners Flarie Value JSON value Description playerId @gameCenterWinner. The playerId of the winner playerIdentifier @gameCenterWinner. The Identifier option (playerId, email, phone or uuid) email @gameCenterWinner. The email of the player ranking @gameCenterWinner. The players ranking in the competition entries @gameCenterWinner. The number of entries the player had in the competition highscore @gameCenterWinner. The players highscore in the game Winners Description: Data about the Winners Flarie Value JSON value Description playerId @winner.playerId The playerId playerIdentifier @winner.playerIdentifier The Identifier option (playerId, email, phone or uuid) email @winner.email The email of the player username @winner.username the username of the player highscore @winner.highscore The players highscore in the game highscoreTime @winner.highscoreTime The amount of seconds played during the highscore ranking @winner.ranking The players ranking in the game Note! If you wish to use the Winners&Prizes event and receive all winners in one request, you may use Send in Bulk and Custom JSON Payload. The data needs to be formatted as an array as the example below. This will create an object of all winners within the array as the payload automatically. Custom Description: Custom attributes for hard coded values Flarie Value JSON value Description Text - Send custom text Number - Send custom number Boolean - Send custom boolean

GUIDE: Create your first Webhook in Flarie Studio Setting up a webhook in Flarie Studio is quick and easy. Let's get cracking! 1. Setup Configure the basics! Give your Webhook a Name. It will make it easier to keep of track of things! Set the Status to Active, because only Active webhooks will send requests. Define the URL where Flarie Studio should send the webhook data. All requests are sent using the POST method. Make sure your server is ready to receive and handle JSON payloads. - For this example we will use the very handy webhook.site to test things out! It allows us to quickly get an endpoint we can play around with to test the feature and see each request. 2. Request Configuration Select the appropriate Authentication Type and add any Custom Headers suitable for your need. In this example we will select the Flarie Authentication, which will utilize the built in API Access Key of your account and automatically add a "Bearer " in our Header as our Authorization method. Learn more in the Authentication & Headers guide. We will for this example not add any Custom Headers. We will also select the method to be POST. 3. Select Trigger Choose when the webhook should fire. Flarie supports events for both Games and Game Center. In this example we will select the Webhook type Games and the event we want to act as our trigger will be Game Start. This means that every time the game is started by a player the webhook should be triggered. Learn more about the different options for Triggers here. 4. Select Data to Send This is where it starts to get fun! In this step you customize exactly what data should be sent in the request. You can select two options here: Key-Value Pairs - define the key and set the appropriate Flarie Parameter as the value. Custom JSON Payload - If you are a little bit more technical you can format the JSON freely. It’s important to note that any Flarie Parameters you define in this step as the value must also be configured in your game for the webhook to send properly. For this example, we’ll create a game and enable Data Collection and set Email as the identifier, along with Username as an additional form parameter. This configuration will prompt a form to appear before the game starts, ensuring that the required data is collected from the player and available for the webhook to use. Make sure the Game is Active, since only Active games will trigger webhooks. Back to the webhook! Why not provide an example for either approach? (So you can choose freely). Key-Value Pairs Custom JSON Payload See what I did there? I also added one of the many other available built-in parameters (game). Learn more about the different options for you Payload here. 5. Select what games should send webhooks The final step in this guide is just selecting the game we created in step 3 so it will start sending data when players are coming in. Game Play Load the game, fill the form and play! Results Next we navigate to the webhook.site we configured to see the request. Piece of cake! Need help setting up your integration? Contact Us

Webhook Headers & Authentication When sending data from Flarie to external systems, it is important to secure your webhook requests. Flarie provides flexible authentication options and full control over request headers to help protect your integrations. Request configuration You can choose how your webhook requests are authenticated. None No authentication is included in the request.Use this only for public endpoints or testing. Flarie authentication (recommended) Automatically includes your API Access Key as a Bearer token.Authorization: Bearer This ensures requests can be verified as coming from Flarie. TipValidate this token on your server to confirm the request source. Custom authentication Use this when your endpoint requires specific credentials.Basic authEnter a username and password. These are encoded and sent as:Authorization: Basic Bearer tokenEnter a token that will be sent as:Authorization: Bearer Custom headers You can add additional headers to your webhook request. Click Add Header +. Enter a header name and value. Example:Header name: x-api-keyHeader value: 12345-ABCDEThis will be sent with the request and can be used for authentication or metadata.You can combine custom headers with any authentication method. X-Signature header (optional) Learn how to enable Secret Key in Flarie Studio hereFor additional security, you can enable the X-Signature header.When enabled, each request includes a signature: X-Signature: This signature is generated using HMAC-SHA256 with your Secret Key and the request payload. It allows you to verify that: The request is from Flarie The payload has not been modified Verify signature (example) const crypto = require("node:crypto"); // Example payload (exact JSON string from the request body) const payload = // your json payload from the webhook const payloadString = JSON.stringify(payload); // Your Secret Key from Flarie Studio const secretKey = "your-secret-key"; // Generate the expected HMAC-SHA256 signature const calculatedSignature = crypto .createHmac("sha256", secretKey) .update(payloadString) .digest("hex"); // Compare with the X-Signature from the request header const xSignature = "X-Signature-in-the-header"; if (xSignature === calculatedSignature) { console.log("✅ Payload is authentic and unmodified") } else { console.log("⚠️ Payload is modified") } Recommendation Using authentication together with X-Signature verification provides the highest level of security for your webhook integrations. Need additional help setting up your integration? Contact Us

Introduction Who can use this feature: Admin, Manager Our Integration tool makes it easy to pass user and gameplay data in real time to your favorite platforms, whether you're managing contacts in a CRM, launching email campaigns with an ESP, or powering automated actions in your marketing stack. 👇 Choose from one of the providers below for a tutorial on how to set up an integration to your platform of choice: ActiveCampaign Apsis Brevo Campaign Monitor GetResponse HubSpot Klaviyo MailChimp Piggy SalesForce Sales Cloud Voyado Zoho CRM Need help setting up your integration? Contact Us

Contact us We’re here to support you, whether you're just getting started or looking to take things to the next level. 🗓️ Book a Meeting Want a guided tour of the platform? Curious about how others have used Flarie Studio to succeed? Need to talk about license options? Book a meeting with our team and we’ll be happy to walk you through it all. Book a meeting ✉️ Send Us an Email Have questions about features, need help setting up a concept, or looking for inspiration? Drop us a message and we’ll get back to you with ideas and answers. Send us an Email 🪐 Visit flarie.comLooking for more info about Flarie and what we do? Head over to our website to explore our solutions, cases, and latest updates. Visit the website

Salesforce Sales Cloud Integration This integration will create or update a Salesforce contact. It ensures that user data collected in Flarie Studio is seamlessly synced to Salesforce, enabling CRM enrichment, personalized email marketing, automated workflows, and advanced contact segmentation. Configuration The following Salesforce credentials are required to authenticate and correctly pass data to Salesforce. Client Id Client Secret How to generate your authentication credentials 1. Go to Advanced Setup 2. Go to Apps -> Apps Manager -> Press New Connected App 3. Create a Connected App 4. Provide Details. Callback URL is required, but not used for this integration. 5. Select appropriate Oauth Scopes and requirements. 6. Next Press Manage Consumer Details. You will be prompted to verify your account before seeing your client id and client secret. Salesforce will in this step call them consumer_key and consumer_secret. 7. Next navigate to Manage Connected Apps and press edit on the one you just created. 8. Press the Icon next to Client Credentials Flow -> Run as Lookup and Select a User. This is required in order to create an authentication token in the integration. BaseUrl - To connect to Salesforce you need to add your BaseUrl 1. Go to Company Settings -> My Domain. Make sure to use Current My Domain URL but remove salesforce.com External Id SalesForce recommended approach for integrations is to create an external id. Below is a guide for how you create an external Id. 1. Open Advanced Settings and press Object Manager. Scroll Down to Contact. 2. Go to Fields & Relationships. In the column Field Name you will find the Salesforce Sales Cloud Key you will use within Flarie Studio. Press New to create a field. 3. Select Text as Data Type 4. Name your Label and set the Length. Make sure to check "Unique" and "External Id" 5. Redo step 2 in order to get your External Id from the field you just created. Payload Requirements This section defines what is mandatory to send to Salesforce. Email - the core identifier for a Salesforce contact. Required in order to create or update a contact. Pass additional Flarie Parameters to Salesforce You may pass additional parameters to Salesforce. This can be done by passing a value on either a default field within Salesforce or by creating a custom field. See guide regarding External Id above in order to create a custom field or learn how to get the Field Name. The Field Name is what you will use as the Salesforce Sales Cloud Key within Flarie Studio. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

Zoho CRM Integration This integration will create or update a Zoho CRM contact. It ensures that user data collected in Flarie Studio is seamlessly synced to Zoho CRM, enabling CRM enrichment, personalized email marketing, automated workflows, and advanced contact segmentation. Configuration The following Zoho CRM credentials are required to authenticate and correctly pass data to Zoho CRM. Client Id Client Secret How to create your api credentials 1. Go to Settings -> Developer Hub -> Apis and SDKs -> press Register New Client under Server Side SDKs 2. Select Self Client 3. Go to Client Secret to get you Client Id and Client Secret Organization Id How to get your Organization Id 1. Go to Settings -> General -> Company Settings Region You can spot the region by looking at the ending of your domain. Payload Requirements This section defines what is mandatory to send to Zoho CRM. Email - the core identifier for a Zoho CRM contact. Required in order to create or update a contact. Pass additional Flarie Parameters to Zoho CRM You may pass additional parameters to Zoho CRM. This can be done by passing a value on either a default field within Zoho CRM or by creating a custom field. How to create Custom Fields within Zoho CRM 1. Go to Settings -> Customization -> Modules and Fields -> select Contacts 2. Within Contacts, navigate to Fields and press Create and Edit Fields 3. Add the Field type of your choice and provide a name Get Field Keys In order to add the Zoho CRM Key in Flarie Studio you need the Field Key for each value you want to pass to Zoho CRM. Below is a guide where you find the Field Keys. 1. Go to Settings -> Developer Hub -> APIs and SDKs and press API names 2. Select Contacts 3. Navigate to your Field. The API Name is what you need to use as the Zoho CRM Key in Flarie Studio Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

Klaviyo Integration This integration will create or update a Klaviyo profile. It ensures that user data collected in Flarie Studio is seamlessly synced to Klaviyo, enabling CRM enrichment, personalized email marketing, automated workflows, and advanced profile segmentation. Configuration The following Klaviyo credentials are required to authenticate and correctly pass data to Klaviyo. Private Api Key - created as Custom Key with Profiles read/write access. How to generate your Private Api Key with the correct permissions. 1. Go to Settings -> Account -> Api Keys -> Press Create Private API Key 2. Select Custom Key and provide read/write access for Profiles Payload Requirements This section defines what is mandatory to send to Klaviyo. Email or PhoneNumber - this will act as the core identifier for a Klaviyo Profile. Required in order to create or update a Profiles. Pass additional Flarie Parameters to Klaviyo You may pass additional parameters to HubSpot. This can be done by passing a value on either a default property within Klaviyo or by passing a value to act as a custom property. Note! For custom properties you do not need to create them in Klaviyo, just provide the key name in Flarie Studio and the property will appear in each Profile. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

ActiveCampaign Integration This integration will create or update an ActiveCampaign contact. It ensures that user data collected via Flarie Studio is passed to ActiveCampaign for email marketing, automation, and segmentation purposes. Configuration The following ActiveCampaign credentials are required to authenticate and correctly pass data to ActiveCampaign. API Key - used to authorize access to your ActiveCampaign account. How to generate your Api Key. 1. Go to Settings -> Developer -> Grab the KEY Account Name (URL) 1. Go to Settings -> Developer -> Grab the URL Payload Requirements This section defines what is mandatory to send to ActiveCampaign. Email - the core identifier for an ActiveCampaign contact. Required in order to create or update a contact. Pass additional Flarie Parameters to ActiveCampaign You may pass additional parameters to ActiveCampaign. This can be done by passing a value on either a default field within ActiveCampaign or by creating a custom field. How to create and manage ActiveCampaign Fields 1. Go to Contacts -> Field Grab the personalization tag for the default fields. Make sure to add them as lowercase in Flarie Studio. Note! ActiveCampaign does not provide the fieldId in their dashboard. You will need to contact ActiveCampaign to get the field Id, use their api or finding the fieldId in the developer console in your browser. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

GetResponse Integration This integration will create or update a GetResponse contact in a designated List. It ensures that user data collected via Flarie Studio is passed to GetResponse for email marketing, automation, and segmentation purposes. Configuration The following GetResponse credentials are required to authenticate and correctly pass data to the intended List in GetResponse. API Key - used to authorize access to your GetResponse account. How to generate your Api Key. 1. Go to Integrations and API under CONNECT 2. Go to API -> Generate API key List Token - specifies which List in GetResponse the contact should be created or updated in. How to get your List Token. 1. Go to Lists -> Settings 2. Get your List Token. Note! It's only the List Token you need, please ignore the List Id. Payload Requirements This section defines what is mandatory to send to GetResponse. Email - the core identifier for a GetResponse contact. Required in order to create or update a contact. Pass additional Flarie Parameters to GetResponse You may pass additional parameters to GetResponse. This can be done by passing a value on either a default field within GetResponse or by creating a custom field. Note! The Custom Field Ids are not publicly available in the GetResponse dashboard. You need to contact GetResponse to get these ids or get the ids by their custom-fields api: [GET] https://api.getresponse.com/v3/custom-fields Note! Whenever you are using custom fields, make sure to check Is Custom Field in Flarie Studio. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

Campaign Monitor Integration This integration will create or update a subscriber in Campaign Monitor in a specific List. It ensures that user data collected via Flarie Studio is passed to Campaign Monitor for email marketing, automation, and segmentation purposes. Configuration The following Campaign Monitor credentials are required to authenticate and correctly pass data to the intended List in Campaign Monitor. API Key - used to authorize access to your Campaign Monitor account. How to generate your Api Key. 1. Go to Account Settings -> API keys 2. Create an API Key List Id - specifies which List in Campaign Monitor the subscriber should be created or updated. How to get your List Id. 1. Go to Lists & Subscribers -> Lists 2. Enter the List and go to Settings. Find your List API ID Payload Requirements This section defines what is mandatory to send to Campaign Monitor. Email - the core identifier for a Campaign Monitor subscriber. Required in order to create or update a subscriber. ConsentToTrack - Needs to be set to Yes, No our Unchanged. Pass additional Flarie Parameters to Campaign Monitor You may pass additional parameters to Campaign Monitor. This can be done by passing a value on either a default field within Campaign Monitor or by creating a Custom Field. How to create and Manage Campaign Monitor Fields 1. Go to Lists & Subscribers -> Enter your List -> Custom Fields Use a field already created or add your own custom field. Use the Perzonalization tag as your Campaign Monitor Key in Flarie Studio. Note! Don't forget to click Is Custom Field for the Fields you have created yourself. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

Mailchimp Integration This integration will create or update a Mailchimp contact in a designated Audience (List). It ensures that user data collected via Flarie Studio is passed to Mailchimp for email marketing, automation, and segmentation purposes. Configuration The following Mailchimp credentials are required to authenticate and correctly pass data to the intended audience in Mailchimp. API Key - used to authorize access to your Mailchimp account. How to generate your Api Key. 1. Go to Account & Billing 2. Go to Extras -> Api Keys. 3. Create an Api Key Server Prefix - found as part of the API URL (e.g., us6, us20), this identifies the correct Mailchimp server. List Id (Audience Id) - specifies which Audience in Mailchimp should receive the new or updated contact. How to get your Audience Id.1. Go to Settings within the Audience Dashboard 2. Scroll to the bottom of the page and you will find your Audience Id Payload Requirements This section defines what is mandatory to send to Mailchimp. Email - the core identifier for a Mailchimp contact. Required in order to create or update a contact. Pass additional Flarie Parameters to Mailchimp You may pass additional parameters to Mailchimp. This can be done by passing a value on either a default parameter within Mailchimp or by creating a custom parameter. How to create and Manage Mailchimp Audience fields & tags 1. Go to Settings -> Audience fields & "MERGE" tags within All Contacts 2. Get the Tag from the attribute you want to use. This is what you use as the Mailchimp Key in Flarie Studio. 3. Create a new field type (custom parameter). Below we have created a Custom Text Field called Flarie Game. This attribute have the tag FLARIEGAME, which is what you need to use as the Mailchimp Key in Flarie Studio. Mailchimp: Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

Apsis Integration This integration will create or update an Apsis contact in a specific Audience/Section. It ensures that user data collected in Flarie Studio is seamlessly synced to Apsis, enabling CRM enrichment, personalized email marketing, automated workflows and advanced contact segmentation. Configuration In order to authenticate and correctly pass data to Apsis you need to create an API Key and use the following in Flarie Studio. Client Id Client Secret How to create your API Key in Apsis 1. Go to Account Settings -> Api Management -> Add API Key 2. Next you need to set your Apsis Region in Flarie Studio. Options are EU or APAC. 3. Next you need to set your Section Discriminator to determine in what Section the contact should be created. This Section Discriminator Key is not publicly available in Apsis. Please contact Apsis to get this key or use the network tab to find it. 4. As the last step you need to define the Key Space Discriminator. This is basically letting Apsis know how your contacts are identified. Options are: com.apsis1.keyspaces.email com.apsis1.keyspaces.crm-id com.apsis1.keyspaces.mobile Please note that your Profile Key defined in "Select Data to Send" need to match this value. Payload Requirements This section defines what is mandatory to send to Apsis. Profile Key - the core identifier for your Apsis contact. Required in order to create or update a contact. Options are:Email CRM-Id Mobile Please note that your Key Space Discriminator need to match your Profile Key. Pass additional Flarie Parameters to Apsis You may pass additional parameters to Apsis. This can be done by passing a value on either a default attribute within Apsis or by creating a custom attribute. How to create and manage Apsis Attributes 1. Go to Account Settings -> Sections -> Click into the Section you want to edit 2. In your Section select an attribute or create a new attribute. Give it a name and define the type. The Attribute Discriminator is what you will use as the Apsis Integration Key in Flarie Studio. Make sure the api operation has read and write permissions. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

Piggy Integration This integration will create or update a Piggy contact. It ensures that user data collected in Flarie Studio is seamlessly synced to Piggy, enabling CRM enrichment, personalized email marketing, automated workflows, and advanced contact segmentation. Configuration The following Piggy credentials are required to authenticate and correctly pass data to Piggy. Personal Access Token How to generate your a Personal Access Token 1. Go to Apps -> Integrations -> Personal Access Tokens and create a token. Payload Requirements This section defines what is mandatory to send to Piggy. Email - the core identifier for a Piggy contact. Required in order to create or update a contact. Pass additional Flarie Parameters to Piggy You may pass additional parameters to Piggy. This can be done by passing a value on either a default attribute within Piggy or by creating a custom attribute. How to create and manage Piggy attributes 1. Go to Settings -> Custom Attributes 2. Click the Attribute or create a new one. You will need to use the Internal name within Flarie Studio as the Piggy Key to populate the attribute. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

Brevo Integration This integration will create or update a Brevo contact in one or several Lists. It ensures that user data collected via Flarie Studio is passed to Brevo for email marketing, automation, and segmentation purposes. Configuration The following Brevo credentials are required to authenticate and correctly pass data to the Lists in Brevo. API Key - used to authorize access to your Brevo account. How to generate your Api Key. 1. Go to SMTP & API 2. Go to API Keys and Generate a new API Key List Id - specifies in what List the contact should be created or updated. How to get your List Id. 1. Go to Lists and get the id from the ID column. Add the Ids you want to use as comma separated values in Flarie Studio. Payload Requirements This section defines what is mandatory to send to Brevo. One of the three below must be sent as the Brevo Required Key. Email SMS EXT_ID Pass additional Flarie Parameters to Brevo You may pass additional parameters to Brevo. This can be done by passing a value on either a default attribute within Brevo or by creating a new attribute. How to create and manage Brevo attributes 1. Go to Settings -> Contact Attributes 2. Get the Attribute Name from the attribute you want to use. This is what you use as the Brevo Key in Flarie Studio. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

HubSpot Integration This integration will create or update a HubSpot contact. It ensures that user data collected in Flarie Studio is seamlessly synced to Hubspot, enabling CRM enrichment, personalized email marketing, automated workflows, and advanced contact segmentation. Configuration The following HubSpot credentials are required to authenticate and correctly pass data to HubSpot. Oauth Token - created in Private Apps with CRM Contacts read and write permissions. How to generate your Oauth Token with the correct permissions. 1. Go to Settings -> Integrations -> Private Apps 2. Create a Private App. Give it a name and give the Token the following permissions: crm.objects.contacts.read crm.objects.contacts.write Payload Requirements This section defines what is mandatory to send to HubSpot. Email - the core identifier for a HubSpot contact. Required in order to create or update a contact. Pass additional Flarie Parameters to HubSpot You may pass additional parameters to HubSpot. This can be done by passing a value on either a default property within HubSpot or by creating a custom property. How to create and manage HubSpot properties 1. Go to Settings -> Data Management -> Properties 2. Click Edit Property to see the Property Details. The Internal Name is what you need use as the HubSpot Integration Key in Flarie Studio. Flarie Studio: 📦 Events & Payload — Explore available triggers and payload formats

[POST] Reset Attempts for all Players This guide is for resetting the Attempts for all players for a Gamification Attempts Scenario created in Flarie Studio. Please note that this will reset all attempts for all players and it might take some time for this operation to be completed. [POST] https://prod-api.flarie.com/rest/gamification-service/v1/public/reset-attempts Payload { "accessKey": "string", "gamificationId": "string", } Name Type Description accesskey string Brand Access Key. You can generate your accessKey in Flarie Studio → Manage Brand Assets gamificationId string The gamificationId of your gamification setup Response Message Status code Message 200 Success 400 Bad Request Your accessKey / gamificationId is invalid. 403 Forbidden. Your accessKey isn't permitted to access the api 500 Internal Server Error. This error will also be thrown if you already have a running operation and trying to start another one.

Brand Prefix Who can use this feature: Admin, Manager The Brand Prefix is used in the URLs of your redirection links. It helps identify your brand and keeps your links consistent. Set brand prefix Go to Assets & Settings → Brand Prefix. Enter the prefix you want to use. By default, this is set to your brand name without special characters. How it works The brand prefix will be included in all redirection link URLs you create. Using a consistent prefix makes your links easier to recognize and manage.

Language Who can use this feature: Admin, Manager The Language setting lets you choose the default language used for system texts across your Games and Game Centers. This applies to non-editable texts and default content. Set default language Go to Assets & Settings → Language. Select your preferred language from the dropdown. How it works The selected language will be used as the default for all new Games and Game Centers. You can still change the language in individual game or Game Center settings if needed.

Desktop Background Image Who can use this feature: Admin, Manager, Designer The Desktop Background Image setting allows you to upload a default background that will be used across your Games and Game Centers. This helps ensure a consistent visual experience without needing to upload the same image for each new setup. Upload a desktop background image Go to Assets & Settings → Desktop Background Image. Drag and drop an image, or select a file to upload. Upload it to Default Game Page Background Image. How it works Once uploaded, the image will automatically be used as the default background for all new Games and Game Centers. You can still change or override the background in individual Game or Game Center settings if needed.

Colors Who can use this feature: Admin, Manager, Designer The Colors section allows you to create and save color swatches for your brand. This makes it easier to apply consistent colors when styling components across Games and Game Centers. Add a color Go to Assets & Settings → Colors. Click Add Color. Select a color using the color picker or enter a hex code. (Optional) Add a name for the color to make it easier to identify. Use colors Saved colors will be available in the color picker under the Assets tab.You can use them when styling: Text Buttons Backgrounds Other visual elements Using saved colors helps maintain a consistent design across your projects.

Custom Button Who can use this feature: Admin, Manager, Designer The Custom Button feature allows you to create reusable buttons that can be added to your games. Buttons can be text-based or image-based and can trigger actions such as opening a URL, showing an image overlay, or acting as a visual element. Creating buttons in Assets & Settings saves time and ensures consistency across multiple games. Create a custom button Go to Assets & Settings → Custom Button. Click + Add Custom Button. (Optional) Add an internal name to help identify the button. (Optional) Set the button as default to automatically include it in new games. Add text or upload an image. Style the button to match your design. Choose when the button should appear: Always visible After a game round You can add multiple buttons if needed. Make sure to adjust positioning so buttons do not overlap. Manage buttons To remove a button: Click the trash icon on the button Deleted buttons will no longer appear in the Game Settings dropdown. Use a custom button in a game Custom buttons created in Assets & Settings are available in your Game Settings. Open your game settings. Select a button from the dropdown at the top of the Custom Button section. The selected button will automatically apply its pre-configured design and behavior to your game.

Publish Game and Version History Publish Game The Publish function lets you control when changes to your game go live. This allows you to make edits without affecting the version currently visible to players. Changes you make are saved automatically but will not appear in the live game until you publish them. Key features Initial published version When you create a new game, it is automatically published as the first version. Game cards On the Games Dashboard, each game card shows the currently published version. If there are unpublished changes, a banner will appear to notify you. Excluded sections Some settings are not part of the publish workflow. Changes to Time Period and Game Status are applied immediately and cannot be unpublished. Share published link Use Share Published Link to copy the link to the most recently published version of your game. Publish changes Make edits to your game. When changes are made, the Publish button becomes active. Click Publish when you want your changes to go live. Once published, the latest version will be visible to players through the shared game link. Version history Version History allows you to view and manage previously published versions of your game. This makes it easy to review past changes or restore an earlier version. Open version history Open the Other Options dropdown in your game. Select Version History. A panel will appear on the right showing all published versions of the game. Version overview Unpublished draft Your current draft appears at the top of the list and is labeled Unpublished. Published versions All previously published versions appear below, listed from newest to oldest. The latest published version is marked Latest Published. Version details Each version shows the date, time, and user who made the update. Available actions Click the ... icon next to a version to access the available actions. Copy settings to a new gameCreate a new game using the settings from that version. Duplicate this versionCreate an exact copy of that version of the game. Restore this versionReplace your current draft with the selected version. Preview and restore a version You can select a version from the panel to preview it. The game will update in view-only mode so you can review the settings. If you choose to restore the version, confirm the action in the pop-up. The restored version becomes your current draft and replaces any unpublished changes. Exit version history Click Exit Version History or close the panel to return to the normal game settings view. Using Version History allows you to experiment with updates while keeping the option to return to an earlier version if needed.

FAQ The file I uploaded does not look right - what did I do wrong? Make sure that you follow the specified file formats as well as the measurements. Objects that do not follow the specifications often appear broken or invisible. The recommended image size is always specified above the image drop box. How do I upload my own font? You can upload your own fonts under Assets & Settings --> Fonts. You will need to upload two font weights. The font will then be available in all font selection drop-down across the platform. You can read more about adding fonts in Assets & Settings here. Can I use Gifs/animations in my Game? No. Flarie Studio does not support GIFs or animations to be uploaded. The biggest reason for this is that it will negatively impact the user experience as the Game will take much longer to load. Many of our Games does support Sprite Sheets though, which can be used as animations. If the Image in a Game supports spritesheet, this will always be stated in the image title. You can read more about sprite sheets here. How do Spritesheets work? A sprite sheet is a single image file that contains multiple smaller images (or "sprites") arranged in a grid or similar layout. These sprites are typically individual frames or components of a larger animated or interactive visual, such as characters, backgrounds, or objects in a game. By loading and displaying portions of the sprite sheet at different times, you can create animations or dynamic visuals efficiently without needing multiple image files. Is there an image bank where I can find free assets to use in my Game? At this time, Flarie Studio does not offer an image bank but we have one in the works, so keep an eye out! What file formats are accepted in Flarie Studio? For any design objects in Flarie Studio, the supported file formats are .png or .jpeg Can I download objects that I have uploaded to Flarie Studio? Yes, just click on the download asset icon in the bottom right corner to download an asset. ---------- Game Settings Can I add sound effects to my Game? The audio that is supported in Flarie Studio can be found in the Audio section under Game Design. At this point, it supports a single audio file to add a background sound that will be played during game play. I want to set up a Challenge in my Game but I don't know what a good score limit it. Where can I find information regarding this? Unfortunately we don't have recommendations on individual Games. We suggest playing the Game a few times to get a sense of a good score limit. If you need help, don't hesitate to contact us at cs@flarie.com What is the purpose of adding a Start and End Date to my Game? Adding a Start and End Date to your Game in Flarie Studio helps you manage its availability for players. Here's why it's useful: Schedule Launches: Set a start date to ensure the Game goes live only when you're ready, like during a campaign or event. Control Expiration: Use the end date to stop players from accessing the Game after a specific period, like when a promotion ends. Player Messaging: If players try to access the Game before the start date or after the end date, Flarie Studio automatically displays messages like "Not yet available" or "Game has expired," keeping your audience informed. These messages can be edited under 'Start Game Button'. How do I add multiple Time Periods in my Game? Navigate to the 'Time Period' section of your game. If you have added a Start Date and an End Date to your game - you will be able to activate "Split Game" which allows you to add multiple time periods to your Game. Can I import settings from a different Game into the one I am working on? In the "More Options" dropdown - you can either import settings from a different Game or import settings from a Template in order to import settings to your existing Game. How do I copy a Game, including all the settings? In the "More Options" dropdown, you can select "Duplicate this version" which creates an exact copy of your Game and adds it to your dashboard. ---------- Prizes If I create a lottery game, can I add multiple prizes to the same game? The short answer is: Yes and no. Currently, the each competition feature supports only one "winner scenario" per game. That means all winners from each competition feature will receive the same communication and prize experience. Here’s a quick breakdown of how it each competition feature works today: Challenge games Allows you to set up specific messaging before and after a goal is reached. This includes popup communications and/or an email, if you choose to use those. Luck-Based WinsGames such as spin-the-wheel, functions similarly: you can set up a win message and a design, but all winners see the same content. So at the moment, you can’t assign different prizes to different segments directly within the system. Winners & Prizes Communication is also currently limited to a single default message that’s sent to all winners. So, can you include multiple prizes? Yes, by combining different competition features you can, but currently, you can not add multiple prizes to each feature. However, there is a workaround that many users have found effective! Here’s what you can do: When setting up your competition feature, you can include unique links as prizes. For example, if you want to offer three different prizes, you could: Upload three types of prize URLs (e.g 3 separate landing pages), one for each prize Then, when uploading your prize links into the system, just include the right quantity of each type. In the game You can keep the messaging general, such as: “You’re a winner! Click here to see what you’ve won!” That link would then lead the winner to a specific prize—either a coupon or a landing page—randomly assigned based on the links you uploaded. Good to know:This feature (assigning multiple prizes more directly within the game flow) is already in our product roadmap, and it’s planned for future development. So full support for multiple prizes per game is coming soon! ---------- Account Can I add new users to our Account and if so; how many? Adding uses is limited to Admin and Manager user roles only. Make sure you are on the correct Brand and navigate to 'Manage Users' in the mega menu. By clicking on the 'Add New User'-button, you will be able to invite new users to your account. Each license type has a set amount of users allowed. If the button is greyed out it means that you have reach the maximum number of users for your account. Is there a limit to how many Games I can have Active at the same time? If you are on a paid license, Flarie Studio supports an unlimited numbers of Games Active at the same time. If you have signed up for a Demo license though our website or through a link from someone in the sales team, you can not have any 'Active' Games. I forgot my password. How can I recover it? On the Flarie Studio login page, you can select "I forgot my password" to retrieve your login details. If you still are unable to access your account - reach out to your Customer Success representative at cs@flarie.com I can't set my games to 'Active', the system says that there is Company Information and Brand Information missing? In order for all Games and Accounts to be entirely GDPR compliant, Flarie Studio requires users to add a certain amount of information to their account. Using the navigation menu in the top bar, head in to the "Account" section and fill in all the empty fields in the "Organization details" section. Once this action is complete, head over to Brands --> and click the Edit-icon and click "Fetch details from Organization". You may also need to approve some documents under 'Documents & Agreements' in order for Games to be 'Active'. ---------- GDPR and Personal Data Here are relevant links to the Flarie terms and policies: FLARIE GENERAL TERMS OF SERVICE FOR BUSINESSES FLARIE PRIVACY POLICY FLARIE GENERAL TERMS OF SERVICE FOR USERS FLARIE COOKIE POLICY FLARIE DPA At Flarie we invest in making sure our products and services comply with laws and regulations and to make sure we have high security standards. We are constantly striving to optimize and improve our system and have gone through and been approved in security and compliance processes with multinational companies such as Unilever, Circle K, Klarna, Cloetta, GroupM and many more. What relationship does Flarie have to Flarie Studio customers (companies) in terms of GDPR? For all data submitted in Flarie Games or Flarie Content, Flarie and the Flarie Studio Customer are to be seen as separate controllers. In connection to playing a Flarie game, the person always approves Flarie's terms and policies (e.g. Privacy policy) and therefore approves Flarie's handling and collection of their personal data in relation to Flarie’s purposes and reasons (which is normally different from the purposes and reasons of the Flarie Studio customer). Flarie’s purposes and reasons consist mainly about providing the service and creating the best possible user experience. At the same time, the person playing also accepts any terms and conditions (e.g. competition terms) and policies (e.g. Privacy policy) added to the game by the Customer, and when applicable also any mandatory or optional consents (checkboxes) that the customer has added to the game. This means that the person is also approving the Flarie Studio Customer’s handling and collection of their personal data based on the reasons and purposes that the partner is stipulating. As a result of this, Flarie and the Flarie Studio Customers are to be seen as separate controllers for the personal data submitted in the Game/content in relation to GDPR, with separate relationships and responsibilities to the person/player. As a standard solution Flarie can’t handle or process this personal data on behalf of the Flarie Studio customer (except for below examples) for the Flarie Studio Customers purposes. This means that the Flarie Studio Customer needs to select and manage the winners' data and export or manage player data themselves. The Flarie Studio customer can do this via the Flarie Studio platform where they can log in to view, manage and export the data collected. Does Flarie process any personal data on behalf of Flarie Studio customers (companies)? For all personal data submitted by people in Flarie games/content Flarie and its partners is to be seen as separate controllers. With this said there are some occasions where Flarie does process personal data on behalf of Flarie Studio customers. There are two standardized features in Flarie Studio where this applies (These two are included in the Flarie DPA which is part of Flarie’s General Terms of Service for Business): If the Flarie Studio Customer chooses to use any of the email features in Flarie Studio where the customer can send tailored emails to their Flarie Studio User base. When using these features Flarie is processing personal data on behalf of the customer to perform the sending of emails. If the Flarie Studio Customer chooses to use the URL Parameter functionality, where a unique identifier is passed in to Flarie Studio through the Flarie URL to uniquely identify people who are playing, Flarie will process personal data on behalf of the customer to be able to provide the correct gaming experience to these players. Sometimes, Flarie and its partners have collaborations that require other data sharings than mentioned above, where Flarie then could process other types of personal data on behalf of the customer. However, as long as the customer is using the Flarie Studio platform in its current form without any technical customization this will not be the case. How is data collected from people when using the Flarie Studio service? In games or content created with Flarie Studio, people can be asked to submit personal data in different types of form fills. Before doing so the person will always consent to Flarie’s processing of this personal data by accepting the Flarie Users Terms and the Flarie Privacy Policy. The Flarie Studio customer (the company) can also add their custom terms and Privacy Policy to the game so that the person playing the game also accepts the customer's processing of their personal data. Flarie and the Customer are to be seen as separate controllers for such data in relation to GDPR to each separate Privacy Policies. Regarding exporting and downloading Data from Flarie Studio How do I export/download data from the Flarie Studio platform? Follow this GUIDE for how to export/download your data from the Flarie Studio platform. How do I generate randomized winners and export/download data of those from the Flarie Studio platform? Follow this GUIDE for how to generate randomized winners and export/download data of those from the Flarie Studio platform. Regarding competitions and marketing lotteries in Sweden In Sweden, it is okay for brands to do marketing lotteries without a license as long as it is free for the consumer to participate in the lottery. Is it okay for the brand to connect the lottery to making a purchase from the brand as a requirement to have the chance of winning? Normally “Spelinspektionen” considers a marketing lottery to be free of charge if the connected purchase has the same cost as if the marketing lottery was not connected. ---------- Distribution Can I distribute the Games anywhere? Yes, you can distribute your Flarie Studio Games across various platforms! Here’s how it works: 1. Web Embeds Host it on your website or app: Use the embed code provided by Flarie to seamlessly integrate your Game into your website or application. 2. Social Media Sharing Share your Game link directly on platforms like Facebook, Instagram, LinkedIn, or Twitter. This is great for driving engagement and traffic. 3. Standalone Pages Flarie games can exist as standalone URLs, meaning you can simply share a link with your audience via email, SMS, or even QR codes. 4. Third-Party Integrations You can integrate Flarie Games into third-party services or promotions using API keys for advanced use cases. Which link should I use when pushing the game on Social Media? Go to your Game and use the "Share Link" which will automatically copy the link to your clipboard. The link copied is the one you should use as your destination URL. Is there a way for me to track where all my players are coming from? Yes, you can add SRC (Source Tracking Codes) to your Games in Flarie Studio to track where players are coming from. This is a great way to monitor traffic sources when distributing your Games on different platforms. How to Add SRC for Tracking Generate SRC Parameters: SRC is usually a query string parameter appended to the Game URL. Example: https://yourgameurl.com?src=facebook Customize for Platforms: Create different SRC values for each platform or campaign: Facebook: ?src=facebook Instagram: ?src=instagram Email Campaign: ?src=email Distribute Unique Links: Use the customized URLs when sharing your game on social media, websites, or email.

Game Userbase The Game Userbase page displays all data collected from players in your game. It allows you to review, search, edit, and export user data gathered during the campaign. This page helps you analyze player activity and manage the data collected through your game. View user data The table shows all users who have interacted with the game and submitted data through forms or other features. Each row represents a player and includes the data fields collected during gameplay. Search for users Use the search bar to quickly find specific players in the user list. This is useful when reviewing individual player data or verifying entries. Export user data You can download the collected data by clicking Export. The export button also displays the number of users included in the export file. Time Period data If Time Period is enabled, a time-period dropdown will appear above the user table. By default, the table shows data from the first time period. To view data from another period, select it from the dropdown. The table will update automatically. Edit user data You can edit user details directly in the table if updates are needed. This allows you to correct or update player information without exporting the data first.

Time Period and Split Game The Time Period setting allows you to control when a game is available to players. By defining a start and end date, you can schedule when the game becomes accessible and when it should no longer be playable. You can also use the Split Game feature to divide the game into multiple time periods. This allows you to run several competitions within the same game link. For example, you can run weekly competitions within a single month using the same game URL. Set a time period for your game To define when a game should be available: Open the selected game. Go to the Time Period section. Set the Start Date and End Date for the game. Once these dates are set, the game will automatically become unavailable after the end date. Enable split game The Split Game feature allows you to divide the main time period into several smaller periods. This is useful when running multiple competitions during a longer campaign. For example, you could run four weekly competitions within a single month. Set up split game To enable and configure Split Game: Open the selected game. Go to the Time Period section. Set the main Start Date and End Date. Enable Split Game by turning the toggle on. In the popup, configure the first game period. Click Add time period to add additional periods. Each time period will appear in a table where you can review and manage the schedule. Add a single time period To add one additional time period: Click Add time period. Set the desired End Date for the period. Click Update. The new time period will appear in the time period table. Add multiple time periods You can also create several time periods at once. Click Add time periods. In the popup, select Multiple time periods. Select the start date for the second period. Enter the number of periods you want to create. Define how many days each period should include. Make sure the start date of the new periods does not overlap with the first game period you created.

Data Collection The Data Collection feature allows you to collect first-party data from players. This includes information such as email addresses, names, or other custom form fields. The most important setting in this section is the Player Identifier, which determines how the game identifies individual players. A unique identifier is required for features such as Winners & Prizes, leaderboards, and email prize distribution. Add data collection to a game Open your game. Click + Add Settings in the left panel. Select Data Collection. Choose the Player Identifier. Add the data fields you want to collect. You can also customize the form design, including the form title, terms text, and button labels. Pre-game vs post-game data collection You can collect player data either before the game starts or after a game round. Pre-game data collectionPlayers must submit their information before they can start playing. This is the most reliable way to collect first-party data and is required for features that send emails. Post-game data collectionPlayers can start playing immediately and are asked to submit their information after completing a game round. This approach lowers the barrier to entry and can increase participation. Post-game forms can be triggered using the Challenge or Luck Based Wins features. Learn more:https://flarie.com/help-station/challengehttps://flarie.com/help-station/luck-based-wins Player identifier types Browser Identifies the player using a token stored in their browser. If the player changes browser or clears their cache, a new identifier will be created. Email Identifies the player by the email address they submit before playing. If the player enters a different email address, a new identifier will be created. Mobile Identifies the player by the mobile number they submit before playing. If the mobile number changes, a new identifier will be created. URL parameter (UUID) Identifies the player using a value passed through the game URL. Example:https://your-game-url.com?uuid={player-identifier} This method is recommended for integrations. For additional security, you can use Authenticated UUID, which requires a signed JWT (JSON Web Token) to verify the player. Available form parameters You can add several default parameters to your data collection form.Available fields include: Email Username First Name Last Name Full Name Age Gender Phone number Birthday Address Country Zip code City Company Business Region Marketing Consent Default Consent Default Mandatory Consent Custom parameters You can create your own parameters in Assets & Settings.Supported input types include: Text fields Radio buttons Dropdowns Checkboxes Once created, custom parameters can be added to the form from the dropdown list when configuring Data Collection.

Spritesheets A spritesheet is a single image that contains multiple images arranged together. In supported games, spritesheets can be used to alternate objects during gameplay or create animations. Using spritesheets can add movement and visual variety to your game, helping create a more dynamic player experience. How spritesheets work Spritesheets combine several frames or objects into one image file. During gameplay, the game displays each frame in sequence to create the appearance of movement or animation. Some games also use spritesheets to randomly alternate between different objects, adding variation to gameplay elements. If the game you selected supports spritesheets, this will be indicated in the description under the asset title. How to create a spritesheet To create a spritesheet, place multiple images in a single row within one image file. Each frame should be positioned directly next to the previous one without any spacing between them. This ensures the game can correctly read and display each frame. Tips When creating animated spritesheets, make sure that each frame transitions smoothly to the next. Consistent alignment between frames helps create a seamless animation during gameplay. Testing the animation in the game preview can help ensure the movement appears smooth and natural.

Invite & Manage Users Who can use this feature: Admin, Manager The Manage Users section allows you to add new users and manage access for existing users within your organization. Invite a new user When you add a new user: An invitation email is sent to the user The user registers on Flarie Studio They are automatically added to your organization with the assigned role You can define the user’s role and permissions during the invitation process. Manage existing users You can update user roles and permissions at any time in the Manage Users section. This allows you to adjust access as your team changes. User roles AdminFull access to all brands and settings. Can approve documents and invite users to any role. ManagerFull access within assigned brands. Can invite users with Manager, Designer, or Analyst roles. DesignerCan create and edit Games and Game Centers. Has access to brand assets. Cannot access analytics, user data, or user management. AnalystCan access User Base, Manage Winners, and Analytics. Can set up data integrations. Cannot create or edit games or manage users. Important notes Managers cannot assign themselves the Admin role Managers cannot grant access to other brands This structure helps keep user management secure while allowing teams to collaborate efficiently.

Design Assets Design assets allow you to customize the visual elements of your game so it reflects your brand and campaign design. Each game includes a set of brandable assets such as backgrounds, players, obstacles, enemies, and pickups. Depending on the game, there can be between 5 and 20 customizable assets. To update a design asset, create your visual in your preferred design tool and upload it to Studio. Once the asset is added, the game preview updates automatically. Upload design assets Open your game in Studio. Go to the Design section. Create the asset in your design tool using the required size and format. Drag and drop the file into the asset upload area. The game preview will update instantly. Image requirements Each asset includes its required image size and supported file format. These requirements are displayed under the asset description. Different games may require different image sizes to ensure the game functions correctly. Always follow the listed specifications when creating your assets. Supported formats typically include PNG and JPG files. Additional branding You can also customize the screens and buttons shown before and after the game. These elements help create a more consistent branded experience throughout the campaign. Adding branding to these screens is a good opportunity to include messaging, calls to action, or visual elements from your campaign. Design tips When creating assets, make sure important objects and pickups stand out clearly from the background. Good contrast helps players quickly identify interactive elements and keeps the gameplay experience smooth. Tip If you need a template for a specific asset, download the existing asset from the game and use it as a reference. Click the download icon in the bottom-right corner of the asset to save it. You can then open the file in your design tool and use it as a guide when creating your own design.

Web Page Background Image The Web Page Background Image appears behind your game when it is played in a web browser. This background gives you additional space to extend your branding beyond the game area. Some brands use this area to place a logo next to the game or to extend the visual theme across the entire screen. This can help create a more immersive and consistent brand experience. When to use a web page background If your game is likely to be played in a web browser, adding a background image is recommended. It allows you to make better use of the available screen space and strengthen your campaign branding. Preview the background You can preview how the background appears with your game by using the Full Preview option. Click Full Preview in the top panel. A new browser window will open. Review how the Web Page Background Image appears around the game. Use this preview to make sure the background design fits well with the game layout and looks correct across the page. Tip When designing the background, leave enough empty space around the center area where the game appears. This helps ensure that important visual elements are not hidden behind the game.

Create a game Create a game by selecting a template from the Game Library. You can browse available games and use filters to find one that fits your campaign goals. About the Game Library When you click Create Game, the Game Wizard opens. Here you can explore the full Game Library and select a game template to use for your campaign. Each template includes built-in gameplay mechanics that you can customize with your own branding, visuals, and messaging. Hover over any game to view a short tutorial that explains how the game works. How to select a game Click Create Game. Browse the Game Library. Use the filters on the left to narrow down the available games. Hover over a game to preview how it works. Click the game you want to use. You will then continue to the next step of the Game Wizard, Where you can start customizing the game. Filter options Time spent Shows the average time players typically spend playing each game. Use this filter to choose games with shorter or longer play sessions depending on your engagement goals. Easy to design Indicates how much customization the game requires. This is based on the number of assets and elements that can be customized. Games with fewer elements are faster to design, while games with more elements allow greater branding flexibility. Branding purpose Helps you find games suited for different marketing objectives. Some games make it easier to showcase multiple products, while others focus on messaging or brand awareness. Platform All games are mobile-friendly. This filter helps identify games that also adapt well to desktop devices. Demographic age Highlights games that perform well with different age groups. Demographic gender Highlights games that perform well with different gender groups. Game categories Browse games grouped by gameplay style to quickly find the type of experience that fits your campaign. Tags Use tags to refine your search using additional characteristics. Tip Combine multiple filters to narrow down the Game Library and quickly find games that match both your branding needs and engagement goals.

Parallax Effects Parallax effects allow you to create layered backgrounds where images move at different speeds during gameplay. This technique adds depth and makes the game environment feel more dynamic and immersive. By using multiple layers that move independently, you can create a stronger sense of motion and visual interest within the game. How parallax effects work Parallax effects use multiple background layers that move at different speeds as the game progresses. Layers placed further in the background typically move more slowly, while layers in the foreground move faster. This creates the illusion of depth within the game environment. When designing images for parallax effects, keep in mind that the background will loop continuously during gameplay. Image design considerations When creating parallax images, make sure the image can loop smoothly. The left and right edges of the image should align so the transition is seamless when the background repeats. Also consider how the different layers interact with each other. Elements placed on front layers may cover elements on layers behind them. If you want a specific element, such as a logo or product, to remain visible at all times, place it on a layer that will not be covered by other layers. Tip Test your design several times after uploading your images. Play through the game to confirm that the images loop smoothly and that the parallax effect looks the way you intended.

Game Status The Game Status determines whether a game is active and available to players. You can control the status manually, or it can change automatically based on the game’s configured start and end dates. The game status also affects how the game behaves in integrations and gamification features. Available statuses Active When a game is set to Active, it is considered an active game link. This is particularly important for licenses with game limitations. Games must also be active to work with gamification features or to send data through webhooks. Draft The Draft status indicates that the game is still being prepared. While a game is in Draft mode, it will display banners informing you that the game is not yet live. Draft games are not counted as active game links. Expired The Expired status appears automatically when a game has start and end dates configured. Once the end date has passed, the system automatically changes the game status to Expired. The game will no longer be considered active.

Start Game Button The Start Game Button is the main button players use to begin the game. You can customize its appearance and behavior to match your game design and campaign needs. The button includes two main sections: the start button itself and a section that can display the player’s score information. Button layout The Start Game Button contains: The Start Game button text and design A section showing the player's high score The player’s latest score Optional ranking information These elements help give players feedback about their previous performance before they start a new round. High score and ranking The high score section displays the player's best score and their score from the most recent play session. You can also choose to display the player’s ranking. Ranking shows the player's current position compared to other players in the game. Ranking works best when combined with a leaderboard and a player identifier. Customize the button You can customize several aspects of the Start Game Button to match your campaign design. Available customization options include: Button color Font style Corner radius For more advanced customization, you can upload a custom button image. Supported file formats include PNG and JPEG. The image will automatically scale to fit the button size. You can also define different button styles depending on the game status. For example, the button can appear in a different color when the game status is Expired. Game not available popup You can enable a Game Not Available popup using the popup toggle. This popup appears when a player clicks the Start Game Button but the game cannot be started. This can happen if the game is inactive or if a required UUID is missing. When the popup is enabled, you can: Add custom popup text Customize the popup layout and text styling Add a Destination Button with a custom label and link This can be used to redirect players to another page or provide additional information. Attempts Attempts allow you to limit how many times a player can play the game. You can configure attempts in two ways: A fixed total number of attempts A set number of attempts that reset daily Players must have available attempts to start the game. Game attempts take priority over Gamification attempts. If both are configured, game attempts will be used first. Gamification attempts are connected to the Gamification API. This allows players to receive additional attempts based on external triggers such as purchases or QR code scans. The Gamification API requires a Space license. Display attempts in the button The number of attempts can be displayed directly in the Start Game Button text. Use the placeholder tag {attempts} to control where the number appears. Example: START GAME – ATTEMPTS: {attempts} You can move the placeholder anywhere in the button text to control its position. If you do not want the number of attempts to be displayed, add the placeholder tag {noAttempts} anywhere in the text. Example: {noAttempts}START GAME No attempts popup You can enable a No Attempts popup using the popup toggle. This popup appears when a player clicks the Start Game Button but has no attempts remaining. When enabled, you can: Add a custom message such as “No more attempts, come back tomorrow” Customize the popup design and layout Add a Destination Button with a custom label and link This can be used to redirect players to a store, landing page, or other campaign content.

Terms The Terms setting allows you to add your own terms and conditions to a game. These terms appear together with the other legal information that applies to the game. Players can access the terms through the legal text shown at the bottom of the game and when starting the game. How additional terms are displayed Any terms added in the Additional Terms field will appear: Below the brand’s privacy policy information Above Flarie’s terms and conditions This allows you to include campaign-specific terms or legal information that applies to your game. Reuse terms across games If you plan to use the same additional terms across multiple games, you can save them in Assets & Settings. Terms added in Assets & Settings for Games and Game Centers will automatically be applied to future games and game centers you create. Edit terms for individual games Even when default terms are set in Assets & Settings, you can still edit the Additional Terms for individual games or game centers. This allows you to adjust the legal text when a specific campaign requires different terms.

Leaderboard The Leaderboard adds a competitive element to your game by showing how players rank compared to others. This feature can help increase engagement and encourage players to replay the game to improve their position. You can customize how the leaderboard appears and when players see it during the game experience. What you can configure The Leaderboard settings allow you to control several aspects of how the leaderboard is displayed. You can configure: How many players are shown on the leaderboard The visual style of the leaderboard When the leaderboard appears in the game The leaderboard can be displayed before the game, after the game, or in both places. Increase engagement with ranking For a stronger competitive experience, you can enable ranking on the Start Game button. This allows players to see their current position before starting a new round. Showing the player's rank early can increase motivation and encourage players to try again to improve their score. Add avatars to leaderboard rows You can display avatars next to player names on the leaderboard to create a more personalized and branded experience. This feature is controlled by the Display Avatar toogle. When enabled, you can upload an image that will appear next to each player's name on the leaderboard. Image requirements: Size: 64 × 64 pixels Format: PNG or JPG Avatars can be used to reinforce campaign branding by using icons related to your brand, team, or products. Customize leaderboard appearance You can adjust the visual style of the leaderboard to match your campaign design. Available customization options include: Background styling Text styling Number of leaderboard rows displayed Optional leaderboard description Learn more If you want to explore how leaderboards and other gamification features can be used effectively, see the onboarding guide below. Tailor your game settingshttps://flarie.com/help-station/tailor-settings

Custom Button Custom Buttons allow you to add interactive or visual elements to your game. A button can be text-based or image-based and can be used to link to external pages, trigger image overlays, or serve as a visual element in the game interface. Custom Buttons can help guide players, promote offers, or add additional design elements to your campaign. You can enable Custom Buttons in the game settings and then customize their appearance, placement, and behavior. Where buttons can appear Custom Buttons can appear at different moments in the game experience depending on how they are configured. A button can be shown: Before gameplay starts After a player finishes a round Throughout the entire game session This flexibility allows you to use buttons for different purposes such as navigation, promotions, or campaign messaging. Add a custom button To add a Custom Button to your game: Open the selected game. Go to + Add Settings. Select Custom Button. Add text or upload an image for the button. Style the button to match your design. Choose when the button should appear in the game. You can choose to display the button throughout the session or only after the player has completed a round. Add multiple custom buttons You can add more than one Custom Button to a game. Click + Add Custom Button. Configure the new button as needed. There is no limit to how many buttons you can add. If you add multiple buttons, adjust the Y value in the shape styling settings to ensure the buttons do not overlap. Use reusable buttons from Assets & Settings If you have created Custom Buttons in Assets & Settings, you can load them directly into your game. A dropdown menu will appear at the top of the settings panel, allowing you to select a pre-configured button. When selected, the button’s saved settings will automatically be applied. This makes it easier to reuse consistent button designs across multiple games. Default buttons for new games If a Custom Button has been set as a default in Assets & Settings it will automatically appear in the settings when you create a new game. You can still edit or remove default buttons in the game settings if needed.

Challenge The Challenge feature lets you reward players for reaching a target score. A challenge can contain one or multiple rewards, allowing you to distribute different prizes within the same challenge. When you add Challenge to your game, a default reward is automatically created. Every challenge must contain at least one reward. Configure the challenge Start by configuring the challenge itself. Set the following: Target Score – The score players must reach to complete the challenge. Challenge Text – The message shown to players when the challenge is active. The text can be fully customised and styled. No Reward Available Text – The message shown if a player completes the challenge but no rewards are available to distribute. Configure a reward Each reward is managed as a child setting under the Challenge. When a challenge is created, Reward 1 is added automatically. This is the default reward and cannot be removed while it is the only reward in the challenge. For each reward, configure: Reward Type – Select the reward players can receive. Reward Limit – Optionally limit how many times the reward can be distributed. Reward Distribution – Choose whether the reward is presented immediately after the game or delivered by email. Reward Popup – Customize the popup shown when the reward is awarded. The default reward does not support a win probability since it acts as the fallback reward. Reward Types Coupon code – same for everyoneAll players who complete the challenge receive the same coupon code. Coupon code – unique for everyoneEach player receives a unique code. Upload enough codes for the number of players who may complete the challenge. URL – same for everyonePlayers receive a button linking to a specific website. URL – unique for everyoneEach player receives a unique URL. Upload enough URLs for the expected number of players. Form – ask users for dataInstead of a reward popup, players are shown a form after completing the challenge. The submitted data is stored in the User Base. This is commonly used to collect information such as name or email. You can create additional form parameters in Assets & Settings - Form Parameters URL in buttonTurns the reward text into a clickable link instead of showing a popup. No instant rewardNo reward message is shown after the game. Tip For unique codes and URL's you are able to select batch upload. This will automatically allocate the unique codes or URLs throughout all time periods, meaning that you don't have to upload a certain amount of codes each time period; the game will do that automatically. Reward Popup Types You can choose how the reward popup appears after a player completes the challenge. Show rewardDisplays a styled popup with optional image, title, and reward content. Hide rewardDisplays a minimal popup with customizable text. NoneNo popup is shown. The reward is still processed and recorded. Add multiple rewards To distribute multiple rewards from the same challenge, select Add Reward to Challenge. Each additional reward is added as its own child setting beneath the challenge. Unlike the default reward, additional rewards allow you to configure a Chance to Win (%), letting you control the probability of players receiving each reward. This makes it possible to offer multiple prizes within a single challenge while controlling how often each reward is awarded. Luck Based Wins vs. Challenge Although both features can distribute rewards, they work differently. Challenge rewards players for reaching a target score. Completing the challenge always triggers a reward, provided one is available. Luck Based Wins uses probability. Even if a player meets the score requirement (or if no score requirement is set), they are only awarded a reward if one of the configured win chances is triggered. Otherwise, the player sees the No Win popup. Example A challenge requires players to reach 1,000 points. Reward 1 (default): 10% Discount Code Reward 2: Free Shipping Coupon – 30% chance to win Reward 3: Gift Card – 5% chance to win When a player completes the challenge, Studio determines which reward to distribute based on the configured reward chances. If none of the additional rewards are awarded, the player receives the default reward. And if all rewards have been distributed, the "No Reward Available Fallback" will trigger to tell the player that all rewards have been distributed. Manage challenge winners The Manage Winners section shows all players who completed the challenge and their scores. You can use this data to review performance and track participants. Learn more about using challenge and other gamification settings: https://flarie.com/help-station/tailor-settings

Luck Based Wins The Luck Based Wins feature gives players a chance to win one of several rewards when they complete a game. Unlike Challenge, rewards are not guaranteed—each reward has its own win probability, making every game round an opportunity to win. When you add Luck Based Wins to your game, a default reward is automatically created. You can then add additional rewards with different winning probabilities. Learn more about when to use Luck Based Wins and other gamification features: https://flarie.com/help-station/tailor-settings Configure Luck Based Wins Start by configuring the Luck Based Wins settings. Set the following: Score Condition – Choose whether players must reach a target score to be eligible for rewards. If enabled, only players who meet or exceed the target score can win. Pre-Played Text – Customize the message shown to players before they start the game. IP Block (optional) – By default, multiple wins from the same IP address are prevented. If you're testing your game, you may want to temporarily disable this restriction. No Win Popup – Customize the popup shown to players who do not win a reward. Configure a reward When Luck Based Wins is added, Reward 1 is created automatically. This reward can be edited but cannot be removed while it is the only reward in the feature. For each reward, configure: Reward Type – Select the reward players can win. Chance to Win (%) – Set the probability of the reward being awarded. Reward Limit – Limit how many times the reward can be distributed. Limit Type – Choose whether the reward limit applies in total or resets daily. Reward Distribution – Choose whether the reward is presented immediately after the game though a popup or delivered by email. Reward Types Coupon code – same for everyoneAll players who complete the challenge receive the same coupon code. Coupon code – unique for everyoneEach player receives a unique code. Upload enough codes for the number of players who may complete the challenge. URL – same for everyonePlayers receive a button linking to a specific website. URL – unique for everyoneEach player receives a unique URL. Upload enough URLs for the expected number of players. Form – ask users for dataInstead of a reward popup, players are shown a form after completing the challenge. The submitted data is stored in the User Base. This is commonly used to collect information such as name or email. You can create additional form parameters in Assets & Settings - Form Parameters URL in buttonTurns the reward text into a clickable link instead of showing a popup. No instant rewardNo reward message is shown after the game. Tip For unique codes and URL's you are able to select batch upload. This will automatically allocate the unique codes or URLs throughout all time periods, meaning that you don't have to upload a certain amount of codes each time period; the game will do that automatically. Reward Popup Types You can choose how the reward popup appears after a player completes the challenge. Show rewardDisplays a styled popup with optional image, title, and reward content. Hide rewardDisplays a minimal popup with customizable text. NoneNo popup is shown. The reward is still processed and recorded. Add multiple rewards To offer multiple prizes, select Add Reward to Luck Based Wins. Each additional reward is added as a child setting beneath Luck Based Wins and can be configured independently with its own reward type, win probability, limits, distribution method, and popup. This makes it possible to offer several different prizes with varying chances of being won. Luck Based Wins vs. Challenge Although both features can distribute rewards, they work differently. Challenge rewards players for reaching a target score. Completing the challenge always triggers a reward, provided one is available. Luck Based Wins uses probability. Even if a player meets the score requirement (or if no score requirement is set), they are only awarded a reward if one of the configured win chances is triggered. Otherwise, the player sees the No Win popup. Example A game includes three rewards: Reward 1: 10% Discount Code – 20% chance to win Reward 2: Free Product – 5% chance to win Reward 3: Gift Card – 1% chance to win When a player finishes the game, Studio evaluates each reward according to its configured probability. If none of the reward conditions are met, the player does not receive a prize and the No Win popup is displayed. Manage Winners The Manage Winners section shows all players who have won rewards through Luck Based Wins.

Winners & Prizes The Winners and Prizes feature automatically selects winners and distributes rewards when a game period ends. This allows you to run competitions or promotional campaigns without manually selecting winners. You can define how winners are selected, how many winners there should be, and how prizes are delivered. Add winners and prizes Open your game. Click + Add Settings in the left panel. Select Winners & Prizes. Accept Data Collection to be added to the game. Finish the Winners & Prizes configurations. Choose how winners are selected You can choose how the system selects winners. Randomized by high scorePlayers must reach a qualifying score to be eligible. The winner is randomly selected from players who meet the requirement. High scoreThe system selects winners based on the highest scores in the game. Randomized by probability (multi-entry)Players can receive multiple entries, which increases their chance of winning. This option requires the Multi-entry feature in Challenges. Set the number of winners Define how many winners the game should have. If you use Unique URLs or Unique Coupon Codes, make sure you upload enough codes or URLs for the number of winners you selected. Send prizes by email You can automatically send prizes to winners by email when the game period ends. To enable this: Turn on Send Prize Through Email. Select the reward type. Set the email sender. Customize the email text and styling. You can use Send Test Email to preview the email before it is sent to players. Tip You can preconfigure email styling and sender details in Assets & Settings → Email to save time when creating future prize emails. Reward types Coupon code – same for everyone All winners receive the same coupon code. Coupon code – unique for everyone Each winner receives a unique coupon code. URL – same for everyone All winners receive a button linking to the same destination. URL – unique for everyone Each winner receives a unique destination URL. Manage winners The Manage Winners section shows a list of players who have won prizes. Disable or remove the feature To disable the feature, turn off the toggle in the Winners and Prizes settings.To remove the feature completely: Click the trash icon next to the setting. Click Publish to apply the change.

Popup Messages The Popup Messages section controls the design and text used in popups throughout your Game Center. These popups are used to show confirmations, notifications, and error messages when players interact with features such as rewards or purchases. Customize popup styling In this section you can adjust the general styling used for all popups.You can configure: Popup appearance and layout Text styling Button styling You can also customize the labels for common buttons such as: Confirm Close Next Edit popup messages You can edit the text shown in different popup messages.This includes confirmation messages and error messages that appear during gameplay. Examples include: Confirmation when a player receives a prize Error messages when a player tries to redeem a reward without enough coins Notifications when a reward is out of stock All popup texts are pre-filled by default, but you can edit them to better match your Game Center, your campaign messaging, or to translate them into another language.

Modules The main content of a Game Center is built using modules. Modules allow you to organize games, rewards, promotions, and information within the Game Center. You can combine and arrange modules to create the layout that fits your campaign. Available module types Five types of modules are available: Game module Ad module Text module Store module Competition module Competition modules are only available if you are using the Advanced Game Center. You can mix different module types, place them in any order, or use the same module multiple times. Module status Each module has a Module Status setting that controls whether it is visible in the Game Center. Available options: VisibleThe module appears in the Game Center. HiddenThe module is not visible to players.Module status overrides the visibility settings on individual games or rewards inside the module. Start and end dates You can set a Start Date and End Date for a module to control when it appears in the Game Center. If a module has its own start or end date, it will override any dates set on the game or reward inside that module. Reorder modules You can change the order of modules in the Game Center. Click and hold the drag icon next to the module. Drag the module up or down in the list. The order in the list determines how modules appear in the Game Center layout.

Text Module The Text Module allows you to add text content to your Game Center. This can be used to explain a campaign, provide instructions, or add context between other modules. Add a text module Click Add Module. Select Text Module. Set the module status to Visible or Hidden. (Optional) Set a Start Date and End Date. Add a header and description text. Style the text to match your Game Center. You can use the Text Module to guide players, highlight promotions, or explain how your campaign works.

Ad Module The Ad Module allows you to display an image in your Game Center. It can be used to highlight a campaign, promote an offer, or improve the visual layout. You can also make the image clickable and link it to an external URL. Add an ad module Click Add Module. Select Ad Module. Set the module status to Visible or Hidden. (Optional) Set a Start Date and End Date. (Optional) Add a name for the module. Configure the ad Ad size Choose how the ad should be displayed: Full width Half width Upload image Drag and drop the image you want to use.The recommended image size is shown above the upload area. Add link (Optional) Add an external URL to make the image clickable.This allows you to direct players to a website, campaign page, or other destination.

Redirection Links Who can use this feature: Admin, Manager Redirection links let you keep a single link while changing its destination when needed. This is useful for campaigns where the same link or QR code is reused over time. For example, you can print one QR code on packaging and update the destination later without needing to reprint anything. Redirection links can be used for both games and external URLs. Why use redirection links Reuse the same link across campaigns Update destinations without changing the original link Schedule automatic updates based on time Create trackable campaign links with UTM parameters Generate customized QR codes Create a redirection link Go to Redirect Links in the menu. Click Create New Link. Enter a name for your link. Avoid spaces and special characters. Select a game or enter a custom URL as the destination. (Optional) Set a Start Date and End Date to automate changes. Confirm and save. You can then copy and share the redirection link wherever needed. UTM & QR Codes You can create UTM links and QR codes for Redirection Links, Games, Game Centers, and Surveys using the UTM & QR Code Manager. For a Redirection Link, click the "UTM & QR Code" button next to the link. For Games, Game Centers, and Surveys, open the dropdown next to the share publish link and select the UTM & QR Code option. Create a UTM link UTM parameters let you create different versions of the same link for tracking campaigns and traffic sources. In the UTM & QR Code Manager, add a new UTM and configure any of the following parameters: Campaign ID Campaign Name Campaign Source Campaign Medium Campaign Term Campaign Content You can create multiple UTM links for the same Game, Game Center, Survey, or Redirection Link. Create a QR code Each link you create can also be turned into a customizable QR code. You can: Change the QR code color Change the background color Upload a logo to display inside the QR code Download the QR code as PNG or SVG This lets you create separate trackable links and branded QR codes for different channels while keeping them connected to the same experience.

Fonts Who can use this feature: Admin, Manager, Designer The Fonts section allows you to upload custom fonts and use them across your Games and Game Centers. This helps you maintain a consistent brand style in all text elements. Upload a font Go to Assets & Settings → Fonts. Click Add New Font. Enter a font name. This name will appear in font dropdowns across the platform. Upload both a Regular and Bold version of the font. Supported formats: .otf or .ttf (Optional) Set the font as the default for future use. Click Add Font to Assets. Use fonts Once uploaded, your fonts will be available in all font dropdowns in Flarie Studio. You can apply them when styling text in: Games Game Centers Other text-based elements throughout the platform Using custom fonts helps ensure a consistent look and feel across all your campaigns.

Emails Who can use this feature: Admin, Manager, DesignerThe Emails section lets you define default styling for all emails sent from the platform. These settings are automatically applied to future Games, Game Centers, and email communications. This helps ensure a consistent look and feel across all emails. Customize email styling Go to Assets & Settings → Emails. Set the email sender name so recipients know who the email is from. Adjust text and button styles to match your brand. Upload a header and footer image for your emails. How it works Your email settings will be used as the default for: Reward emails Verification emails Other system emails You can still override these settings in individual features if needed.

Form Parameters Who can use this feature: Admin, Manager Form Parameters allow you to create custom data fields that can be used in forms across Games and Game Centers. This makes it easy to collect consistent data from players. Add a form parameter Go to Assets & Settings → Form Parameters. Click Add Form Parameter. Enter an internal name. This will be used in Data Collection settings and analytics. Note: The name cannot be changed after saving. Select a component type: Free text Dropdown Radio buttons Checkbox Add the relevant input or answer options based on the selected type. (Optional) Set the parameter as default to include it in future forms automatically. Click Save. Use form parameters Created parameters will be available when setting up forms in: Games Game Centers They will appear in the list under the internal name you defined. Using form parameters helps standardize data collection and simplifies form setup across multiple campaigns. Custom Regex for Free Text The Free Text component in Form Parameters supports custom regex, giving you more control over what players can enter into the field. When Free Text is selected as the component type, enable Custom Regex to add your own regex pattern. Add a custom regex Select Free Text as the component type. Enable Custom Regex. Enter the regex pattern you want the player's input to follow. Save your changes. The input will only be accepted when it matches the specified pattern. For example, if you want to accept exactly five letters or numbers, you could use: ^[A-Za-z0-9]{5}$ This can be useful for fields that require a specific format, such as membership IDs, reference numbers, or custom codes.

Terms Who can use this feature: Admin, Manager The Terms section allows you to define default terms and conditions for your brand. These terms will be shown when collecting user data in Games and Game Centers. Setting up default terms ensures consistency and helps you meet legal requirements when handling user data. Add brand terms Go to Assets & Settings → Terms. Enter your text in the Additional Terms and Conditions field. Save your changes. How it works The terms you add will automatically be applied to all new Games and Game Centers. You can still edit or override the terms in individual setups if needed.

Time Zone Who can use this feature: Admin, Manager The Time Zone setting defines the default time zone used for all time-based features across the platform. This includes settings such as start and end dates for Games, Game Centers, and other time-sensitive features. Set default time zone Go to Assets & Settings → Time Zone. Select your preferred time zone from the dropdown. How it works The selected time zone will be used as the default across the platform. You can still adjust the time zone in individual settings for Games, Game Centers, or other features if needed.

Userbase Emails The Userbase Emails feature allows you to send emails directly to users collected in your User Base. You can target specific users using filters and schedule emails when needed. Send an email Scroll down to the User Base table. (Optional) Apply filters to target specific users. Click Send Email. Fill in the email details and upload any images or banners. (Optional) Set a date and time to schedule the email. Click Create Email. The email will be sent immediately or scheduled based on your selection. Manage emails In the Email Table, you can: View previously sent emails Duplicate existing emails Edit scheduled emails This makes it easy to reuse content and manage ongoing communication with your users.

Analytics Who can use this feature: Admin, Manager, Analyst The Analytics page gives you an overview of how your Games and Game Centers are performing. You can track player behavior, engagement, and campaign performance over time. Filter and view data You can filter analytics data by: Specific Game or Game Center Date range This allows you to analyze performance for a single campaign or across all your games. Export reports You can download reports directly from the Analytics page. Select the data points you want to include Export the report for further analysis You can also enable weekly email reports in your profile settings. Key metrics The Analytics page includes the following data points: Live PlayersPlayers active within the past hour. PlayersTotal number of unique players. Avg. Time per PlayerAverage time spent per player. Avg. Game Rounds per PlayerAverage number of rounds played per player. Active Days per Player Average number of days each player was active during the selected period. Time in GameTotal time spent by all players, shown in hours. Game LoadsNumber of times games have been loaded. Game RoundsTotal number of rounds played. Challenge CompletedNumber of completed challenges. Graphs Total graphShows cumulative totals of selected metrics over time. Per game graphDisplays each game as a separate line. You can change the metric shown on the Y-axis. Additional insights ClicksNumber of clicks on custom buttons or CTAs. Operating systemDistribution of players by OS. DeviceDistribution by device type. BrowserDistribution by browser. UTM statisticsTrack campaign data such as source, medium, campaign, term, and content. Game-level data Below the graphs, you can view a table with performance data for each individual game. This helps you compare results and identify top-performing games.

Organization Details Who can access this page: Admins The Organization Details page is where you manage key information about your organization. Completing this section is required before you can activate games. Access organization details Go to Account in the menu. Open Organization Details. Here you can view and update your organization information. Required information The following fields must be completed before games can be set to active: Organization name Street address, city, and zip code Country VAT or tax number (if applicable) Invoicing email Game terms contact information These fields are shown to players in your game terms.Privacy policy URLLink to your organization’s privacy policy. Support URLLink where users can get help with games or competitions. Save changes After updating your information: Click Update Organization to save. Keeping this information accurate ensures your games can be activated and helps maintain compliance and transparency for your users.

Manage Brands Who Can use this feature: Admin, Manager The Brands section allows you to manage all brands connected to your organization. Each organization can have multiple brands, each with its own settings and access control. Access brands Go to Accounts in the menu. Open the Brands section. You will see a list of all brands linked to your organization.To edit a brand, click the edit icon on the right side of the table. Edit brand details You can configure the following settings for each brand. Brand information Brand nameUpdate the name used to identify the brand. Address detailsEnter street address, city, country, and zip code. These fields are required for certain features, such as activating games and generating correct game terms. Legal and contact links Privacy policy URLThis link will be shown in game terms. URL for general questionsAdd a link where users can contact your team for support. Brand prefix The brand prefix is used in redirection link URLs.Example:game.flarie.com/rd/yourbrand/your_game_nameRequirements: 1–25 characters No spaces or special characters Manage brand access You can control which users have access to each brand.In the Brand Access section: Select users who should have access Only selected users can manage and work with the brand This helps you control permissions and keep work organized across teams.

License Plan The License Plan section shows your current subscription and its validity.Here you can see: Your active license plan The end date of your license Update your license If you want to renew or upgrade your license: Click Update License. This will notify the Customer Success team, who will contact you to help with renewal or recommend a suitable plan based on your needs.

Documents & Agreements The Documents & Agreements page gives you access to important documents related to your use of Flarie Studio. This includes agreements that may require your approval, as well as key platform policies. View documents This section shows documents that have been shared with you. For each document, you can see: Document title Upload date Approval status and approval date Some documents may require your approval before you can continue using certain features. Access terms and policies At the bottom of the page, you can find links to important policies: Terms of Use Privacy Policy Cookie Policy Click any link to open and review the policy. Keeping up to date with these documents helps ensure compliance and proper use of the platform.

Gamification Scenarios Who can use this feature: Admin, Manager Gamification means using game mechanics in non-game contexts to increase engagement. In Flarie Studio, you can reward users for actions such as playing a game, making a purchase, or completing a task. These scenarios can be used within individual games or across a Game Center. Choose a gamification scenario Flarie Studio offers several gamification scenarios that can be used separately or combined. Attempts and unlock games Reward players with game attempts after completing an action.Examples: Reaching a target score Completing a challenge Performing an external action such as a purchase This helps drive repeat visits and continued engagement. Adventure mode Create a structured journey in the Game Center. Players unlock games and rewards step by step, creating progression and encouraging continued interaction. Coins distribution Reward players with coins based on actions.Examples: Scoring points in a game Completing specific tasks Players can then spend these coins in the Game Center store. Unlock reward Allow players to unlock rewards by completing tasks.Examples: Reaching a target score Purchasing a reward Completing an external action This creates clear goals and incentives for players. How to use gamification You can use these scenarios individually or combine them to create more advanced experiences. This flexibility allows you to design campaigns that match your goals and keep players engaged over time.

Adventure Mode First, make sure you have already prepared an Active Game Center with Games and/or Rewards in it to be used in the gamification scenario. Navigate to Gamification in the menu, and click on Create Gamification. Then pick Adventure mode. Name your Gamification scenario. (Optional) Set your Gamification status to 'Active'. You can change the status at any time but the Gamification needs to be Active in order for it to work. In the Gamification flow, click on 'Add Games' and add the Games that you have prepared to be included in the Gamification scenario. You can also add Rewards by clicking the 'Add Rewards' button. In the Gamification flow table, sort the Games and Rewards in the order you want the player to clear them. You can press the arrows to change the order. Add a target score that the player needs to reach in the Game to unlock the next one. (Optional) Add a custom popup text for if players click on the locked Game. This can be set by ticking the Set Game lock pop-up text in the Gamification flow table on the selected Game. (Optional) Add a custom popup text for if players click on the locked Game. This can be set by ticking the Set Game lock pop-up text in the Gamification flow table on the selected Game. Save your Gamification and try it out in the selected Game Center.

Gamification Analytics The Gamification Analytics page helps you track how users interact with your gamification features. It provides a detailed breakdown of events, making it easier to measure performance and optimize your setup. Access gamification analytics Go to the Gamification section in the menu. Click See Analytics. Set date range By default, the page shows data from the past month.You can adjust the date range at the top of the page to analyze performance over a specific period. Event breakdown Each gamification event is listed with the number of times it has been triggered. This shows how often users interact with different gamification features. View detailed statistics To explore an event in more detail: Click the dropdown arrow next to the event name. This will display a more detailed breakdown of statistics for that specific event. These insights help you understand user behavior and improve engagement across your gamification scenarios.

Game Module The Game Module is used to add games to your Game Center. You can connect one or more games and control how they appear for players. Make sure you have at least one active game available before adding it to a module. Add a game module Click Add Module. Select Game Module. Set the module status to Visible or Hidden. (Optional) Add a name for the module. (Optional) Set a Start Date and End Date. Add a title and description for the module. Style the module to match your Game Center. Note If you set a start or end date on the module, it will override any dates set on individual games. Add games to the module Click Add Games. Select games from your Games Library. Click Select. The selected games will be added to the module. By default, added games are set to Hidden. Configure games in the module Click Edit Settings on a game in the list to configure it. Visibility Set the game to Visible to make it available in the Game Center. Start and end datesYou can set a start and end date for each game. If a module-level date is set, it will override the game-level dates. Game imageSelect the image size: Full size or Half sizeUpload an image to represent the game. Recommended image size is shown in the upload area. Game lock You can lock a game so it becomes available after a set number of days. When enabled: A lock icon and countdown are shown Players cannot access the game until it unlocks A popup appears if a player tries to access it early You can also upload a custom image for the locked state. Reorder games You can change the order of games in the module. Click and hold the drag icon. Drag the game up or down in the list. The order in the list determines how games appear in the Game Center.

Store Module The Store Module allows players to spend in-game currency on rewards within your Game Center. Rewards can include discounts, digital items, or physical products. To use the store, the Wallet feature must be enabled. Add a store module Make sure Wallet is enabled in Game Center settings. Click Add Module. Select Store Module. (Optional) Add a name, header, and description. Set the module status to Visible or Hidden. (Optional) Set a Start Date and End Date. NoteModule-level dates override any dates set on individual store items. Add a store item Click Add Store Item. (Optional) Add a header and description. Set the item status to Visible or Hidden. (Optional) Set a Start Date and End Date. Add an item description. Select image size (full or half) and upload an image. Set the item price. Optional item settings Cooldown Prevents players from purchasing the same item again for a set number of days. Store item lock Locks the item for a set period. A countdown is shown until it becomes available. Limited stock Limit how many times the item can be purchased. Set reward type Select what the player receives after purchase: Coupon code – same for everyoneAll players receive the same code. Coupon code – unique for everyoneEach player receives a unique code. Upload enough codes for expected purchases. URL – same for everyonePlayers receive a link to the same destination. URL – unique for everyoneEach player receives a unique link. Form – ask users for dataTriggers a form after purchase to collect information such as address. All rewards are delivered by email. Customize email Set up the email content and styling for the reward. You can reuse default email settings from Assets & Settings → Email. Manage store items You can: Reorder items by dragging them in the list Edit or delete items using the ... menu View uploaded codes or URLs Store data The Store Data section shows: Number of items distributed Number of unique players who claimed items You can also view which users have claimed each reward.

Wallet The Wallet feature allows players to collect in-game currency while interacting with your Game Center. This currency can later be used to redeem rewards in the reward store. Players typically earn currency by playing games and scoring points. How currency is earned The amount of currency a player receives is usually based on the number of points they score in a game. You can also award currency through other gamification actions, such as: Reaching a specific score Completing challenges Performing external actions connected through integrations This allows you to create different ways for players to earn rewards and stay engaged. Enable the wallet To activate the Wallet in your Game Center: Open your Game Center settings. Turn the Wallet toggle on. Upload an image for your currency. The currency icon will be displayed when players earn or spend currency in the Game Center. Set a daily cooldown You can optionally set a cooldown to limit how much currency a player can earn per day. This helps control reward distribution and encourages players to return regularly instead of earning all currency at once.

Game Center A Game Center is a central hub where you can gather multiple games, rewards, and promotions in one place. It works like a digital arcade where players can explore games and interact with your campaign. Within a Game Center, you can add games, create a reward store, and include promotional modules that link to external URLs. General settings The General Settings section controls the overall setup and design of your Game Center. Here you can configure: Game Center status Start and end dates Background images Colors and styling Text appearance These settings allow you to customize the visual style of the Game Center to match your brand. Game center status Game Center Status determines whether the Game Center is active and accessible to players. Active The Game Center is live and accessible through its link. An active Game Center can also be used in gamification scenarios and integrations such as webhooks. Draft The Game Center is still being prepared and is not visible to players. Draft Game Centers display banners indicating that the experience is still in draft mode. They are not counted as active Game Center links. For licenses that do not include Game Center, the status will remain Draft. Expired The Expired status appears automatically when a Game Center has defined start and end dates and the end date has passed. Once expired, the Game Center is no longer active. Wallet and rewards When the Wallet feature is enabled, players can earn in-game currency by playing games. This currency can then be used to redeem rewards in the reward store. This encourages players to return, continue playing, and interact with your campaign. Share your game center Game Centers can be shared in several ways: Direct link (URL) QR code Embedded inside an app This makes it easy to include the Game Center in marketing campaigns or digital platforms.

Email Design The Email Design section controls the appearance of emails sent by the system.This includes emails such as account verification messages and reward emails. You can customize the layout and styling so the emails match your brand. Customize email layout You can adjust several design elements for system emails. Available options include: Top image Bottom image Text styling Button styling These elements allow you to create a consistent look across all emails sent from the platform. Set the email sender You can define the sender name that appears in outgoing emails. The sender name will default to your brand name, but it can be edited if needed. This helps players recognize who the email is from. Preview emails You can preview your email design before sending it to players. Click Send Test Email. Review the preview in your inbox. This helps ensure that the layout, text, and styling appear correctly. Tip You can configure the email sender and default email styling in Assets & Settings → Email. This allows you to reuse the same setup for future campaigns and saves time when creating new emails.

Data Collection & Login The Data Collection & Login feature adds a login and registration flow to your Game Center. This allows you to identify returning users and collect player data in one place. You can also customize the appearance and text used in the login and registration flow. Choose a player identifier The most important setting in this section is the Player Identifier. This determines how users are identified when they return to the Game Center. Two identifier types are available. User input Players enter their information through a form.You can select which parameters to collect by adding them in the + Add Parameters section. These fields determine what information players need to provide during registration. URL parameter Players are identified through values passed in the Game Center URL.Example:https://your-game-url.com?{parameter}={your_value} This method is commonly used when integrating the Game Center with external systems. For additional security, you can use Authenticated UUID, which requires a signed JWT (JSON Web Token) containing the player’s UUID. Add data collection parameters You can define additional parameters to collect more information from users. Click + Add Parameters. Select whether the parameter should come from User Input or a URL Parameter. Choose the parameter type from the dropdown. If you select User Input, make sure the Input Field Text clearly describes the information the player should provide. If you have created custom parameters in Brand Settings, they will also be available in this list. Recommendation To avoid asking players to fill in multiple forms, it is recommended to collect player data only in the Game Center login flow. If you do this, you do not need to enable Data Collection in individual games. Customize the login flow You can adjust the visual style and text used in the login and registration process. Available options include: Login text and instructions Terms and conditions text Text color Background color Logo All login and registration texts can be edited in the Login Text section. Login emails You can configure the emails sent during the login process, such as verification emails. These emails will use the styling defined in the Email Design section or your Assets & Settings configuration.

User Base Who can use this feature: Admin, Manager The User Base page gives you an overview of all data collected from users across your Games and Game Centers. It allows you to view, filter, and manage user data in one place. View and filter users You can explore your user data using different filters.Available filters include: Date Specific Games or Game Centers Collected parameters (such as email, name, or custom fields) You can also search for specific users directly. Export user data All user data can be exported as a CSV file.This allows you to: Analyze data externally Share data with other tools or teams Send emails to users The User Base includes a Send Email feature for communicating with your audience. You can: Send emails to users who have opted in to marketing Send emails immediately or schedule them for later This makes it easy to follow up with users, promote campaigns, or share updates.

Coins Distribution First, make sure you have already prepared a Game Center and set it to 'Active' Navigate to Gamification in the menu and click on 'Create Gamification'. Then pick 'Coins Distribution' from the scenarios. Name your Gamification scenario. (Optional) Set your gamification status to Active. You can change the status at any time but the Gamification needs to be Active in order for it to work. Select the Game Center you want the players to gain coins in Set an Internal or External Condition. How to set an Internal Condition for Coins Distribution An Internal Condition can be set up with Attempts/Unlock games. Select 'Reach Score in Game' in the Internal Scenario dropdown for the set condition. Select the Game that the user needs to play to gain coins. Only Games in the selected Game Center can be picked. Set a Target Score that the players need to reach Set the amount of coins the user should get for reaching the score. The user is only able to receive the Reward once per game period on the same game. Save the Gamification How to set up an External Condition for Coins Distribution. Select 'External' in the set condition for the Gamification Scenario. Set the amount of coins the user should gain from triggering the external condition. Save the Gamification If this is your first time setting up an external condition make sure to generate an Access Key for your brand: Expand the See External API Guide and navigate to the access key, or navigate to Integration → Access Keys. Generate and copy the key to your API. If an API Access key has already been generated, generating a new one will invalidate the old key.

Attempts/Unlock Games First, make sure you have already prepared at least one Active Game to be used in the gamification scenario. Navigate to Gamification in the Meny. Click on 'Create Gamification' and then pick Attempts/Unlock Games. Name your gamification scenario. (optional) Set your Gamification status to active. You can change the status at any time but the Gamification needs to be Active in order for it to work. Click on 'Add Games' in the Game Table, and add the Game/s that you have prepared to be included in the Gamification scenario. Select 'Internal' or 'External' condition, depending on what the plan for the Gamification is. How to set an internal condition for attempts/unlock games Two different Internal Conditions can be set up with Attempts/Unlock Games. Reach score in game Select 'Reach score in Game' in the internal scenario dropdown for the set condition. Select the Game that the player has to play to gain Attempts Set a score the player has to reach to gain the Attempts Set the amount of Attempts the player will gain when reaching the set score. If you select 'Unlimited', the Game will be unlocked, once the player reaches the score. Save the condition and add more conditions, if needed. Save the Gamification Buy attempts in Game Center First, make sure you have prepare an Active Game Center with a Reward to connect the condition with. Select 'Buy Attempts in Game Center' in the internal scenario dropdown for the set Condition Select the Game Center that the user needs to purchase the Reward in. Select the Reward that needs to be purchased to gain the Attempts. Set the amount of Attempts the user should gain from purchasing the Reward. If you select unlimited, then the Game will be fully unlocked after the player purchases the Reward. Save the Condition and add more Conditions, if needed. Save the Gamification. How to set an external condition for Attempts/Unlock Games Select 'External' in the set condition for the Gamification scenario. Set the amount of Attempts the user should gain from triggering the External Condition. Save the Condition and add more Conditions, if needed. If this is your first time setting up an external condition make sure to generate an Access Key. Expand the See External API Guide and navigate to the access key, or navigate to Integration → Access Keys. Generate and copy the key to your API. If an API Access key has already been generated, generating a new one will invalidate the old key.

Unlock Rewards in Game Center First, make sure you have already prepared an Active Game Center with Rewards in it. Navigate to Gamification in the menu and click on Create Gamification and then pick Unlock Rewards. Name your Gamification scenario. (Optional) Set your Gamification status to 'Active'. You can change the status at any time but the Gamification needs to be Active in order for it to work. Select the Game Center users should unlock Rewards in In the Reward, table click 'Add Rewards' and add the rewards. Only Rewards from the selected Game Center will be available to select (Optional) Write a custom popup text for if players click on the locked Reward. Set an Internal or External condition. How to set an Internal Condition for Unlock Rewards Two different kinds of Internal conditions can be set up with Attempts/Unlock Games. Buy Reward in Game Center Prepare another Reward, excluding the ones in the reward table to connect the condition with. Select 'Buy Reward' in the Game Center in the internal scenario dropdown for the set condition. Select the Reward that needs to be purchased to unlock the Reward in Reward table. Save the Gamification Reach Game Score in Game Prepare a Game in the selected Game Center to connect the scenario with. Select 'Reach Score in Game' in the internal scenario dropdown for the set condition. Select the Game that the player has to play to gain Attempts Only Games from the selected game center are available to select Set a score that the player has to reach to unlock the Reward. Save the Gamification How to set an External Condition for Unlock Rewards Select 'External' in the set condition for the Gamification scenario. Save the Gamification If this is your first time setting up an external condition make sure to generate an Access Key for your brand. How to: Expand the See External API Guide and navigate to the access key, or navigate to Integration → Access Keys. Generate and copy the key to your API. If an API Access key has already been generated, generating a new one will invalidate the old key.

API Access Key Who can use this feature: Admin, Manager Access Keys are used to authenticate requests and secure integrations with Flarie Studio. This includes API access, webhooks, and secure player identification. The API Access Key is used to authenticate requests to the Flarie API. Include it as the accessKey parameter in your API requests It can also be used as a Bearer token in webhook requests Example:Authorization: Bearer Verifying this token on your server helps ensure that requests are coming from Flarie. Generate an API access key Go to Access Keys in the menu. Click Generate Key. NoteGenerating a new key will invalidate any previously generated key. Webhook Secret Key The Webhook Secret Key adds an extra layer of security to webhook requests.It generates a hash using:SHA-256 (payload + secretKey)This hash is sent in the request header as:X-SignatureYou can verify this on your server to ensure the request is authentic and unchanged. Get a webhook secret key Go to Access Keys. Generate and copy the key. The webhook secret key is optional and can be enabled in webhook settings under Custom Headers UUID Secret Key The UUID Secret Key is used to secure player identification when using URL parameters.When enabled with Authenticated UUID: The uuid parameter must be a signed JWT token Only verified users can access the Game or Game Center Get a UUID secret key Go to Access Keys. Generate and copy the key. The UUID secret key is optional. NoteGenerating a new key will invalidate any existing key.

Introduction to Webhooks in Flarie Studio Who can use this feature: Admin, Manager The Webhook feature allows you to send real-time data from Flarie Studio to your own systems. It enables you to respond to in-game events, automate workflows, and integrate with external tools. What you can do with webhooks Webhooks can be used to: Trigger rewards or actions based on player activity Track engagement and user behavior Send player data to external systems such as CRM or analytics tools When a selected event occurs, Flarie automatically sends data to your configured endpoint. How webhooks work You define a webhook and select which events should trigger it. You configure an endpoint (URL) to receive the data. When the event occurs, Flarie sends a payload to your endpoint. You can control both the event triggers and the structure of the data being sent. Next steps To get started, review the following: Authentication and headersLearn how to secure your webhook and configure request headers. Events and payloadExplore available event triggers and payload formats. Create your first webhookFollow a step-by-step guide to set up your first webhook.

Web Integration This guide will walk you through how to integrate a Flarie game into your website or web app. This page covers two main approaches to web integration: Embed Code - a simple script tag you can drop into your site for a responsive game view with optional fullscreen capabilities. Fullscreen iframe - for a more immersive experience, launch your game in a fullscreen iframe using a minimal HTML template. In addition to embedding, we support callbacks and methods for deeper integration. These let you build custom experiences around the game, such as your own loading screens, custom restart views, or popup and events that appears based on gameplay. Let’s dive in. Embed Code Optional attributes Attribute Description top Set an optional marginTop to the gameView.Example: top='50px'. Default is 0px. height Set an optional height to the gameView. Example: height='90vh'. Default is 100%. width Set an optional width to the gameView.Example: width='50vw'. Default is 100%. expander Activate an expander button that will trigger fullscreen mode. Example: expander='true'. Default value is false. expander-img-minimize Override the default expander minimize image. Example: expander-img-minimize='your-image-url.png' expander-img-fullscreen Override the default expander fullscreen image. Example: expander-img-fullscreen='your-image-url.png' Fullscreen iframe Callbacks Flarie games support several callbacks that allow your website or app to listen for specific events during gameplay. These can be used to trigger custom functionality - like creating a custom loading screen, saving game data, or triggering something based on gameplay. All callbacks are delivered via the window.postMessage API from the embedded iframe. You can listen for them using the message event on the window object. Example Listener Callback: Loading Triggered as the game is loading. You can use this to display or update a custom loading screen. When value reaches 100, your game is fully loaded and ready to display. {"loading": {"progress": value}} Parameter Type Description value int Progress of your loading, 0-100. Callback: Game Started Fired when a player begins a game round. Useful for tracking engagement or updating UI elements. {"gameStarted": {"state": true}} Parameter Type Description state Bool State is sent as true Callback: Game Over Triggered when a game round ends. This includes the player's score and time spent, so you can store or display the results. {"game": {"time": time, "score": score}} Parameter Type Description time int Time spent of the game round (seconds) score int Score of the game round Callback: Game Click Fired when a user taps a call-to-action (CTA) inside the game. {"gameClick": {"state": true}} Parameter Type Description state Bool State is sent as true Methods If you're integrating a Flarie game in a web environment (e.g. via iframe), you can trigger certain game actions from your parent page using the postMessage API. These methods allow you to control aspects of the game like starting a round, ending it, toggling sound, or showing the pause menu. Make sure to target the iframe element where your game is loaded using contentWindow.postMessage(). Example Setup Available Methods START_GAMETriggers the game to start. document.getElementById("iframe-id").contentWindow.postMessage({ type: "START_GAME" }, "*"); GAME_OVERManually ends the current game round. You might use this if the player exits or you want to force end the session and retrieve game data. document.getElementById("iframe-id").contentWindow.postMessage({ type: "GAME_OVER"}, "*"); TURN_SOUND_ONEnables in-game sound. Ideal for implementing custom sound toggle controls in your app. document.getElementById("iframe-id").contentWindow.postMessage({ type: "TURN_SOUND_ON" }, "*"); TURN_SOUND_OFFDisables in-game sound. document.getElementById("iframe-id").contentWindow.postMessage({ type: "TURN_SOUND_OFF" }, "*"); SHOW_PAUSE_CONTROLLERDisplays the pause controller UI within the game. This lets users pause, view instructions, and resume or end the game. The pause controller will automatically hide when the game ends. document.getElementById("iframe-id").contentWindow.postMessage({ type: "SHOW_PAUSE_CONTROLLER" }, "*"); UI Examples Game with full width of the container Game placed as part of the container

App Integration App To run Flarie Studio games in your app you need to create a webview that supports custom interfaces and load your game url in the webview. WKWebView would be our recommended option for iOS. [recommendation] - in Flarie Studio you can enable Instruction Views. These Instruction View may include tutorial videos. set allowsInlineMediaPlayback in order to prevent the video going into full screen mode. [App] iOS - Swift import WebKit class webGames: UIViewController, WKScriptMessageHandler, WKUIDelegate { var webView: WKWebView! var contentController = WKUserContentController() override func viewDidLoad() { // this will add support for the callbacks, meaning you will receive a notification with json data for all callbacks contentController.add(self, name: "callback") let config = WKWebViewConfiguration() config.allowsInlineMediaPlayback = true // recommended to prevent full screen video config.userContentController = contentController webView = WKWebView(frame: CGRect(x: 0, y: 0, width: view.frame.width, height: viewm.frame.height), configuration: config) self.view.addSubview(webView) // don’t forget to set the WKUIDelegate otherwise the target='_blank' won’t work webView.uiDelegate = self let gameUrl = Foundation.URL(string: "YOUR_GAME_URL") let gameUrlRequest = URLRequest(url: gameUrl!, cachePolicy: NSURLRequest.CachePolicy.reloadIgnoringCacheData, timeoutInterval: 20) webView.load(gameUrlRequest) } func userContentController(_ userContentController: WKUserContentController, didReceive message: WKScriptMessage) { print("data: \(message.body)") } // allow target _blank for external urls func webView(_ webView: WKWebView, createWebViewWith configuration: WKWebViewConfiguration, for navigationAction: WKNavigationAction, windowFeatures: WKWindowFeatures) -> WKWebView? { if let frame = navigationAction.targetFrame, frame.isMainFrame { return nil } if let url = navigationAction.request.url { // this will allow target _blank on urls UIApplication.shared.open(URL(string: "\(url)")!) } else { webView.load(navigationAction.request) } return nil } } [APP] Android - Java public class Demo { WebView webView; private void setupWebView() { webView = findViewById(R.id.webView); webView.getSettings().setJavaScriptEnabled(true); webView.getSettings().setDomStorageEnabled(true); webView.addJavascriptInterface(new WebAppInterface(context), "Android"); webView.loadUrl("YOUR_GAME_URL"); } private Handler handler = new Handler(); public class WebAppInterface { @JavascriptInterface public void callback(final String message) { handler.post(new Runnable() { @Override public void run() { Log.d("", "Data: " + message); } }); } } } [APP] React Native import React, { useRef } from 'react'; import { SafeAreaView, StyleSheet, Linking } from 'react-native'; import { WebView, WebViewNavigation } from 'react-native-webview'; const App = () => { const webViewRef = useRef(null); // Handle post messages (callbacks) sent from the webView const onMessage = (event: any) => { const message = event.nativeEvent.data; console.log(message); if (message === 'game') { console.log('the game has ended'); } }; // allows external links (target='_blank') always open in the default browser const handleExternalLink = (event: WebViewNavigation) => { if (event.navigationType === 'click') { Linking.openURL(event.url); return false; } return true; }; return ( ); }; const styles = StyleSheet.create({ container: { flex: 1, backgroundColor: '#fff', }, }); export default App; [APP] Flutter // in pubspec.yaml add dependency for webview // webview_flutter: ^4.10.0 import 'dart:convert'; import 'package:flutter/material.dart'; import 'package:webview_flutter/webview_flutter.dart'; import 'package:webview_flutter_wkwebview/webview_flutter_wkwebview.dart'; class MyGameView extends StatefulWidget { const MyGameView({super.key}); @override State createState() => MyGameViewState(); } class MyGameViewState extends State { late final WebViewController controller; late final WebViewWidget webViewWidget; @override void initState() { super.initState(); initializeWebView(); loadGameUrl(); } void initializeWebView() { final PlatformWebViewControllerCreationParams params = getWebViewParams(); controller = WebViewController.fromPlatformCreationParams(params) ..setJavaScriptMode(JavaScriptMode.unrestricted) ..addJavaScriptChannel("Flutter", onMessageReceived: handleCallback) ..enableZoom(false); webViewWidget = WebViewWidget(controller: controller); } PlatformWebViewControllerCreationParams getWebViewParams() { // For ios devices if (WebViewPlatform.instance is WebKitWebViewPlatform) { return WebKitWebViewControllerCreationParams( allowsInlineMediaPlayback: true, mediaTypesRequiringUserAction: const {}, ); } // For android devices return const PlatformWebViewControllerCreationParams(); } Future loadGameUrl() async { const String url = "{YOUR_GAME_URL}"; await controller.clearCache(); controller.loadRequest(Uri.parse(url)); } void handleCallback(JavaScriptMessage message) { try { final Map data = jsonDecode(message.message); final String callback = data.keys.first; switch (callback) { case 'loading': loadingCallback(data['loading']); break; case 'game': gameOverCallback(data['game']); break; default: print('callback: $callback'); break; } } catch (e) { print('Error parsing JavaScript callback: $e'); } } void loadingCallback(dynamic payload) { final Map? loadProgress = payload as Map?; final int? progress = parseInt(loadProgress?['progress']); if (progress != null) { if (progress == 100) { print('callback loading: game finished loading, progress 100'); } else { print('callback loading: progress: $progress'); } } } void gameOverCallback(dynamic payload) { final Map? gameData = payload as Map?; final int? time = parseInt(gameData?['time']); final int? score = parseInt(gameData?['score']); print('Game Over callback: Time: $time, Score: $score'); } int? parseInt(dynamic value) { if (value is int) return value; if (value is double) return value.floor(); if (value is String) return int.tryParse(value); return null; } @override Widget build(BuildContext context) { return Scaffold( body: webViewWidget, ); } } Best Practices Since the games are integrated within a WebView, you have complete control to add optional elements and functionalities on top of the WebView to enhance the overall experience. For instance, you can introduce custom controls to improve user interaction during gameplay, such as a custom close button or dynamic functionality that adapts based on whether the user is actively playing the game. See example below. Learn more how to work with Callbacks and Methods here.

Callbacks & Methods We support callbacks and methods for app integrations. You can use these callbacks and methods to create more customization in your app, for example your own loading screen or a custom restart view for your game. You can also use them to save data passed back to you from the game to create custom experiences in your app, such as unlocking certain features of your apps using games. Callbacks Callbacks contain an interface name that you may listen to. Once the data is being sent the body of the message will contain the json data passed to your interface. Callback: Loading If you wish to build a custom loading screen for your game you can use our callback for Loading. When the progress value reaches 100 you are ready to hide your custom loading screen and present the game. Note! This callback should not be used as a listener for when to call startGame(). Instead use the gameReady-callback. Example: {"loading": {"progress": value}}; Parameter Type Description value int Progress of your loading, 0-100. Callback: Game Ready When the game along with all components has finished loading and the game is ready to be started. Use this callback if you wish to call startGame-method programmatically. Example: {"gameReady": {"state": true}}; Parameter Type Description state Bool State is sent as true Callback: Game Started When the user starts a game round the data will be passed to your app’s interface. Example: {"gameStarted": {"state": true}}; Parameter Type Description state Bool State is sent as true Callback: Game Over When the user completes a game round the data will be passed to your app’s interface. Save the game data as you see fit and use it to build gamified solutions within your app. Example: {"game": {"time": time, "score": score}}; Parameter Type Description time int Time spent of the game round (seconds) score int Score of the game round Callback: Game Click When the user clicks on a CTA within a game this event will be called. Example: {"gameClick": {"state": true}}; Parameter Type Description state Bool State is sent as true Methods Can be called from your app to trigger actions in the game. Method: Start Game If you wish to build your custom Start Game-button in your own restart view. Example:iOS Swift: yourWebView.evaluateJavascript("startGame()");Android Java: yourWebView.loadUrl("javascript:startGame()"); Method: Game Over If you wish to manually end a game round for the user, e.g. when the user closes or leaves your app and you wish to retrieve the game data for that current round you can manually call the endGame method. Example: iOS Swift: yourWebView.evaluateJavascript("gameOver()"); Android Java: yourWebView.loadUrl("javascript:gameOver()"); Method: Turn Sound On You can set if the sound should be on or off as default on the Settings page in Flarie Studio. If you want to create your own custom restart view with sound settings in your app you can use this method to turn the sound on. Example: iOS Swift: yourWebView.evaluateJavascript("turnSoundOn()"); Android Java: yourWebView.loadUrl("javascript:turnSoundOn()"); Method: Turn Sound Off You can set if the sound should be on or off as default on the Settings page in Flarie Studio. If you want to create your own custom restart view with sound settings in your app you can use this method to turn the sound off. Example: iOS Swift: yourWebView.evaluateJavascript("turnSoundOff()"); Android Java: yourWebView.loadUrl("javascript:turnSoundOff()"); Method: Pause Controller You can call this method to display the pauseController. With the pauseController the user can pause the game to see game instructions and also resume or end the game round. The pauseController will automatically hide again when the game ends. Example:iOS Swift: yourWebView.evaluateJavascript("showPauseController()");Android Java: yourWebView.loadUrl("javascript:showPauseController()");

[POST] Trigger Gamification events This guide is for external Gamification Condition - events created in Flarie Studio. Example / Use Case Company X run an e-commerce selling clothes online and want to increase their sales on t-shirts. To do so they incentives Customers by giving out 5 game attempt to a promotional competition with great prizes every time a Customer buy a t-shirt. Company X has created a Gamification Condition in Flarie Studio that is configured to give 5 game attempts to the customer every time this api is called. When the Customer purchase a t-shirt, Company X will trigger the api from their backend. Company X has a unique identifier on their end on every Customer. This is passed as the playerIdentifier in the api. When it’s time for the Customer to play in the competition the same playerIdentifier is passed to the game as a URL Parameter. [POST] https://prod-api.flarie.com/v1/public/gamification Payload { "accessKey": "string", "gamificationConditionId": "string", "playerIdentifier": "string" } Name Type Description accesskey string Brand Access Key. You can generate your accessKey in Flarie Studio → Manage Brand Assets gamificationConditionId string Gamification Condition Id. You will find your gamificationConditionId in your Flarie Studio Gamification Condition. playerIdentifier string Player unique identifier Response Message Status code Message 201 Created 400 Bad Request Your accessKey / gamificationConditionId / playerIdentifier is invalid. 403 Forbidden Your accessKey isn't permitted to access the gamificationConditionId 500 Internal Server Error

[GET] Gamification This guide is for getting the number of attempts for a single playerIdentifier in a gamification. [GET] https://prod-api.flarie.com/rest/gamification-service/v1/player-gamifications/player-identifiers/{playerIdentifier}/gamifications/{gamificationId} URL Parameters Name Type Description playerIdentifier string The unique identifier of the player gamificationId string The gamificationId of your gamification setup Note! you need gamificationId, not the gamificationConditionId. You can locate your gamificationId in the URL on the edit gamification page. Response(200) { "playerIdentifier": "demo-player-identifier", "entityType": "PLAYER_GAMIFICATION", "gamificationId": "xxxxx-xxxxxx-xxxxxx-xxxxxxxx", "updatedAt": "2023-11-10 12:58:14", "createdAt": "2023-11-10 12:57:37", "SK": "xxxxx-xxxxxx-xxxxxx-xxxxxxxx", "attempts": 4, "PK": "PLAYER_GAMIFICATION#demo-player-identifier", "id": "090cb380-2663-4cae-a20d-85967d03c78c

Receipts Scan Who can use this feature: Admin, Manager, Designer. Analyst has access to analytics data The Receipt Scan feature allows you to gamify purchases by letting users scan receipts. You can connect this to a gamification scenario to reward users with coins or game attempts after a purchase. This is a useful way to drive product engagement and incentivize real-world actions. Before you start Make sure you have a gamification scenario set up with at least one external condition. Create a receipt scan Go to Receipts in the menu. Click Create New Receipt Scan. In General Settings, add an internal name. (Optional) Set a Start Date and End Date. Select a Player Identifier. Note The same identifier must be used across your gamification setup. 6. Adjust styling and terms to match your brand. Add a condition Go to the Condition tab. Click Add Condition. Select currency. Set a minimum purchase amount. Choose a gamification scenario to connect. Add products Go to the Product tab. Click Add Products. Add products individually or in bulk. Add an internal name for each product. Include name variations as they may appear on receipts. This helps ensure accurate product recognition. Add stores Go to the Store tab. Click Add Store. Add stores manually or upload multiple using a template. The system will use this to recognize valid stores during scanning. Finalize and share Once setup is complete, your receipt scan is ready to use.You can: Copy the link Share it via QR codes, campaigns, or social channels Users can then scan receipts and receive rewards based on your gamification setup.

Uploaded Receipts In uploaded receipts you can view data and search all the receipts that have been uploaded to the system.

Receipt Analytics In receipt analytics you can sort the analytics data depending on what market/currencry you have selected in the receipt condition and filter on a certain time period. Analytics data that you can see are: Total receipt Total products Total purchase Avg purchase Top chains Top stores Top product

Manage Winners The Manage Winners page shows all players who have won or qualified in the competitions configured in your game. The tables will only appear if one of the following features is enabled: Challenge Luck Based Wins Winners & Prizes Each section displays winners based on the settings used in the corresponding feature. Randomize Winners The Randomize Winners function allows you to manually generate winners from players who completed a challenge. Click Randomize Winners. Select how you want winners to be selected. Enter the required values. Generate the winners. After generating winners, you can download a CSV file containing the list. Selection methods Randomize by minimum high score Select winners from players who reached a defined minimum score. Randomize by probability (multi-entry) If multi-entry is enabled, winners can be selected based on probability instead of score. Randomization settings Number of winnersDefine how many winners should be selected. Min pointsSet the minimum score required to qualify. Max pointsSet the maximum score range for selection. If you want to replace a selected winner, click Change next to the winner. The system will replace them with another qualifying player. Challenge winners This table shows players who completed the challenge and any winners automatically generated based on your challenge settings. You can search for players, filter by parameters, or export the list as a CSV file. Luck Based winners This table shows players who won rewards through the Luck Based Wins feature. You can search for players, filter data, or export the list as a CSV file. Winners & prizes winners This table shows winners selected through the Winners & Prizes feature. You can search for players, filter data, or export the list as a CSV file.

Welcome to Flarie Studio Help Station 🚀 This is your go-to resource for learning how to get the most out of our platform. Whether you’re just starting or looking to refine your skills, the Help Center is here to guide you at your own pace. We’ve organized everything to make it as simple and straightforward as possible to find the help you need. Here you can find Step-by-Step Guides with clear instructions to walk you through every feature and setting, one step at a time. New to the platform? Watch our Tutorial Video: Our goal is to support you in using Flarie Studio with ease and confidence. Whether you’re tackling a new project, streamlining a workflow, or simply exploring what’s possible, the Help Center is here to help you along the way. ✨ We’re excited to help you get started!

Go to Account

Alternative Designs

Alternative Designs allow you to create multiple visual designs for the same game without changing how the game works. Use them to support Light and Dark Mode, create different color themes, or provide accessibility options such as color-blind-friendly designs.

When Alternative Designs are enabled, your current default design becomes the Light design. You can then add a Dark design and any number of custom alternative designs.

How to Add Alternative Designs

Go to Alternative Designs in Game Settings and enable the setting.
Your current design will automatically become the default Light design.
Add a Dark design or create additional custom designs.
Edit the design name to choose how each option is displayed to players.
Select each design from the design mode bar and customize the graphical elements to create your alternative design.

You can add as many custom designs as you need, but only one design can be set as Light and one as Dark. This allows the game to automatically match the Light or Dark Mode preference of the player's device.

Design Mode Bar

After enabling Alternative Designs, a design mode bar appears on the left side of the settings panel.

The default Light design is always displayed at the top and is represented by a sun icon. A Dark design is represented by a moon icon, while custom designs are represented by a color palette icon and a number.

Select a design from the bar to edit its visual appearance.

When an alternative design is selected, text fields and other non-visual settings are locked. You can only change graphical elements that are supported by Alternative Designs. This ensures that the game's content, settings, and functionality remain consistent across all designs.

Player Design Selector

When Alternative Designs are enabled, a design selector appears in the top-right corner of the Start Game view. Players can use it to switch between the available designs.

You can disable the design selector if you don't want players to manually change the design. When disabled, designs can still be selected automatically or through the game URL.

How a Design Is Selected

When a player opens the game, the design is selected using the following priority:

Design specified in the game URL
Player's system preference for Light or Dark Mode
Player's previously saved selection for that specific game
Default design

For example, if a player's device is using Dark Mode and you have configured a Dark design, the game can automatically display that design. If no matching design or other selection is available, the game uses your default Light design.
Alternative Designs give you flexibility to adapt the visual experience for different players, campaigns, and accessibility needs while keeping the same game content and functionality.