Steps activity challenge

Your workspace container app will rely on the Health API in order to collect data from your app users' devices' health apps, please contact SpotMe support should you need assistance in enabling this. On iOS devices, the Steps challenge will need to connect to the Health app, and on Android devices it will connect to the Health Connect app. Steps counted from any other fitness apps that are connected with the Health Connect  app are not counted.

- The steps activity challenge is not supported on devices using Android versions 7 and 8.
- For Android versions 9 to 13: When accessing the app, users will be prompted to install the Health Connect app and to allow the access permissions.
- For Android versions above 13: The Health Connect app should already be installed by default.

The Steps activity challenge can be used as part of the Activity challenge module, to award points to app users based on the number of steps they make over a determined period of time.

More specifically, the steps activity can be configured to reward a certain number of points, on an hourly or daily basis, over a specific period of time or for the entire duration of the event, for app users who have completed a certain number of steps.

Based on these variables, the system will count the steps each app user has made, and reward the points when the app user meets the requirements. App user points are updated every 10 minutes.

To configure a steps activity challenge, you'll need to install the Activity challenge module and create a challenge and an objective to which you will link the activity. More information is available on this in the Activity challenge overview article.

Configuring the Steps activity

For more general information on how activities work and are configured, please refer to the Activity-specific configuration article. Below, we'll focus on how to configure the Steps activity.

Go to the Activities tab in the Activity challenge module and click on New activity.

Select the Steps provider for the activity. The below options become available:

Enter the information for the activity as follows:

1. Choose a Name and some optional Content text for the activity. This will appear in the activity challenge app page, visible to the app user.
   
   
2. Enter the standard activity point counting information:
   How many points to earn per item done for this activity: By default should be set to "1". The value entered here will multiply the number of points specified in the Edit points per step options (this is rarely used).
   How many points earned when this activity has been completed: Amount of additional points to award when a user fully completes the activity.
   
   
3. Threshold: The number of times a user can complete the activity and earn the associated points. By default should be set to "1". 
   
   
4. Click on Choose period during which to allocate points to enter the start/end time and dates during which points can be earned for the activity.
   
   
5. In the Choose timeframe for points field, you will select how you would like to reward points for the activity. There are three options here:
   - Event duration: Points will be rewarded once for the activity period, based on a number of steps made during the whole event. This will use the event start and end dates:
   - Day: Points will be rewarded for the activity based on a number of steps made per day.
   - Hour: Points will be rewarded for the activity based on a number of steps made per hour.
   
   IMPORTANT: Please note that regarding steps 4 and 5 above, the system will only count steps (and request permission to use the devices Health API) when the app user's current time is within the timeframe set in the activity and within the event dates, and ONLY if no points are recorded already for the current time frame.
   
   
6. Click on the Edit points per steps field.
   
   In the above example, let's imagine that an attendee made 7'000 steps:
   (5) is the number of points that will be rewarded.
   (1000) is the number of steps the app users need to make during the previously selected time frame (per event, day, or hour) to earn the above mentioned (5) points.
   (1) is the number of times that the (5) points will be rewarded for each time the (1000) number of steps is completed.
   So for 7000 steps = (7000 / 1000) x 5 x 1 = 35 points.
   
   
7. Click Save to save the settings and the activity.

Note: Remember to link your activity to the objective, and the objective to the challenge, in the activity challenge module.

The activity will appear in the activity challenge app page, like in the example below:

Technical notes

• When using a per-hour timeframe for rewarding points, the activity duration must not exceed 10 days. When using a per-day timeframe for rewarding points, the activity duration must not exceed 48 days. 
• The steps activity challenge is not supported on the web app.
• Changing any parameter on a running activity will start to take effect as soon as the app user visits or re-opens the app.
• To activate the steps activity challenge in branded apps, please contact support or your account manager.
• iOS devices, the Steps challenge will need to connect to the Health app, and on Android devices it will connect to the Health Connect app. Steps counted from any other fitness apps that are connected with the Health Connect  app are not counted.
  • The steps activity challenge is not supported on devices using Android versions 7 and 8.
  • For Android versions 9 to 13: When accessing the app, users will be prompted to install the Health Connect app and to allow the access permissions.
  • For Android versions above 13: The Health Connect app should already be installed by default.
    Note for Samsung users: Should you encounter issues synchronizing data between Samsung Health and Health Connect we recommend trying to install Google Fit.