Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

This feature is currently in a test phase and is not yet available to configure and start using. This documentation will be updated when it is ready to activate.

Note that this documentation is under construction and will be adjusted.

Table of Contents
stylenone

Introduction

The Loyalty program is designed to engage your customers to adopt a frequent workout habit and try more of your available offerings. In the long term this will make your customers more loyal to your business and brand.

By incorporating gamification elements, such as challenges, rewards, and achievements, we create an interactive environment that motivates and inspires users to achieve their fitness goals.

Product brochure

Hiddenfragment macro
groupVisibilitybrponly
note

BRP Only documentation

Link to BRP Internal Loyalty training session

Link to Loyalty Sales Material

Link to training sessions/webinars with pilot customer’s staff (360 & Endorfin)

Link to a public view of the Loyalty backlog -here you can see planned development

How does BRP Loyalty work?

The Loyalty program is like a game in the Mobility app, where members can “level up” by going to the gym and attending classes. Each level offers various benefits to boost and enhance their motivation.

Members can also earn Coins by completing Streaks and Achievements and use these Coins to purchase different rewards, such as a water bottle or PT-session. Streaks are achieved by regularly going to the gym or attending classes, for example visit the gym at least once for 5 consecutive weeks.

Achievements are “badges” which the member will get from achieving specific goals. It could be attending a specific class a certain number of times or working out during the summer months. And who knows, maybe some hidden achievements will appear if they continue to be consistent?

Prerequisites

  • The BRP Mobility app is required

  • BRP Loyalty license is required

Panel
panelIconId1fa99
panelIcon:coin:
panelIconText🪙
bgColor#E6FCFF

If you are interested in getting started with a Loyalty program in your app: reach out to your BRP Sales representative or Customer Success Manager for more information on how to begin!

Configuration

Pre-requisites app and facility setup in BRP

App configuration

All facilities where a member should earn points, coins and collect workout or class streak needs to be added to the app in the App configuration.

image-20241119-134756.pngImage Added

Facility configuration

Facilties which should be included in the app needs to have “Show in API” checked.

image-20241119-135221.pngImage Added

Settings

Setting

Value

Activate Loyalty in the Mobility app

(useLoyalty)

Yes

This setting needs to be activated by BRP Staff

Hiddenfragment macro
groupVisibilitybrponly
note

BRP only documentation
Cloud Operations needs to activate the Loyalty feature as well from their end. To start up and onboard a customer, you must request this activation from Cloud Operations. Without this step, the connection to the Loyalty platform GWEN will not be established. Simply activating the "useLoyalty" setting in BRP Cloud as BRP Staff is not sufficient.

When you start the configuration inform Jonatan at Insertcoin by emailing him at jonathan@insertcoin.se. In the email write that “ We have now started the configuration for Loyalty for customer xxxx.”

BRP only documentation
Cloud Operations needs to activate the Loyalty feature as well from their end. To start up and onboard a customer, you must request this activation from Cloud Operations. Without this step, the connection to the Loyalty platform GWEN will not be established. Simply activating the "useLoyalty" setting in BRP Cloud as BRP Staff is not sufficient.

When you start the configuration inform Jonatan at Insertcoin by emailing him at jonathan@insertcoin.se. In the email write that “ We have now started the configuration for Loyalty for customer xxxx.”

Rights

Enable these rights on the roles of those who will configure or make changes to Loyalty:

  • Loyalty - General configuration

  • People - Mass change personal data

Enable this right on the roles of those who later on should be able to view statistics related to Loyalty.

  • Loyalty - View statistics

Readers & Passages

Make sure that the readers are configured correctly: the only readers that should be configured as Type: Out are readers to exit the facility. Verify this for each facility in BRP Configuration > Settings > Readers.

image-20240514-122057.png

This is important so that members does not get several passages registered when they are moving inside the facility. The loyalty points and coins a customer earns are partially based on visits.

In BRP Configuration > Settings > Scheduling there is a schedule called Automatically check out visits where you can set the amount of minutes where a member should be automatically checked out after they have made a visit. This means that members can get a new visit registered after the amount of minutes where they automatically gets checked out, according to this setting.

Create a Loyalty program

Follow this guide step by step to create your Loyalty program.

