[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. This event will be sent at the start of every Game Session. 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 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 Rewards Description: Event sent when the Player purchase a Reward in the Game Center. Payload options: Event, Player, Game Center, Game Center Reward, 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 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 Player from your userbase. Flarie Value JSON value Description gameCenterId @gameCenter.gameCenterId The gameCenterId gameCenterName @gameCenterme.gameCenterName The name of your Game Center Game Center Reward Description: Data about the Player from your userbase. Flarie Value JSON value Description gameCenterRewardId @gameCenterReward.gameCenterRewardId The Reward Id gameCenterRewardName @gameCenterReward.gameCenterRewardName The Reward name rewardPrice @gameCenterReward.rewardPrice The Rewards cost in coins Winners Description: Data about the Player from your userbase. 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! Prerequisites Before you begin, we highly recommend that you take steps to ensure your integration is secure. You’ll authenticate your webhooks using your Flarie Studio account’s: Access Key - used for identifying requests Secret Key - used to validate payloads with HMAC signature Learn more in the Authentication guide. 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 handle 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. 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. 3. 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. 4. 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 Authentication When integrating with external systems, security is key, especially when sensitive user data is involved. To ensure your webhooks are both trusted and protected, Flarie offers a simple yet powerful authentication method using your account’s Access Key and Secret Key. In this guide, you’ll learn how to securely authenticate your webhooks step-by-step. By following best practices for authentication, you can be confident that your data integrations are safe, verified, and reliable - every time an event is triggered in your Game or Game Center. Whether you're connecting to internal systems or third-party platforms, this setup gives you the tools to ensure that only authorized sources are calling your endpoints—keeping your data secure and your integrations trustworthy. Enable API Access Key in Flarie Studio (recommended) Learn how to enable API Access Key in Flarie Studio here When the API Access Key feature is enabled, every webhook request sent from Flarie will automatically include a Bearer token in the Authorization header, formatted like this: Authorization: Bearer While verifying this token on your endpoints is optional, it’s highly recommended. Adding this check gives you an extra layer of security by ensuring that incoming requests are genuinely from Flarie, and not from an unauthorized source attempting to mimic our system. Enable Secret Key in Flarie Studio (optional) Learn how to enable Secret Key in Flarie Studio here When the Secret Key is enabled, every webhook request sent from Flarie will automatically include the X-Signature in the header. X-Signature: This X-Signature is a SHA-256 HMAC (Hash-based Message Authentication Code), generated by hashing the raw JSON payload using your account’s Secret Key. It serves as a digital signature, allowing you to validate both the integrity and authenticity of the webhook request and data. By recalculating the signature on your end and comparing it to the one sent in the header, you can be sure the payload hasn’t been tampered with - and that it genuinely came from Flarie. Here’s a simple Node.js example to verify the signature: 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") } Adding this verification step is optional—but highly recommended for any critical or sensitive 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 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 MeetingWant 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 Gamification Attempts 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 will be used in the URL's of redirection links you have created in Flarie Studio How to set Brand Prefix: Navigate to Assets & Settings in the mega menu and then to Brand Prefix in the side panel Fill in the Brand Prefix you wish to use, by default it's set to your brand name without any special characters.

Language Who can use this feature: Admin, Manager Select what language you wish to be used as default for non-editable texts. How to set Language: Navigate to Assets & Settings in the mega menu and then to Language in the side panel Select the language you wish to use in the dropdown. The selected language will be set as the default language in all new Games and Game Centers. It can still be edited in respective individual settings.

Desktop Background Image Who can use this feature: Admin, Manager, Designer Upload a desktop background image to set as your brand's default image in Games and Game Centers. How to upload a desktop background image: Navigate to Desktop Background Image in Assets and Settings through the mega menu. Drag or select a file to upload to the 'Default Game Page Background Image. Your default game page background image will now be applied as default to all future Games and Game Centers but can still be edited in the Game/Game Center settings.

Colors Who can use this feature: Admin, Manager, Designer Add color swatches in your assets to easier manage color usage when styling components. How to add color in assets: Navigate to Colors in Assets and Settings through the mega menu. Click the 'Add Color' button. Click the color box and change the color though the color picker or type in the hexcore (optional) Name your color for easier identification Your colors will be available though the color picker in the tab 'Assets'.

Custom Button Who can use this feature: Admin, Manager, Designer The Custom Button feature lets you create customizable text boxes or clickable images. You can choose whether the button triggers a URL, displays an image overlay, or performs no action. This section allows you to set up Custom Buttons for reuse across multiple games. Once a button is created in Assets & Settings, it will appear in a dropdown menu in your Game Settings, ready for selection whenever you need to add a button to a game. This saves you the effort of recreating and styling the button for each new game. How to add a Custom Button to Assets & Settings Go to Assets and Settings and navigate to Custom Button in the left hand panel Click on + Add Custom Button and Give your button an Internal Name. This is optional but good to do to easier find your button in the drop-down in Game Settings and in Analytics. Select if you want the button to be used as default in your games. Checking this box will automatically add the button to all new games you create. You will still be able to edit or delete the button in the Game Settings Add text or image and style your button to suit your design. You can also use an image as background. Select if you want the button to always be displayed, or only be displayed after the player has played a round. (optional) Add more Custom Buttons by clicking the + Add Custom Button. There is no limit to how many buttons you can add, but make sure to change the Y value in shape styling in the style bar so that the buttons don’t overlap with each other. To Create another button, just click on the +Add Custom Button again If you wish to remove a button, click on the trash icon at the top left hand side of the button you wish to delete. The button will no longer appear in the drop-down on Custom Button in your Game Settings How to add a Custom Button from Assets & Settings in your Game The buttons you have created will be available to select in a dropdown menu at the top of the settings panel. This allows you to select the button to automatically apply its pre-configured settings in the game.

Publish Game and Version History Publish Game The Publish function lets you control when changes to your Game 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, it’s automatically published as the first version. Game Cards: On the Games Dashboard, the card for each Game shows the published version. A banner will appear if there are unpublished changes, prompting you to take action Excluded Sections: Some areas like the 'Time Period' or 'Game Status' are excluded from the publish workflow. Changes here are immediately published in the Game and cannot be unpublished. Sharing Your Game: Use the 'Share Published Link' to copy a link to the most recent published version of your Game. Steps to Publishing a Game: Make Edits: Modify your Game 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 with the changes you published. This feature ensures smooth game updates while keeping control over what your players see. Version History Version history helps you track, view, and manage all the versions of your game, offering flexibility and control over past and current updates. Accessing Version History: Open the 'Other Options' dropdown in your Game. Select Version History to enter version history mode. A panel appears on the right, showing all versions of the Game that has been published. Current Draft: Your working draft (if unpublished) is always at the top, labeled Unpublished Published Versions: Below the draft, find all past published versions listed from newest to oldest. The most recent is marked Latest Published Details: Each version shows the date, time, and the user who made the update. Actions You Can Take: Click the "..." icon next to any version to: Copy Settings to a New Game: Reuse settings from that version in a new Game. Duplicate This Version: Create an exact copy of that version of the Game. Restore This Version: Replace your current draft with the selected version. You will be prompted to confirm this action. Selecting and Restoring Versions Select a version from the panel to preview it. The game will update to reflect that version in view-only mode. If you decide to restore it, confirm the action in the pop-up. The restored version becomes your current draft, overwriting any unpublished changes. Exiting Version History: Click Exit Version History or close the panel to return to your game’s regular settings. By using version history, you can confidently experiment with changes, knowing you can always return to a previous 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 is where all the data collected from your Game’s users is presented. This tool provides various options to analyze, manage and export user data from the Game, to ensure you can make the most of your Game's audience. Here’s a breakdown of the key features and how to use them: Data Overview: The page displays all user data collected from the game. Search: Use the search bar to find specific users quickly. Export: Download user data by clicking the 'Export button'. The button also indicates the number of users included in the export. If your game has 'Split Game' activated, a time-period dropdown will appear at the top of the Userbase table. The default view shows the data from the first time period. To view data for a different time period, select it from the dropdown. The table will update automatically. Editing User Data You can modify user details directly from the table to keep your data accurate and up-to-date.

Time Period & Split Game Turning this feature on will give you the possibility to split your Game, meaning you could have e.g. 4 competitions during a month to run weekly competitions with your Game URL. How to set up Split Game: Adding monthly time periods to my game In the selected Game go to Time Period and set a Start - and End Date for your Game Scroll down to Activate 'Split Game' by switching the toggle to ON In the popup, set your first Game period Click on add time period and add the desired number of periods Add a single time period: To add a single time period, set the desired End Date after opening the add time period popup. After that, hit update and the added time period will appear in the table. Add multiple time periods To add multiple time periods at once, select Add Time Periods, and in the popup, select Multiple Time Periods. Select the start date of your second period and add the number of periods you want to create, along with the number of days each period should contain. Please ensure that the start date of the multiple time periods doesn't overlap with the first game period that you created.

Data Collection The Data Collection functionality allows for the collection of various types of first party data. The key selection in this section is the Player Identifier, which determines how the game tracks individual players. A unique identifier is essential for features like Winners & Prizes, while an Email or Username is required to distribute prizes via email or to set up a leaderboard. Different types of identifiers: Browser: This option identifies the player by placing a token in their browser. If the player change the browser or clears their cache, a new token and identifier is created for that player. Email: This option identifies the player by the Email address that they submit in a form before playing their first game round. If the player changes the email address, a new token and identifier is created for that player. Mobile: This option identifies the player by the Mobile Number that they submit in a form before playing their first game round. If the player changes the Mobile Number, a new token and identifier is created for that player. URL Parameter:This option identifies the player by a value that you pass to the game. A UUID will be added as a query parameter on the url where you add the value for the player. This is the recommended approach for integrations. Example: https://your-game-url.com?uuid={your-player-identifier} Note! We always recommend using a non-functional token to identify your player. Other Parameters There are several different default parameters available in Data Collection that you may add to your Form. Default Parameters available in Flarie Studio: 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 You can set up your own custom parameters in 'Assets & Settings', with support for text fields, radio buttons, dropdowns and checkboxes. Read more about creating custom parameters here. Simply add what data you want to collect in the form and they will appear in the drop down. Furthermore, you can style the look and design of the form fill that appears when collecting different types of data parameters from the users. This includes Form Title, Terms & Conditions Text, Start Game Button-text etc. To add Data Collection to your game, click on +Add Settings at the bottom of the left hand panel and select 'Data Collection'. The setting will then be added to your panel and you can start setting up your Player Identifier or adding data collection parameters.

Spritesheets A Spritesheet is a single image that combines multiple images. In supported Games, spritesheets allow you to alternate objects during gameplay or create animations, adding vibrant movement and life to your Game. To create a spritesheet, arrange your design assets in a row, side by side, without any spacing between them. If the Game you have selected supports spritesheets, this is noted in the description under the image title. For animated spritesheets, ensure that each frame aligns smoothly with the next to create a seamless animation effect.

Manage Users Who can use this feature: Admin, Manager The 'Manage Users' section allows you to edit existing users and add new ones to your brand and organization. Here's how it works: When you add a new user, they will receive an email invitation to register on the Flarie Studio platform. Once registered, they will automatically be added to your organization with the specific access and role you assigned during the invitation process. As an admin or manager, you can update user roles and permissions in 'Manage Users' at any time to reflect changes in your team’s needs. Available User Roles: Admin: An Admin has full access to all Brands within the Organization and can approve documents, such as Business Terms and Order Confirmations. Admins can add new users for any user roles. Manager: A Manager has access to everything within the Brand. He/she can edit and add users with Manager, Designer or Analyst user roles. Managers will also receive emails regarding updates Terms & Conditions. Designer: Access for Designers is restricted to Creating and Editing Games and Game Centers, but not 'Manage Winners', Analytics or Player data. Designers also have access to Brand Assets. They cannot add new users to Studio. Analyst: Analysts have access to User Base, 'Manage Winners' and Analytics for Games and Game Centers but can not create or edit. Analysts can set up data integration. They cannot add new users to Studio. Important to Note: As a Manager, you cannot upgrade your own role to Admin or assign Admin-level access to yourself. Managers are also restricted from granting access to other brands within the platform. This feature ensures that user management remains secure while giving you the flexibility to organize and grow your team effectively.

Design Assets This is where you can add your custom design to your Game. Each Game has 5 to 20 different brandable assets including the background, players, obstacles, enemies and pickups. Use your favourite design tool to help create the different assets for the game. Then simply drag and drop your assets into Studio and the game is instantly updated. Make sure to use the correct image sizes and file formats. Different Games may have different requirements for the image size needed for the game to function correctly. Each asset have the image size requirement listed under the description. There is also the possibility to brand the screens and buttons before and after your Game so don't forget to add some creativity and personal touches to those as well. Lastly, be mindful of contrast when designing. Ensure that objects and pickups stand out clearly against the background to keep gameplay smooth and visually engaging. Tips! If you need a template on how to create a specific design asset download the existing asset from that Game and open it in your design tool of choice. Simply click the 'download' button in the bottom right corner of the asset and design away.

Web Page Background Image The Web Page Background Image is placed behind your Game when it’s viewed in a web browser, offering an additional opportunity to enhance your branding. Some brands use this space to display a logo next to the game or to extend the game’s visual world across the entire screen, creating a more engaging experience. If your Game is likely to be played in a web browser, be sure to upload an image for the Web Page Background to make the most of this branding opportunity You can preview the background by clicking on 'Full Preview' in the top panel. The preview will then open in a new Browser window and you can see how the Web Page Background Image fits your Game. .

Create Game After clicking on Create Game you will be taken to the Game Wizard. Here, you can explore Flarie Studio's full Game Library and select the Game you'd like to brand. You can hover over any game to view a quick tutorial on how to play. Filter options: Time Spent Average time users spend playing each game, helping you choose Games that align with your engagement goals. Easy to Design: Indicates the level of customization required for the game, based on the number of customizable assets and elements. Branding Purpose: Games vary in suitability depending on the type of branding. For instance, some games make it easier to showcase multiple products. Platform: All games are mobile-friendly, but some may be challenging on desktop. This filter helps identify games that adapt well across platforms. Demographic Age: Highlights top-performing games for different age groups. Demographic Gender: Highlights top-performing games for different gender groups. Game Categories: Browse games by categories, making it easy to find the type that suits your goals. Tags: Additional tags to refine your search based on other relevant criteria. Using these filters allows you to find the perfect Game quickly and align it with your branding and engagement needs.

Parallax Effects Parallax effect is a layered setup where images move at different speeds within the Game. This effect adds depth and visual interest, making the Game environment feel more dynamic and immersive. Since the image will loop, make sure both ends align seamlessly for a smooth transition. Pay attention to how different layers interact with each other; if you want something, like a logo or product, to remain visible at all times, place it on a layer that won’t be covered by the front layer. Tips! Our top tip is to test thoroughly—play through the game a few times after uploading your images to confirm that everything looks good, loops well, and achieves the effect you want.

Game Status The Game Status defines whether a game should be considered active or not. The status can be toggled between the following statuses: Active: This means that the game counts as an active Game link. This is especially significant for One Game licenses which only allow one active game link at a time. Games also need to be active to work in Gamification scenarios and/or to send payloads if added to webhooks. Draft: The game is currently only a draft and will be populated with banners notifying you that the Game is still in draft mode. It is not counted as an active game link. Expired: This status will automatically appear if a Game has been populated with specific start and end dates. Once the Game passes the end date, the Game Status is changed to Expired by the system.

Start Game Button The 'Start Game Button' can be customized in many different ways to suit the game design. The button consists of two parts, the “Start Game” text and button, and a section showing the high score, ranking and score from latest play round of the player. High score & Ranking The high score shows what the players best score is and what score they got in their last playthrough. In addition to high score, you can also select to enable showing the players their ranking. Ranking shows the current players rank in the game. We recommend pairing ranking with a leaderboard and player identifier. Customize the start button You can select the color and font, as well as adjust the corner radios of the button. For more advanced customization you can also select to upload an image. The uploaded image can be in .png or .jpeg file format and will scale automatically to fit the button size. You can style the button differently, depending on the status of the Game so that the button has a specific color when e.g. status is Expired. Attempts Attempts is a feature that limits the amount of times a player can play the game and the player will have to gain attempts to be able to play more. You can select whether you want the player to gain a number of attempts daily or get a total set number of attempts. Game attempts will have priority over Gamification attempts, meaning the Game attempts will be used first, when combined.

Terms Add your own Terms and Conditions to your Game with 'Additional Terms'. The terms are located in the bottom start game page through the text. Any additional terms will be added underneath the Flarie’s Terms and Policies. If you wish to use the same additional Terms for all your Games, you can pre write your terms for Games and Game Centers in 'Assets & Settings' and it will carry over to all future Games and Game Centers. The 'Additional Terms' can still be edited on individual Games and Game Centers.

Leaderboard To use the leaderboard feature you must first activate data collection. The leaderboard can be customized in how many users it shows on the board, the style and of the leaderboard and if it should be visible, before or after the player have played a game. A tips is to activate ranking in the 'Start Game' button so that the user can see what rank they are in the button as well. You can edit the style of the background and texts in the Leaderboard. You can also select the number of rows and if you would like to have a Leaderboard description.

Custom Button The Custom Button feature enables you to create custom text boxes or clickable images. You can select if you want your button to trigger a URL, to open an image overlay or if you want no action. You can also select if you want the buttons to be available before a user has played a game round, or after. This feature most resembles a classic Call To Action button which can be found amongst other online platforms and media. How to add a Custom Button to your game In the selected game, go to Game Setting → Custom Button and switch on the toggle to activate. Add text or an image and style your button to suit your design. Select if you want the button to always be displayed, or after the player has played a round. (optional) Add more Custom Buttons by clicking the + Add Custom Button. There is no limit to how many buttons you can add, but make sure to change the Y value in shape styling in the style bar so that the buttons don’t overlap with each other. Load a pre-configured Custom Button from Assets & Settings If you’ve created Custom Buttons in the Assets & Settings section, a dropdown menu will appear at the top of the settings panel. This allows you to select a version of the button to automatically apply its pre-configured settings in the game. To learn more, check out the Custom Buttons feature in Assets & Settings. If you’ve set a custom button to be added as the default for all games, it will automatically appear as activated in your settings when you create a new game. You can still edit or remove default buttons in the game settings if needed.

Challenge The challenge function enables you to trigger an event upon a player reaching a certain score. This is the most commonly used functionality when setting up competitions in Flarie Studio Games. This feature can trigger different types of events based on the settings you choose. How to set up a Challenge in the Game To add a Challenge to your game, click on +Add Settings at the bottom of the left hand panel and select 'Challenge'. The setting will then be added to your panel. (optional) Set a target score for your Challenge to encourage your players to play more of the Game. Don’t forget to edit your text to fit your Game. If you are unsure of what Game Score to set, we suggest playing the Game a few times to get an idea of what a good limit would be. If you need suggestions, do not hesitate to contact us for some guidance. Select a Reward type from the 5 available options. Read more about the reward types here. Reward Types Different reward types for challenge Coupon Code - Same for everyone: This reward type will make distribution for one code available through a selected distribution method. It’s perfect if you want to distribute a discount code to all players who have completed the challenge. Coupon Code -Unique for everyone: This reward type makes uploading of codes to distribute available. The code will be displayed through your selected distribution method. This option is good if you want to control the number of rewards that are getting distributed. You can upload an unlimited number of codes, just make sure there are enough codes for each player. If they are all used up, new players won't be able to gain a code, as they are unique to each player who has completed the challenge URL -Same for everyone: This reward type will create a CTA button with one single destination. It’s perfect if you want your players to visit e.g. a specific website after they complete the challenge. You can set the URL in your selected distribution method. URL-Unique for everyone: This reward type will generate a CTA button that is unique for every player in the selected distribution method. This reward type is good if you want to limit the number of URLs that you are distributing. You can upload an unlimited number of URLs, just make sure there are enough URLs for each player. If they are all used up, new players won't be able to gain a URL, as they are unique to each player who has completed the challenge Form - Ask users for data: Reward type Form will instead of a reward in-game popup trigger a form where the players that have completed the challenge will be able to fill in the form with the specific data parameters that you choose to set up after they have finished playing the Game. The data will then be added to the user’s ID and gathered in the User Base. This reward type is an excellent way to gather information about your players such as their Email and Name. Tips: In Manage brand assets → Form Parameters you can create new form parameters that you want to add to the form. Display the reward in-game Make the reward available to your players after they complete the challenge, by enabling reward in the game. How to Set up Reward in Game Toggle Reward in Game to 'Yes' Change the text and style to suit your game. Depending on the selected reward type different styling options will be available. Email distribution Send an email to all players that have completed the challenge with their reward, by enabling email distribution. Toggle the switch on ' Send Prize though Email' to ON Set your email sender so that the player knows who the sender is. The email sender will be defaulted to your brand name but can be edited. Set the text and style of your email. You can also use the Send Test Email function to send a preview of the mail that will be distributed to the players. Tips: In Assets & Settings → Email you can set a default email sender and style for all Emails and save time on future Emails. Multi Entry Motivate your players with an increased chance of winning by entering the challenge multiple times. Toggle the switch in ' Multi-Entry' to ON Set a limit to how many times a player can enter the challenge. You can set if the limit should be daily or total for the game period. Style the text to fit your game and brand To delete a Challenge, click the trash can icon next to the setting in the panel, then click 'Publish' to apply the changes to your game. Note that any uploaded codes or URLs will update immediately in the published game, but the feature itself won’t be removed until you publish. To disable Challenge, toggle the switch in the top-right corner of the feature settings. This will disable the feature but retain your configurations, in case you want to enable it again. Remember to click Publish for the changes to take effect in your game Manage Challenge Winners In Manage Winners you can see the list of all players that have completed the challenge, along with their high scores.

Luck Based Wins Who can use this feature: Admin, Manager, Designer The Luck Based Wins function enables you to create a Game where the users know instantly if they have won a prize or not. How to Set up a Luck Based Wins Game Go to Luck Based Wins in the settings panel and toggle the switch to ON to activate the Luck Based Wins setting Set the details for luck based wins, you can select if you want the game to have a score requirement that the player should reach or not. Set the reward details. Select Reward Type (Read more about Reward Types for luck based wins here), adjust the winning statistics and set a reward limit. The reward limit can be adjusted to be a daily limit or a limit for the whole Game period. Set Reward Distribution, adjust the text and styling to fit your game and select the type of popup you want to include in the Game. (optional) You can activate email distribution if you want to email the reward to the user, this function can be used alongside reward popup and stand alone. Reward Types Different reward types for luck based wins Coupon Code - same for everyone: This reward type will make distribution for one code available through a selected distribution method. It’s perfect if you want to distribute a generic discount code to all players who have won the reward. Coupon Code - Unique for everyone: This reward type makes uploading codes to distribute available. If they are all used up, new players won't be able to gain a code, as they are unique to each player who has earned the reward. The code will be displayed through your selected distribution method. This option is good if you want to control the number of rewards that are getting distributed. URL - Same for everyone: This reward type will create a CTA button with one single destination. You can set the URL in your selected distribution method. It’s perfect if you want your players to visit e.g. a specific website for their reward. URL - Unique for everyone: This reward type will generate a CTA button that is unique for every player in the selected distribution method. You can upload an unlimited number of URLs, just make sure there are enough URLs for each player. If they are all used up, new players won't be able to gain a URL, as they are unique to each player who has gained the reward. This reward type is good if you want to limit the number of URL’s that you are distributing. Form—Ask users for data: The reward type Form will trigger a form instead of the reward in-game popup. The players who have won the reward will be able to fill in the form with the specific data parameters that you choose to set up. The data will then be added to the user’s ID and gathered in the User Base. This reward type is an excellent way to gather information about your players, such as their Email and Names. Tips: In Manage brand assets → Form Parameters you can create new form parameters that you want to add to the form. URL in button: This reward type will create a CTA out of the winner's text on the game instead of triggering a pop-up when receiving the reward. With this function, you can direct the player to a desired website without triggering a popup. No Instant Reward: No winner message will be displayed or distributed to the player.after completing the game. Reward Distribution Methods In addition to a winner text that will appear on the game to notify the player that they have won a popup or/and emails can be used. Popup - VisualReward in game can be selected when picking a reward types Codes, URLs or Form (1-5) in 'Reward Type'. By selecting this option you will be able to upload desired icon (optional) and add a reward text. Depending on the Reward type you also style the code and url button that will appear in the popup. Popup - Simple text box:The simple text box popup are available for reward types Codes and URLs (1-4). In the simple text box popup the code or URL will not appear so it's suitable to combine with email distribution. By selecting this option you will be able to upload desired icon (optional) and add a reward text. Popup - No popupThis option will disable the winner popup and its suitable for when you only want to show the winners text in the game or only send an email without having a popup in game. Send Prize through Email You can also activate the setting to send emails to players that have won a reward. To activate this settings you need to have Data Collection activated and email as a parameter so that the system can collect Email addresses and send emails to they players who have won a reward. Manage Luck Based Winners In manage winners you are able to see the list on all players that have won a reward.

Winners & Prizes The Winner & Prizes function makes it so that winners will be automatically selected by the system and any prizes will be distributed automatically when the game period ends. How to set up Winners & Prizes To add Winners & Prizes to your game, click on +Add Settings at the bottom of the left hand panel and select 'Winners & Prizes'. The setting will then be added to your panel. Select the Unique Identifier to Email, to identify the player. Now that the Unique Identifier has been set up you can go to Game Settings → Winners & Prizes to toggle the switch to ON to activate that function. Select how you want the system to select the winner. 'Randomized by High Score' allows you set a minimum score that users need to reach in order to have the chance to win the prize (optional). The winner will then be randomized from the list of players that qualify, or from all players if no minimum score is set. 'High Score': Selects the top players based on their high score Select the number of winners you want the Game to have. Of your reward is 'Unique URLs' or 'Unique Coupon Codes', make sure you have enough URLs/Codes uploaded (optional) if you have selected 'Randomize by High score' this is where you can set a minimum high score that needs to be reached by the player to qualify to be randomized as the winner. Randomize by probability (multi-entry) is only available if you can activate multi-entry in challenge, read more about multi-entry here. (optional) Select and set up if you want the prize to be distributed through email To delete Winners & Prizes, click the trash can icon next to the setting in the panel, then click Publish to apply the changes to your game. Note that any uploaded codes or URLs will update immediately in the published game, but the feature itself won’t be removed until you publish. To disable Winners & Prizes, toggle the switch in the top-right corner of the feature settings. This will disable the feature but retain your configurations. Remember to click Publish for the changes to take effect in your game. Send Prize Though Email The system can automatically send prizes through email when the game period ends. Scroll down to Send Prize Through Email and switch the toggle to ON to activate it. Select and set up the Reward Type (read more about the Reward Types below) Set the email sender so that the user knows that you are the sender. The email sender will be defaulted to your brand name. Set the text and style of your email. You can also use the Send Test Email function to send a replica of the mail that will be distributed to the players. Tips: In Assets & Settings → Email you can set the email sender and style of email beforehand and save time on future Emails you create. Reward Types Different reward types for prizes: Coupon Code - same for everyone: This reward type will send the same code to all winners. It’s perfect if you want to distribute the same discount code to all prize winners. Coupon Code - Unique for everyone: This reward type allows you to upload unique codes to the winners. Make sure that you upload the same amount of codes as the set selected winners. URL - Same for everyone: This reward type will create a CTA button with one single destination in your email to the winners. URL - Unique for everyone: This reward type will create a CTA button that has a unique URL for all prize winners. Make sure that you upload the same amount of codes as the set selected winners. Manage Winners & Prizes In Manage Winners you can see the list of all players that have won a prize.

Popup Messages This section dictates the styling and texts for the different popups in your game Center. In the main section you can set the styling for the pop-ups as well as the text and styling for the general Confirm, Close and Next buttons. You can also set the texts for confirmations (pop-up text Prize) and the error messages that might be needed, e.g. if the users tries to make a purchase without having enough coins or if a reward is out of stock. All these texts are pre-populated but you might want to edit them to suit your Game Center better, or translate them to another language.

Modules The main content of the Game Center consists of different modules. There are four different kinds: Game Module, Ad Module, Text Module and Rewards Module. You can mix these modules and place them in whatever order you want. You can also use the same kind of module and stack on top of each other several times. Status on Modules You can choose to control if a module should be visible or not in the Game Center through the Module Status. You can change the status through a toggle. A module status can either be visible or hidden. Module status overrides status on the Game and Reward level. Start and End Date You can choose to set a Start Date and End Date for a module to control when it will appear in the Game Center. If you set a Start/End Date on the module level it will override any Start/End Date set on the Game and Reward level. Drag and Drop Modules You can move modules up or down the list of modules by pressing and holding down the hamburger icon and dragging the module in the list. This sorting will reflect on the Game Center view. Example: if you drag the same module to the bottom of the list the game module will now appear in the bottom of the game center.

Text Module The Text module is a great module if you want to add some text in-between modules, explaining e.g. a competition or campaign you are running. How to add a Text Module Click on Add Module and select Text Module from the popup Select module status and set a Start - and End Date (optional) to control when the module should appear in the Game Center Add a Text Header and Description text and style them.

Ad Module In the Ad module you can add an image to display an ad, highlight a campaign or just visually improve your Game Center. The image can be clickable and you can add any URL to the Ad image. How to set up an Add Click on 'Add Module' and select 'Ad Module' from the popup Select the status for the module through the Visible/Hidden toggle. As soon as the status is set to Visible, your players will be able to see it in the Game Center. Select if you want a Start - and/or End date to the Reward module to control when it will appear in the Game Center and for how long it should be available. Name your Module (optional) Select the Ad size you want. Either full width or half width Drag and drop the image you want to use. You find the recommended image size above the upload image box. Ad an external URL link (optional).

Redirection Links Who can use this feature: Admin, Manager Redirection links are a powerful tool for maintaining a single link while changing its destination as needed. For example, if you’re printing a QR code on product packaging, you won’t need to reprint the packaging every time you update the content. Instead, use a redirection link to keep the same QR code while seamlessly swapping out the linked game or URL whenever necessary. Redirection links aren’t limited to games—they can be used for any URL. You can even set up an automated schedule to change the destination at specific times, all with a simple one-time setup. How to create a redirection link: Navigate to Redirect Links in the menu. Click the 'Create New Link' button Enter a name for your URL. Avoid using spaces or special characters. The brand prefix can be edited under Assets & Settings. Select a game or input a custom URL as the destination. Optionally, set a start and end date to automate changes to the redirection link. Confirm your setup, and then copy and share the redirection link as needed.

Fonts Who can use this feature: Admin, Manager, Designer Upload custom fonts to be used when styling text for your Games and Game Centers. You can upload multiple fonts and apply them in text styling. How to upload Fonts: Navigate to Fonts in Assets and Settings through the mega menu. Click the 'Add New Font' button. Set a Font Name. This is the name that will be visible in all font dropdown across the platform. Upload a Regular and a Bold version of the Font. The Font needs to be in .otf or .ttf format. (optional) Select if you want the font to automatically be the default font in future settings. Click 'Add Font to Assets', the font is now available when styling texts. Your fonts will be available in all font dropdowns in Flarie Studio, e.g in general settings on Games and Game Centers.

Emails Who can use this feature: Admin, Manager, Designer The Emails feature allows you to set the default styling for your emails sent through the platform. These settings will automatically apply to all future Games, Game Centers, and emails created under your account, ensuring consistent branding across all emails. How to customize Email styling: Navigate to the Emails section under Assets & Settings in the menu. Update the email sender information to align with your brand, making it clear to recipients who the email is from. Adjust the text and button styles to match your brand’s design guidelines. Upload a header and footer image that reflect your brand identity, ensuring a cohesive and visually appealing email layout.

Form Parameters Who can use this feature: Admin, Manager In Form Parameters, you can create custom data points to use in forms that appear in Games and Game Centers. How to add a Form Parameter: Navigate to 'Form Parameters' in Assets & S'ettings'. Click 'Add Form Parameter' Button Set an Internal Name. This name will be used your Form settings in Data Collection and in Analytics. Once the name is set, it cannot be changed. Set the component type your question should have. You can select between Free Text, Dropdown, Radio Buttons or Checkbox. Depending on what component type you picked, fill in the description or answers the user can select from. (optional) Select if you want the form parameter to be automatically added to all data collection forms you create in the future. Click 'Save'. When creating forms and adding parameters in new Games and Game Centers, the Form Parameters you created will be in the list under the Internal Name you set.

Terms Who can use this feature: Admin, Manager When collecting user data it's important to have users agree to terms and conditions. In Brand Terms you can populate the terms and conditions text with terms important to your brand. This will apply to all future Games and Game Centers. How to add Brand Terms: Navigate to 'Assets & Settings' in the mega menu and then to 'Terms' in the side panel. In the 'Additional Terms and Conditions' text box add your terms and conditions, they will now be applied to all future Games and Game Centers.

Time Zone Who can use this feature: Admin, Manager Select the Time-Zone you wish to use as default in all time-sensitive settings across the platform. It can still be edited in the settings for individual Games, Game Centers and Receipt Solutions. How to set a time zone: Navigate to Assets & Settings in the mega menu and then to Time Zone in the side panel Select the Time Zone you wish to use in the dropdown. The selected Time Zone will be set as the default across the platform.

Userbase Emails How to send an email through user base: Scroll down past the graph to the User Base table (Optional) Use filters to select the specific users you want to email Click on the 'Send Email' button above the user list Fill in all information and upload email banners to personalize the email (optional) If you want the email to be sent at a certain date and time, you can use the date pickers to schedule a date and time when the email should be sent Click 'Create Email'. The email has now been sent/scheduled to send for the filtered user group. In the Email Table, you can view previously sent emails, duplicate created emails, and edit scheduled emails.

Analytics Who can use this feature: Admin, Manager, Analyst In the Analytics page you can view data of how all your created Games are performing. You can filter the data to be shown for a specific Game or Game Center or view the overall performance for all your Games within the selected dates in the Date Filter The data points that can be found are: Players: Amount of unique players/devices that have played the Game in total Returning players: The addition of daily unique players. Each player/device can be counted once per day Total time spent [H]: Total amount of active playtime in hours Time per player [Min]: Average active playtime by player in minutes Clicks: The amount of CTA clicks generated in the Game Total rounds: Total amount of Game Rounds finished Rounds per Player: Average amount of Game Rounds per player Game Loads: The amount of times the Game has loaded by players Unique Game loads: The unique amount of players/devices that has loaded the Game Completed Challenges: The amount of challenges completed by players in Game You can see the stats broken down per Game in the Game Table below the graph.

Organization Details Who can access this page: Admins The Organization Details page allows admins to manage key information about your organization. Completing this section is essential for activating games and ensuring your game terms are accurate. To access this page, navigate to 'Account' in the menu and then to the 'Organization Details' section in the platform settings to view or edit the fields. Some fields are mandatory and must be filled out before you can set any games to active: Organization Name: Enter the official name of your organization. Street Address, City, and Zip Code: Provide your organization’s address details. Country: Select the country your organization operates from. VAT Number: Add your VAT or tax identification number if applicable. Invoicing Email: Specify the email address for receiving invoices related to your account. Game Terms Contact Information The following fields will be automatically included in the Game Terms displayed to users and ensures compliance and provide transparency for your audience. Privacy Policy URL: Provide a link to your organization’s privacy policy URL for Questions Regarding Games or Competitions: Enter a URL where users can contact you for support related to games or competitions. Make sure all required fields are accurate, as they will impact your ability to activate Games. Once all fields are completed, click the 'Update Organization' button to save your changes. By keeping the Organization Details up to date, you’ll ensure that your games are properly configured and compliant with the necessary terms and policies.

Manage Brands Who Can use this feature: Admin, Manager The Brands section allows Admins and Managers to view, edit, and manage brands associated with an organization. Each organization can have multiple brands, and this section ensures that brand-specific details are correctly configured. To manage Brands, navigate to 'Accounts' in the menu and then to the 'Brands' section. Here, you will see a list of all the brands linked to your Organization. Each brand can be edited individually by clicking the icon on the right-hand side of the table. Brand Name: Update the name of the brand for identification. Address Details: Fill out the 'Street Address,' 'City,' 'Country,' and 'Zip Code' fields. These fields are required for specific brand operations, such as activating games or generating accurate game terms. 'Privacy Policy URL': Provide a link to the brand's privacy policy. This will automatically appear in the game terms for users. 'URL for General Questions': Add a URL where users can contact your team with questions about games or competitions. Brand Prefix: This prefix is used in your redirect links (e.g. game.flarie.com/rd/yourbrand/your_game_name). It must be between 1–25 characters and cannot contain spaces or special characters Brand Access: Assign specific users access to the brand by checking their names in the 'Brand Access' section. Only selected users will be able to manage and work on this brand.

License Plan In the license tab you are able to see what license plan you are currently using and the end date for your license. If you wish to renew or upgrade your License, simply click on 'Update License' and a notification is sent to our Customer Success team who will contact you to renew your current license, or find the best License Plan for you,

Documents & Agreements The Documents & Agreements page provides an overview of important documents related to your use of Flarie Studio. Here’s what you can do on this page: 1. View Documents This section displays a list of documents sent by Flarie that require your approval. For each document, you can see: The document title. The upload date. The approval status , including the approval date. These documents are essential for ensuring compliance and enabling the use of Flarie Studio. 2. Access Terms and Policies At the bottom of the page, you’ll find quick links to important policies: Terms of Use: Understand the rules and conditions for using Flarie Studio. Privacy Policy: Learn how your data is collected and used. Cookie Policy: Review details about how cookies are managed. Click on any link to view the respective policy.

Gamification Scenarios Who can use this feature: Admin, Manager Gamification involves incorporating Game mechanics into non-Game environments, such as products or services, to boost user engagement. For example, you can reward customers with a Gaming experience after completing a transaction or achieving another desired action. With Flarie Studio, you can design a variety of Gamification scenarios to enhance your service. Some scenarios integrate with the Game Center, while others are focused on individual Games. How to choose a gamification scenario Flarie Studio offers four Gamification scenarios that can be used individually or combined with other solutions: Attempts/Unlock games: Reward players with attempts in a Game when they complete a specific task, such as reaching a target score or performing an external action like a transaction. Adventure mode: Create a journey for players in the Game Center by unlocking Games and Rewards in a specific sequence, providing a structured and engaging progression. Coins Distribution: Give players coins as rewards for reaching a score in a Game or completing an external action. These coins can then be spent on Rewards in the Game Center. Unlock Reward: Set tasks for players to complete, such as reaching a target score, purchasing a Reward, or performing an external action, to unlock Rewards. These scenarios offer flexibility to tailor Gamification to your audience’s preferences, helping drive engagement and loyalty.

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 provides a detailed event breakdown for each Gamification scenario. It is designed to help you track and analyze how users interact with your gamified features, offering valuable insights to improve engagement and optimize performance. Navigate to the Gamification section in the menu and click on the "See Analytics" button to view this page. By default, the page displays data from the past month. You can adjust the date range at the top of the page to view analytics that match your specific needs. This flexibility allows you to track performance over different periods. Event Breakdown: Each Gamification event is listed on the page. Next to each event, you will see the total number of interactions or "sent events." Statistics Breakdown: To dive deeper into an event's data, expand the chevron (dropdown arrow) next to the event name. This reveals a detailed breakdown of statistics for that specific gamification scenario, helping you understand how users engage with each feature.

Game Module This module is where you connect Games to your Game Center. Make sure you have at least one Game, prepared and active, to connect. You can change the order the modules appear in the Game Center by dragging them up and down in the Module list. How to set up a Game Module Click on 'Add Module' and select 'Game Module' from the popup Select if you want the module to be Hidden or Visible Name your Module (optional) Set a Start - and End Date (optional) to control when it will appear in the Game Center and for how long. Keep in mind that if you have set a Start/End Date at the module level, it will override any Start/End Date set at the game level. Add a Title and Description text to the module and style to fit the Game Center How to add Games to the module Add Games to the module by clicking on the 'Add Games' button. The list will show all Games in your Games Library. Select the Games you want and click on 'Select'. You can add as many Games as you want to the module and all the Games you have selected will be added to the Games Table. The default status will be Hidden. The Games will be added to the Games Table. Click on Edit Settings on the Game in the table to open the popup for the settings for the specific Game. Select the status for the Game through the Visible/Hidden toggle. As soon as the status is set to Visible, your players will then be able to see it in the Game Center. Select if you want a Start - and/or End date to the Game to control when it will appear in the Game Center and for how long it should be available. Keep in mind that if you have set a Start/End Date at the module level, it will override any Start/End Date set at the Reward level. When an End Date has passed, the status is automatically changed to Hidden. Choose Game image size of the Game Image (full size or half size). Once you have set the size, you can upload an image that will represent the Game in the Game Center. The recommended image size will be visible above the file drop/upload box. Select if you want the game to have a Game Lock (optional). If you don't want it to be available to players straight away. This will add a lock icon and a countdown to when the Game will be unlocked. Select the number of days you want the countdown to last and upload an image if you want to replace the Game image during the countdown period. This is great for retention. If the user tries to play the Game during the locked period, a popup will appear. The text for the popup is set in the popup messages section Click on Save. You can change the order the Games appear in the module by dragging the Game up or down in the Game table. You can also edit the Game setup, change the status of the Game or delete the Game from the module by clicking on the '...' icon in the table.

Reward Module A reward is an item that your players can purchase in your Game Center with the currency they earn by playing Games in the Game Center. You can add any number of Rewards and they can be e.g discounts or digital and physical products How to set up a Reward Module Make sure you have 'wallet' activated in Game Center Header settings. Click on 'Add Module' and select Reward Module from the popup Name your Module (optional) Add a Text Header and Description text and style them (optional) Select the status for the Reward module through the Visible/Hidden toggle. As soon as the status is set to Visible, your players will be able to see it in the Game Center. Select if you want a Start - and/or End date to the Reward module to control when it will appear in the Game Center and for how long it should be available. Keep in mind that if you have set a Start/End Date at the module level, it will override any Start/End Date set at the Reward level. When an End Date has passed, the status is automatically changed to Hidden. How to set up a Reward: Click on 'Add Reward' Add a Text Header and Description text and style them (optional) Select the status for the Reward module through the Visible/Hidden toggle. As soon as the status is set to Visible, your players will be able to see it in the Game Center. Select if you want a Start - and/or End date to the Reward module to control when it will appear in the Game Center and for how long it should be available. Keep in mind that if you have set a Start/End Date at the module level, it will override any Start/End Date set at the Reward level. When an End Date has passed, the status is automatically changed to Hidden. Set an item description to the Reward that players can read before the Reward is purchased. Choose the size for the Reward Image. Sizes to choose between are full size and half size. Once you have set the size, you can upload an image that will represent the Reward in the Game Center. The recommended image size will be visible above the file drop/upload box. Set a Price for the Reward. The price determines how much the Reward will cost for players to purchase in the currency you have selected (e.g. coins). Select if you want the reward to have a cooldown period (optional), meaning a period when players are unable to purchase the same Reward more than once. Select the number of days you want the cooldown to last and upload an image to replace the Reward image during the cooldown period. If the user tries to buy the reward during the cooldown period, a popup will appear. The text for the popup is set in the popup messages section Select if you want the reward to have a Reward Lock (optional) if you don't want it to be available to players straight away. This will add a lock icon and a countdown to when the Reward will be unlocked. Select the number of days you want the countdown to last and upload an image if you want to replace the Reward image during the countdown period. This is great for retention. If the user tries to buy the reward during the locked period, a popup will appear. The text for the popup is set in the popup messages section Select a reward type that should trigger when the reward is purchased. You can read more about the different Reward types below. Add the needed information to the selected reward type, e.g a coupon code, if that is the selected Reward type Select if you want to set a limited stock or not for the reward. You will be able to keep track of the stock in the Rewards Table. Setup the text for the email that the reward is gonna be attached to. Email is always the distribution method for all Rewards. Save and its completed. You can change the order the Rewards appear in the module by dragging the Reward up or down in the Rewards table. You can also edit the Reward setup, see any uploaded coupons, change the status of the Reward or delete the Reward from the module by clicking on the '...' icon in the table. Reward Types All Rewards are distributed via email. The different Reward types available are Coupon Code - same for everyone: This reward type will distribute a generic coupon code for all players who buy the Reward. You can set the code to be distributed in the Coupon Code input field. Coupon Code - Unique for everyone: This Reward type enables you to upload a set of unique coupon codes to be distributed to the players who purchase the Reward. Add your unique codes in the input field, separated by a comma, and upload the codes. Make sure you upload enough codes to cover the purchases of the code. If they are all used up, new players won't be able to buy a code, as they are unique to each player. The codes can be viewed or edited from the Rewards Table in the module settings URL - Same for everyone: This reward type will create a CTA button in the Reward email with one generic destination for all purchases of the Reward. You can set the destination URL you want to use in the Destination URL input field. URL - Unique for everyone: This reward type will generate a CTA button that is unique for every player who purchases the Reward. You can upload an unlimited number of URLs, just make sure there are enough URLs for each player. If they are all used up, new players won't be able to gain a URL, as they are unique to each player who has purchased the Reward Form - Ask users for data: This Reward type will trigger a form where the players that have purchased the Reward will be able to fill in the form with the specific data parameters that you choose to set up. The data will then be added to the user’s ID and gathered in the User Base. This reward type is mainly used to gather addresses to send physical Rewards, such as merchandise. Reward Data In Game Center Reward data you can view the number of Rewards that have been distributed through the game center and how many unique players have claimed the Reward. Through the Reward table, there is also a list of the users that have claimed said Reward.

Wallet The Game Center enables users to collect currency for their account which they can in turn exchange for different rewards. Users collect currency by participating in different competitions and most commonly, playing games. The amount of currency that the users get is determined by the amount of points they score in the different games. By utilizing Gamification you can also allow users to earn coins in other ways, for example by reaching a score in a game or by performing an external action. To enable wallet and currency in your Game Center, simply activate the wallet by toggling the switch to ON. Add any image for your currency. You can also set a cooldown if you want limit how much currency you want a player to be able to earn each day.

Game Center A Game Center is like a digital arcade—a central hub where all your games and rewards come together in one place, making it easy for users to explore and engage. With a Game Center, you can gather your Games, set up a Reward store, and connect ads to external URLs to boost engagement and retention. By activating the Wallet feature, users can earn in-Game currency while playing, which they can spend on Rewards in the store you set up within the Game Center. This makes gameplay more interactive and encourages repeated visits. Game Centers can be used with any type of game setup and shared via a URL, QR code, or seamlessly integrated into an app, offering a flexible and engaging experience for your audience. General Settings This section controls the status, Start - and End Dates, as well as the general look and feel of your Game Center. Here you will find everything from background images and text styling. You will be able to decide the different backgrounds and colours as well. Game Center Status Game Center Status defines if a Game Center should be considered active or not. The status can be toggled between the following statuses: Active: This means that the Game Center counts as an active Game Center link. Game Centers also need to be active to work in Gamification scenarios and/or to send payloads if added to webhooks. Draft: The Game Center is currently only a draft and will be populated with banners notifying you that the game is still in draft mode. It is not counted as an active Game Center link. For licenses where Game Center is not included, the status will always be draft. Expired: This status will automatically appear if a Game Center has been populated with specific start and end dates. Once the Game Center passes the end date, the Game Center status is changed to Expired by the system.

Email Design This section determines the design of all emails that are sent out by the system, e.g Account Verification emails or Reward Emails. The user can add a top image and a bottom image, style text and buttons and specify what the sender of the e-mail should be. Set your email sender so that the user knows that you are the sender. The email sender will be defaulted to your brand name. Set the text and style of your email. You can use the Send Test Email function to send a preview of the mail that will be distributed to the players. Tips: In Assets & Settings → Email, you can set the email sender and style of email beforehand and save time on future Emails you create.

Data Collection & Login By activating the Data Collection & Login functionality you automatically add a login flow to your Game Center. This section dictates the styling and texts for the login - and registration flow for new and existing users. This is also where you will decide what type of information you want to collect from new users, as well as setting up your terms and conditions. The main thing that you will select in the Data Collection section is the type of player identifier that you want the Game Center to have. This is what identifies the users when they return to the Game Center. There are two available Identifiers: Different types of identifiers User Input: The user will provide information through a form. You will then set custom parameters deciding which information you wish to collect from the user. There are several different parameters available in the “+Add Parameters”-section URL Parameter: With this option, you can add player information to the game URL. Add the desired parameters below and append them to your URL. Example:https://your-game-url.com?{parameter}={your_value} You can also set custom parameters deciding which additional information, if any, you wish to collect from the user. There are several different parameters available in the “+Add Parameters”-section Select whether you want the parameter to be based on User input through a Form, or a URL parameter, which will be appended to your Game URL. Select one of the parameter types from the drop-down. If you have selected User Input”, make sure you add a descriptive name in the Input Field Text so that the player can easily understand what information to provide. (optional)If you have added custom parameters to your 'Brand Settings', they will also be available hereTo avoid forcing your users to fill out multiple forms or provide the same information multiple times we suggest you do not enable Data Collection in any of your Games and only use the User Base functionality in Game Center to identify players and collect user data. Proceed to set the texts for the login emails. The emails will follow the styling you have set up in 'Email Design' section or your 'Assets & Settings'. You can determine the text color and background color of the login flow, as well as add a logo if you wish. All texts for your login flow, as well as Terms texts, are available under Login Text

User Base Who can use this feature: Admin, Manager The User Base page provides a comprehensive overview of all User data collected from your Games and Game Centers. On this page, you can view the total number of users and track the number of new users added to the User Base. Additionally, you can access and filter user data based on various parameters or search for specific users. You can filter the data on Date, specific Games or Game Centers, or the parameters you have collected through your Games and Game Centers. All user data can be exported to a CSV file for further analysis or use in other applications. The User Base also includes a built-in "Send Email" feature. This allows you to send emails with various content to users who have opted in to receive marketing emails. You can choose to schedule emails for a later date or send them immediately.

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 Your API access key is required to authenticate with the Flarie API and should be included as the accessKey parameter in the payload. For webhook requests sent from Flarie, a Bearer token is included in the Authorization header, formatted as Bearer . While optional, verifying this token on your server adds a layer of security by confirming that the request originated from Flarie. How to create an API Access Key. Navigate to 'Access Keys' in the menu. Click on 'Generate Key' to generate a key. If an API Access Key has already been generated, generating a new one will invalidate the old key. API Secret Key Who can use this feature: Admin, Manager Your API secret key plays a crucial role in securing your webhook payload by generating a hash, ensuring the request originates from Flarie and remains unaltered. This hash, formulated as SHA-256 (payload + secretKey), is included in the headers under the X-Signature attribute, providing an added layer of verification and integrity protection. The Secret Key is optional. How to get an API Secret Key. Navigate to Access Keys by expanding the menu. Generate and copy the key to use it If an API Secret Key has already been generated, generating a new one will invalidate the old key.

Introduction to Webhooks in Flarie Studio Who can use this feature: Admin, Manager Flarie Studio’s Webhook feature gives you the power to respond to in-game events in real time and integrate seamlessly with your own systems. Whether you're triggering rewards, tracking engagement, or syncing player data to your analytics stack - webhooks make it easy and flexible. By configuring a webhook, Flarie Studio will automatically send event data to your specified endpoint whenever the conditions you’ve selected are met. You have full control over the events, the data structure, and how it connects to your games or rewards. To get started, we recommend reviewing the following: 🔐 Authentication — How to secure your webhook with Access Key and Secret Key 📦 Events & Payload — Explore available webhook triggers and payload formats 🛠️ GUIDE: Create your first webhook — Step-by-step instructions 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.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. Example: {"loading": {"progress": value}}; Parameter Type Description value int Progress of your loading, 0-100. 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. Receipt scan enables Gamification of receipts. By setting up the Receipts Scan, you can connect it to a Gamification scenario to incesitsise users to purchase a product, scan it with the receipt scan and then gain attempts or coins, depending on the Gamification scenario you have set up.Gamification of receipts is a great and fun way for the consumers to engage with your brand and products. How to setup a receipt scan? Make sure you have Gamification set up with at least one External Condition. Navigate to receipts in the navigation bar, if you don’t see it available it could be that the feature is not a included in your License Plan Click on 'Create New Receipt Scan'.In the 'General Settings' tab, set an internal name for the Receipt Scan. This will make it easier to identify in the table later. (Optional) Add a 'Start and End Date' for the Receipt Scan. Users will only be able to access it during the specified dates. Outside of these dates, the Receipt Scan will be unavailable. Define a 'Player Identifier' to ensure the system recognizes users across features. For Gamification to work properly, the same type of Identifier needs to be set on both features. Adjust the 'Style and Terms' of the Receipt Scan to align with your brand guidelines and specific needs. Add a Condition Go to the 'Condition' tab in the left navigation menu and click 'Add Condition'. In the 'Add Condition' popup: Select the currency you’re using. If your currency is not listed, contact Flarie for assistance. Set the 'minimum amount' the customer needs to spend. Choose a 'pre-made gamification scenario' to link the Receipt Scan to your campaign. 8. Navigate to the styling tab in the left navigation and adjust the styling to suit your brand. 9. Add Products Go to the 'Product' tab and click 'Add Products'. In the 'Add Product' popup: Add products either 'one at a time' or 'multiple products at once'. Provide an 'internal name' for the product to help recognize it in analytics. Include possible 'name variations' of the product as listed by stores (this ensures the scanner correctly identifies the product on receipts). 10. Add Stores Go to the 'Store' tab and click 'Add Store'. In the 'Add Store' popup: Add stores either 'one at a time' or 'multiple stores at once'. Enter store details manually, or follow the provided template to upload multiple stores in bulk. The system will then recognize these stores during receipt scanning. The receipt scan is now ready for distribution and you can copy the link to distribute the URL through QR-codes or social media etc.

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 tables shows all the people who have completed the competitions set up in your Game. The tables are only visible if you have activated settings within that specific competition (Challenge, Luck Based Winns, Winners & Prizes) Randomize Winners This functionality will enable you to manually generate winners from the users who have completed your challenge. By clicking the “Randomize Winners” button , you will get a pop-up where you are asked what terms you want to randomize and also to enter three different values. Once you have done this and generated your winners, you can download the CSV file which contains a list of your winners. Randomize by min. high score: Enables you to select winners based on their minimum high score. Randomize by probability (multi-entry): If you have toggled on the multi-entry, this enables you to randomly select winners based on probability rather than a minimum high score. Number of winners: Select the number of winners that you wish to generate Min points: The minimum number of points. Max points: The maximum number of points. The winners will be randomly selected from the players that qualify in the competition you have set up. Should you, for any reason, want to swop a randomized winner for some other player, you can click on 'Change' and the winner will be replaced by another player. Challenge Winners The table shows the the automatically generated winners based on the settings in your Challenge setup. You can search for a player, parameter or download the list as a CSV. Luck Based Winners The table shows the luck based winners determined by your settings in Luck Based Wins.You can search for a player, parameter or download the list as a CSV. Prizes Winners The table shows the luck based winners determined by your settings in Luck Based Wins.You can search for a player, parameter or download the list as a CSV.

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!