Note that only BRP staff can create or delete Loyalty programs.Once it has been created, further configuration can be done and adjusted by you.

Hiddenfragment macro
groupVisibilitybrponly
:BRP:8a26f413-22bd-468c-833e-b9641c3f691d:BRP:#EAE6FF

BRP Only documentation

As BRP staff, when you create a Loyalty Program for a customer, you will need to fill in certain fields under 'Base Information'. Note that not all 'Base Information' fields are editable by the customer. The mandatory fields must be completed by you in order to be able to save/create the Loyalty program. Once you have entered the required information and saved/created the Loyalty Program, the customer can continue with their configuration.

A loyalty program is created by clicking on '+' in BRP Configuration → Web and app → Loyalty program.
There are 7 tabs with configuration to go through. In each tab you will configure the different mechanics of the Loyalty program:

  • Achievements - This includes the “badges” the user will get from achieving specific goals.

  • Levels - This includes the different levels the user will progress through by being an active member.

  • Rewards - This includes the rewards the user will be able to trade in after collecting “Coins”. Coins will be given to the user by completing achievements and streaks.

  • Streaks - This includes the challenges the user will meet from doing something consistently, e.g. visit the gym at least once for 5 consecutive weeks.

If you change the standard names of the mechanica, you’ll have to add your translations for them.

Note that translations of the standard names exist for all app supported languages, so you do not have to translate them from English to ex. Swedish, Danish, Norwegian etc. This is managed automatically. Only if you change the default names, you’ll have to also add translations.

1. Base information

BRP Configuration → Web and app → Loyalty program → ‘Base Information’ tab

  • Name
    Enter the title of your loyalty program in one or more languages. This is the name that will be visible to members in the app.

  • Enable loyalty in the mobility app for

    • Set the option to “Disabled” until everything is configured.

  • Person group

    • When later enabling the Loyalty program: this can be done for a certain Product Group
      (ex: selected staff for initial tests)

  • Gwen product ID (non editable field)

    • When creating the Loyalty program, the program will get an ID which will be displayed here.
      Gwen is the loyalty program platform which is connected to BRP.

  • Gwen product name

    • Enter a “product name” for the Loyalty program. This is not displayed anywhere in the app or in BRP, except here in the field in the Base Information tab.

In the <Add some text here>, add a text which, for example, contains the Customer Name or their name of their Loyalty Program.

BRP Only documentation
The 'Gwen product name” is the name that will be displayed in the GWEN framework for the BRP Loyalty program. The pre-filled text in this field is: “[Customer Setup] <number> - <--Add some text here-->”

image-20240628-131543.png

In the <Add some text here>, add a text which, for example, contains the Customer Name or their name of their Loyalty Program.

Hiddenfragment macro
groupVisibilitybrponly
note

BRP Only documentation
The 'Gwen product name” is the name that will be displayed in the GWEN framework for the BRP Loyalty program. The pre-filled text in this field is: “[Customer Setup] <number> - <--Add some text here-->”

image-20240628-131543.png

Example

  • Template Setup

    • There is currently one template available: [Template] Classes setup. Select that one.

  • Languages

    • The languages for which the Loyalty program will be maintained in. If a language is added here, the Loyalty texts needs to be maintained for that language. The fallback language will be displayed for any languages which does not have translation support.

  • Fallback language

    • In a scenario where the member/app user is having their phone locale set to a locale which is not a supported/maintained language: texts will defualt to this language as “fallback”. English is suggested for this purpose.

image-20240607-121107.png

2. Achievements

BRP Configuration → Web and apps → Loyalty programs → 'Achievements' tab

  • If you would like to call ‘Achievements’ something else: you can add your own name here.

  • If you change the standard name, you’ll have to add translations for it as well. The name will be displayed in the app for the users.

  • Click on the pen to add translations to other languages, if desired.

image-20240607-112335.png

The different achievements are predefined and these cannot be changed or added by configuration in BRP.

Members will see the achievements in the app in the ‘Achievements’ section for the Loyalty program.

On top of this, there are a few “hidden achievements”, which are not known for the member in advance.
A few examples of these are (but there are more!):

  • “Where is Santa?”
    A member visiting a facility on December 24 earns this achievement

  • “Happy new year!”
    A member visiting a facility on December 31 earns this achievement

  • “Kettlebell King”
    A member attending 5 Kettlebell classes earns this achievement

  • “Yoga Yogi”
    A member attending 5 Yoga classes earns this achievement

  • “High-intensity Hero”
    A member attending 5 High-intensity training classes earns this achievement

achievements-portrait.png

3. Levels

  • If you decided to call Levels something else, enter the new name under “Title”.

  • Enter a title description and a description.

  • Leave “Info text” and “Info url” blank, this will be added at a later step.

image-20240305-065825.png

image-20240305-065601.png

  • Click on a level and enter the perks (benefits) the customer will get from the different levels. Every new line in the level perks description is presented as a bullet in the app.


    Note! You cannot create or remove levels, but you can change the level perks that the customer gets.

Every new line in the level perks description is presented as a bullet in the app.

Code Block
10 new achievements
Bring a friend 5 times per year
5% discount on PT services
10% off in our shop
image-20240305-063707.png

Some examples of what you can provide as level perks:

  • Discounts on products

    • x % discount a PT/massage/etc booking

    • x % discount on protein powder

    • x % discount on a yearly subscription

  • Free products

    • X free PT/massage/sauna bookings

  • X guest visits to give to a friend

  • X weekly/monthly subscriptions to give away to a friend

  • Free coffee

Rights for loyalty levels

A right can be used to let the customer

  • Get discounts, based on a price list.

  • Book classes they could normally not book

  • Book classes or before anyone else, or cancel them later than anyone else.

  • Enter additional doors or facilities, or enter at extended hours.

Limitations:

🔅 Unlike a subscription, which can be on a specific facility, the loyalty program is on a system level. The rights used for levels should have the property “Access” set to “All facilities”. If another value is selected, it will be ignored.

🔅 It is only possible to create rights for levels higher than Start-level at the moment. It will be possible to create rights connected to the Start level in the future.

Create rights and connect them to your loyalty progresson levels. When a member reaches a level, they will get the benefits of the level through this right.

Note that level benefits which are not managed through the rights needs to be managed manually.

4. Rewards

Before proceeding with the Reward configuration in this tab you should create Value cards for the Reward Shop.

Customers will gain coins by completing Achievements and Streaks, and can use those coins to buy different rewards in the reward shop. These rewards come in the form of Product value cards which will be added to the customer when bought.

4.1 Create Value Cards for the Reward Shop

BRP Configuration → Products → Products

  • Create a product group specific for the Loyalty value cards, so you can easily find them later. This is done in BRP Configuration > Products > Product groups.

  • Create the value cards:

    • The name should be linked to the actual reward the customer will get, e.g. “Energy drink”.

    • Add the product group created for Loyalty.

    • Add an account.
      Note! The VAT group for the value card has to be the same as the products you will add to the value card.

    • Do not add a price to the value card.

    • Choose and enter the validity length of the value card. Our recommendation is that the value cards expire within a couple of weeks (1-3 weeks) from the date of purchasing. This way, you will limit the accumulation of debt from reward-related value cards and you will have better control of the size of the total debt derived from reward-related value card.

    • Set “Type of value card” to Product, and add the product/s that the customer should be able to get with the value card. Items, services, entrances and subscriptions are the possible products to connect to value cards in BRP and use as rewards.

    • Add the facilities to which the value card should work.

  • Repeat the previous steps to create one value card for each reward you would like to offer. We recommend that you create 10-15 value cards (rewards).

Now go back to the 'Rewards' tab in the Loyalty program configuration.


4.2 Configure Rewards and add Rewards Items in the Rewards Tab

BRP Configuration → Web and apps → Loyalty programs → Rewards Tab

  • Enable the reward shop in the mobility app in order to display the Reward Shop in the Loyalty Program

  • Limit access to users of subscription based on subscription products with this product label (TP61297/GA2024.41)

    • You can restrict access to the full Loyalty program based on specific subscription products by using a product label. Here, you can select a product label, which will grant full access to the Loyalty program only to those with matching subscription products (TP61297/GA2024.41).

    • Members without a subscription product with this label will still see the Loyalty program in the app, but they won’t be able to shop in the reward store or enjoy the level perks.

    • This setting is optional. If you want all subscription products to have full access to the Loyalty program, no action is needed here.

  • Fill in a Monthly value gain goal, if you’d like. This is an optional field.

    • The Monthly value gain goal is in your local currency (ex. SEK/NOK/DKK). The value should be “how much you would like to spend per member per month on rewards”.

    • This value will help you set a coin price that corresponds to the currency value of a product, when you are adding rewards.

    • If a Monthly value gain goal is entered, when adding a reward, you will instead of a coin value enter the estimated currency value for the reward and you will get a Calculated coin value to assist you when setting the price for the reward in coins. All in all: you will get assistance converting currency price to coin price for a reward in your shop.

  • If you decided to call Rewards something else, enter the new name under “Title”.

  • Enter a Short description, Title for the description and Description.

image-20241106-161557.pngRewardConfig2-20240603-141405.PNG

  • Click on (plus) in “Reward shop” to add the value cards you created in a previous step.

    • Enter a title (name) and description in one or more languages for the reward. Both the name and the desciption will be visible for members in the shop in the app.

    • Choose a category of the reward.

    • Enter the value card product created in the previous step for the reward.

    • Set a price (the amount of earned coins needed to redeem this reward).

      • Value of reward: enter a price for the rewards in your currency.

        After filling in a price in “Value of reward”, a “Suggested price in coins” will be proposed (if you have filled in a value in Monthly value gain goal) based on the the Monthly value gain goal and The average monthly coin gain. The average monthly coin gain is set by BRP and nothing that can be configured.

      • Price in coins: the amount of earned coins needed to “buy” this reward

    • Set User purchase limit.
      This is the amount of items allowed per member. The time span for which this amount is allowed is set in the below field: User cooldown days.

    • Set User cooldown days.
      This is the time period for which a member is allowed to collect an item.

      Example: if a member should be allowed to collect a smoothie from the reward shop once a week and maxium 10 smoothies: set User purchase limit to 10 and User cooldown in days to 7.

      (The user can claim the same reward again exactly one week later, on the same day and at the same time.)

    • Pick an icon for the reward (the image/icon that will be displayed in the app for this reward).

    • Set “Status” to LIVE.
      If you want to prepare Rewards that you would not like to be available immidealtely in the Rewards Shop, you can set the status to “DRAFT” instead.

image-20240924-071058.png

Coin Value and Accounting

  • The recommended starting coin value is 0.1 SEK/NOK/DKK or 0.01 EUR. The accounts balancing for streaks and achievements is based on said value.

  • Earned coins are recorded in the accounting as a liability (debt) to customers.

5. Streaks

  • If you decided to call Streaks something else, enter the new name under “Title”.

6. Other - add content to the “About” page

Loyalty program → “Other” tab

This information is used in a guide that will be shown for the members first time they open the app, after you have activated the loyalty program in BRP for the members.

  • Fill out the information in one or more languages.

image-20240422-064536.png

7. Notifications

You can setup notifications to the Loyalty program users in the Notifications tab. These are disabled by default.

image-20240607-110030.png

Achievements -Almost there (push)
When the user has completed 90% of what is needed to get an achievement, they will receive a push message in their phone.

Achievements - Congratulations (email)
When the user has completed an achievement, they will receive an e-mail message.

Streaks - Almost there (push)
When the user need one more visit/workout or class attendance this week to reach a streak goal, they will receive a push message in their phone.

Streaks - Congratulations (email)
When the user has reached a streak goal, they will receive an e-mail message.

Level - Congratulations (email)
When the user reaches a new level, they will receive an e-mail message.

E-mail -and push messages are only sent to users who have given consent for mass email/push.

There are default messages templates set up for the above messages, but it is possible to customize the messages being sent out. The message templates are found in BRP Configuration > Messages > search for ‘Loyalty’ and you will find the relevant message templates prefixed with ‘Loyalty’.

image-20240826-113654.png

8. Refer a friend

Loyalty program → “Refer a friend” tab

Hiddenfragment macro
groupVisibilitybrponly
note

BRP Only Documentation

  • Refer a friend must be activated by a setting:
    TEMP_TOGGLE_EnableReferAFriend (during the pilot) // TP56226 (2024.41)

  • A manual sync to GWEN is also needed in order to start sending events.
    This is done via BRP Configuration > Web and Apps > Apps > Select the App > Sync to Gwen Integration Service.
    (We plan to automate this manual sync in TP64765, though it has not yet been scheduled for release.)

BRP Only Documentation

  • Refer a friend must be activated by a setting:
    TEMP_TOGGLE_EnableReferAFriend (during the pilot) // TP56226 (2024.41)

  • A manual sync to GWEN is also needed in order to start sending events.
    This is done via BRP Configuration > Web and Apps > Apps > Select the App > Sync to Gwen Integration Service.
    (We plan to automate this manual sync in TP64765, though it has not yet been scheduled for release.)

Let your customers refer their friends and get a reward when their friends sign up and become members. When activated, users will be able to share a unique referral link from the app to their friends and family.

  • Enable “refer a friend” in the mobility app in order to display the referral link in the Loyalty Program.

  • Enter a title and description in one or more languages.

  • Choose which web category the friend will be redirected to through the link.

  • Enter a “Default message when sharing the referral link”. This is the message that will be sent together with the link when a user shares their link.

  • Select a Lead Source (optional). A lead source is a label that later on will help if you want to keep track of how new customers are acquired.

    • Create a lead source in BRP Configuration > Persons > Lead sources.

image-20240918-150028.png

Terms and conditions for referring or taking part of a referral offer

Before sharing the referral link to someone else, the member will have the option to read terms and conditions for referring someone. Similarly, if a person wants to take part of a referral offer, they will get the option to read terms and conditions for signing up through a referral.

Create message templates for these texts. It is recommended to highlight the coin reward for the referring member and emphasize any special offer the friend will receive upon signing up (if applicable).

BRP Configuration → Settings → Messages

  • Conditions when referring

  • Conditions for taking part of a referral offer

referafriend.png

unnamed (18)-portrait.png

Reward for a referral

For each successful referral where a friend purchases a subscription using the referral link, the referrer will be rewarded with 5000 coins. Additionally, they will unlock a tiered achievement, earning an extra 50 coins for the 1st, 5th, 10th and 15th successful referral.

Info

Note: In a future BRP release, the reward will be configurable in BRP, allowing you to set the number of coins awarded after a successful referral.

It is recommended to offer a reward equivalent to approximately 10% of the subscription value that the referred friend signs up for. This motivates and encourages users to actively recruit new members.

In a future BRP release, it will also be possible to set a reward for the referred friend, which they will receive after purchasing a subscription via the referral link.

Great! Now all configuration tabs are completed. See below information for the remaining configuration needed in BRP Cloud.

Set a “Class type” for all class products

BRP Configuration → Products → Products

  • On every class product, select the correct class type on the “Class” tab. This is necessary so that the user can get the right achievements when for example attending five cycle, yoga or dance classes.


    Note! You can add “Class type” to many products at once. Mark the products you want to add a specific Class type to > click on “Change rows” > click on Class type and choose one that fits the marked classes.

image-20240416-092650.png

Create an info page on your website

We recommend that you create a page on your website specifically for your new Loyalty program, to inform and promote this to your customers. This page can be linked to from the app. If you are using our GoActive! website - add an “information” web category with this information and set the URL to your GoActive! web start page (it is not possible to direkt link to a web category).

Click here to navigate to a template with example text and images.

Once you have created an info page, enter the URL of that page to “Info url” under your Loyalty program → Levels.

image-20240305-065825.png

image-20240305-065601.png

Connect the Loyalty Program to one or more apps

BRP Configuration → Web and apps → Apps

When you have created the loyalty program, connect it to an app.

  1. Click on your app and select your program under “Loyalty program”.

  2. Click on Save. The connection has now been done.

image-20240524-091950.png

Test the functionality

Before enabling the loyalty features in the app for all users, start by testing with only staff, and then move on to a small group of customers. Verify that you are happy with the texts and content in the different sections of the Loyalty program: the level perks for each level, the reward shop and the “About” section.

Test run with staff

After letting your staff test the program and everything is working as intended, we recommend that you let a small group of users test it before you launch it for everyone.

  • On your Loyalty program → Base information, change Disabled to “Enable for staff only”.

image-20240422-074110.png

Test run with limited users

  • Create a person group for the people that will test loyalty in the app (BRP Configuration → Persons → Person groups)

  • Add the people who should test the program to the same person group

    • Select one or more persons in the person list (Back Office > Persons)

    • Add them to the person group all at once using Tools > Add group

  • On your Loyalty program → Base information, change “Enable for staff only” to “Enable for person group” and add the person group. Now, everyone within that person group will see your Loyalty program in the app.

Activate the Loyalty Program

When all testing is done, it is time to activate your Loyalty program for everyone.

  • On your Loyalty program → Base information, change “Enable for person group” to “Enable for all”.

Loyalty statistics

Users with the right Loyalty - View statistics on their role can view statistics of members' achievements, rewards, reward coins and levels in BRP Back Office.

Achievements

Backoffice > Statistics > Web & app > Loyalty achievements
Overview of the number of members who have reached each achievement.

Rewards

Backoffice > Statistics > Web & app > Loyalty rewards
Overview of claimed rewards.

Reward coins

Backoffice > Statistics > Web & app > Loyalty reward coins
Overview of the total coins spent and earned by members, along with the overall balance, representing the "coin debt" owed to all members.

Levels

Backoffice > Statistics > Web & app > Loyalty levels
Overview of the number of members who have reached each level.

Search for persons with a certain Loyalty level

TP60247/GA2024.32

In BRP Back Office > Persons, it is possible to search on persons with a certain Loyalty Level.

This makes it possible to filter out and list members based on which Loyalty level they have reached.

image-20240826-112357.png

The Loyalty level will also be visible as a badge on the Person card for each person: (TP60869/GA2024.32)
The badge will be displayed when a person reaches a level above 'Start', such as Bronze, Silver, Gold, or Elite. A Start-level basge will not be displayed.

image-20240826-113048.png

Search for persons who has been recruited (Refer a friend)

TP56226/GA2024.32

In BRP Back Office > Subscriptions, it is possible to search on:

  • All who has been recruited

  • Persons who has been recruited by a specific member

Click on ‘Advanced selection’ → choose ‘Subscription. You will find ‘Recruiter’ and 'Has recruiter’ in the list.

image-20240924-131239.png

Click on the images to expand.

image-20240924-131250.png


Loyalty setup checklist

Step

(tick)

Necessary settings and rights are activated

Base information & Loyalty concept names added

Class types are added to classes

Rewards (value cards) for the reward shop are created

Level perks are added

Texts to the ‘About page’ are added

An info page on your website are created (optional!) and link added to it

The loyalty program is connected to one or more apps

The Loyalty program is tested with a limited set of users

The Loyalty program is activated for all members


Loyalty program maintenance

Updating facilities for an app

If you are adding more facilities to get access to your BRP app, you need to connect this facility to the Loyaly program. This is done in BRP Configuration > Web and apps > Apps > Select the app > click on “Sync to Gwen Integration Service”. (Gwen is the Loyalty program platform which BRP is connected to)

image-20240524-122642.png

Loyalty FAQ

Hiddenfragment macro
groupVisibilitybrponly
note

BRP Only documentation

The following steps needs to be done by BRP Staff:

  • Activating Loyalty in the Mobility app -by enabling the setting useLoyalty

  • Creating a Loyalty Program - in BRP Configuration > Web & App > Loyalty Programs > click on ‘+' and fill in the required Base Information > press ‘Save’

  • Deleting a Loyalty program - in BRP Configuration > Web & App > Loyalty Programs > mark the checkbox for the Loyalty program to delete and click on the trash can/‘Delete’

BRP Only documentation

The following steps needs to be done by BRP Staff:

  • Activating Loyalty in the Mobility app -by enabling the setting useLoyalty

  • Creating a Loyalty Program - in BRP Configuration > Web & App > Loyalty Programs > click on ‘+' and fill in the required Base Information > press ‘Save’

  • Deleting a Loyalty program - in BRP Configuration > Web & App > Loyalty Programs > mark the checkbox for the Loyalty program to delete and click on the trash can/‘Delete’