Summary

After reading the Activity challenge overview and configuration article, this article will provide specific instructions on how to configure the available activities or tasks that can make up a challenge.

There are many options available to choose from when it comes to associating tasks to an activity challenge. These are referred to as "providers" in Backstage, and after a brief overview of them this article will provide a detailed breakdown of the providers and how they work.

Providers overview

Activities are configured in the New/View activity tab, where you'll need to select a "provider" depending on the nature of the activity you wish to award points to app users for completing.

As a general rule, a challenge objective can be associated to one or multiple activities, and each activity can contain one or more items or tasks that app users can complete, within a certain time-frame, in order to earn points.

In some instances you'll need to create several activities that use the same provider type.

For example, in your Activity challenge you could create an objective solely based on feed interactions. This objective could contain a number of activities that all use the "Activity feed participation" provider. More information on this is available in the Activity feed participation section below. This approach can be used for any providers that have multiple options available.

Below we'll take a detailed look into the various providers that are available, and how they can be configured/used in your activity challenge.

Providers breakdown

The New/View activity tab is as follows, with the available list of providers that can be selected to the left:

Depending on the selected provider, the available settings will change. Below is a breakdown of the providers and their settings.

Important: Please rememnber that an activity challenge and the related objectives and activities will always be based on the event's timezone, not the app user's timezone.

Activated user

Reward points based on when the app users activate the app. For example to encourage app users to activate the app as soon as possible, by rewarding them points for activating by a certain date.

• Installed app before/after certain point
  Determine the period during which app users can earn points for activating the app.

Activity feed participation

Reward points for when the app users interact with the feed.

This provider has various different options available, that can be used to reward points based on the different possible interactions that app users can perform on a feed. This could be for writing a post, replying to a post, or liking something on a feed. For the posts, you can specify the post has to include a video or an image to earn the points.

We could therefore set-up multiple activities based on how the feed is used:

• A first activity that rewards a certain number of points for when users add a standard text post to a feed (no image or video).
• A second activity that rewards a certain number of points for posts that contain an image.
• A third activity that rewards a certain number of points for when users add a post that contains a video.
• A fourth activity that rewards a certain number of points for when users like a post.
• Etc.

• Choose your activity or points
  Select the single interaction that app users need to perform on the feed to earn the points. Only one interaction type can be selected per activity. If you'd like to award points for multiple interactions, you'll need to create multiple activities (one activity per interaction type).
  
  
• If post has a photo
  If the selected interaction implies writing a post, here you can specify whether the post must include a photo or not in order for the app users to earn the points.
  
  
• If post has a video (30 secs max)
  If the selected interaction implies writing a post, here you can specify whether the post must include a video or not in order for the app users to earn the points.
  
  
• Done before/after certain point in time
  Determine the period during which app users can earn points for this activity.

Note: If the selected rewarding activity is "write a post" select either "If post, has video" OR "If post, has image". If both are selected, both a video AND a picture need to be uploaded by the app user in order to earn the points

Attached frontstage form taken

This provider is used to award points for submitting a (frontstage) page or form that has form capabilities, but was not necessarily created through the Forms module. This can for example be participant matchmaking forms, or just session or sponsor pages where form functionality has been added to them.

To award points for a specific (frontstage) page or form submission, you must select the page or form that contains the form functionality. If you do not select a specific page or form, points will be awarded points for all submissions of (frontstage) page or form that have form capabilities.

Note: This activity provider cannot be linked to a profile page. For example, it cannot be linked to a user profile for questions such as "Tell us more about yourself by filling in your profile information. For this type of use case, we recommend that you use the User metadata populated activity instead.

Attendance (today called Session-check-in)

(Requires the Session check-in module to be installed.)

Reward points for when app users attend a session.

You can specify exactly what sessions you want to reward points for attendance, using the Any specific sessions attended field. You can choose to not reward points for attending specific sessions, using the Exclude these specific sessions field.

How many points to earn per item done for this activity
This is the number of times points will be earned for attending a session.

How many points earned when this activity has been completed? 
This is an additional number of points that can be rewarded once the attendee has reached the threshold (as specified below). For example if the user has attended 10 sessions (if 10 is entered in the "Threshold" field) in the activity.

Threshold
This is the maximum number of times that an item (attending a session) in the activity can be completed (and points earned). For example, entering 10 here means that an attendee can earn points for each session they attend, with a maximum of 10 sessions. The threshold that you select for the activity is very important, as it will limit the maximum number of points that can be earned for this activity.

Attendance taken before/after a point in time
You can specify a time range during which points can be rewarded for this activity, using the Attendance taken before/after a point in time fields:

Bookmark

Reward points for when app users bookmark content in the app. This could for example be used as part of a game that requires app users to bookmark all the pages in the app.

If so, the threshold that you select for the activity is very important, as it will limit the number of items in the app that can be bookmarked, and therefore limit the maximum number of points that can be earned for this activity.

• Bookmarked before/after certain time
  Determine the period during which app users can earn points for bookmarking content.

Business card exchange

Reward points for when app users exchange business cards with other app users.

• Total business cards exchanged before/after a certain time
  Determine the period during which app users can earn points for exchanging business cards.
  
  
• Only give points to person who was peer
  If you select this option the points will only be rewarded to the person the app user initiated contact with. The app user that initiated the connection will not receive points.

Correctly answered forms (use with quiz behavior)

Link a form (that used the quiz behavior) to an activity in your activity challenge, so that points are rewarded for when app users answer multiple choice questions in a form or quiz.

The following options are available:

How many points to earn per item done for this activity
This is the number of times points will be earned for answering questions in the quiz. This should be left at 1 if you only want to reward app users once per question. You can configure the number of points to be rewarded for questions in the form itself.

How many points earned when this activity has been completed
Here you can choose to reward the app user with more points for fully completing the activity (answering all questions) in the form.

Configuring question points of the form itself:

In the form linked to the Activity challenge, you can determine the number of points an app user will earn based on the answers they select for multiple choice questions. To do so, go to the linked form and in the multiple choice question configuration, then go to the Possible answers section, and enter numbers for the question based on the rules below:

Here, for this multiple choice question, the app user would earn:

• 3 points for selecting Advanced intelligence.
• 2 points for selecting Artificial intelligence.
• 1 point for selecting anonymous internet.
• 0 points for selecting Artificial insemination.

Threshold

To illustrate how the threshold works, let's imagine that you link this activity to a ten-question quiz, and reward 1 point per correctly answered question + an additional 2 points if the app user answers all the quiz questions correctly.

The threshold must be adapted to the total number of questions in the quiz. If the threshold is set to 1 in the activity, app users will receive the maximum points for the activity for answering any single question correctly.

If the threshold is set to 10, App users will receive the number of points entered in the How many points to earn per item done for this activity? field, or the points configured in the form itself, for each question answered in the quiz.

Form taken before/after a certain time
Determine the period during which app users can earn points for submitting correct answers to quiz questions.

Document viewed

Reward points for when app users open documents in the app. You can choose which specific document need to be opened in the app to earn points, or allow users to earn points for opening any documents.

Note: Users can only earn the allocated points for opening a specific document once. Opening the same document multiple times will not reward more points.

• Document viewed before/after a certain time
  Determine the period during which app users can earn points for viewing documents.
  
  
• Any specific document(s) viewed
  Here you can specify any specific documents that you want the app user to open in order to earn the points. If no document(s) is/are selected here, app user will earn points for any document(s) that they open (within the limits of the threshold).

LinkedIn

Reward points for when app users link their user profiles to their LinkedIn profiles.

• LinkedIn connected before/after a certain time
  Determine the period during which app users can earn points for this activity.
  

Live polling integration (for legacy polling only, not live session polling

You can link the activity challenge to a single polling session to encourage participation:

• When correct answers are configured in the poll: Points are rewarded for when app users answer all multiple choice questions in the poll correctly.
• When no correct answers are configured in the poll: Points are rewarded for when app users answer a multiple choice question poll.

Note: A single polling session must be selected for the activity. Only multiple choice questions can reward points.

Count voting before/after a certain time
Determine the period during which app users can earn points for this activity:

Live session claps

Link the activity challenge to either a single live session or all live sessions in the workspace, to encourage your audience to clap by rewarding points:

• Live session
  Select the specific live session where you wish to reward points for clapping. Alternatively, if you do not select a specific live session (i.e. leave the Live session field empty), then points will be rewarded for all live sessions present in the workspace.
  
  
• How many points to earn per item done for this activity?
  Enter a number of points to be rewarded each time an attendee claps.
  
  
• How many points earned when this activity has been completed?
  You can use this field to add additional points to be awarded once the participant has reached the specified threshold for the activity.
  
  
• Threshold
  If needed enter a threshold. This is the maximum number of times the points can be rewarded for participating in the Q&A, per participant.
  
  
• Award points for
  You can use this field to choose between two options:
  - Count the claps that were done during the actual live session and on the publish video replay
  OR
  - Count only the claps that were done during the actual live session.

Note: If you wish to link your activity to multiple specific live sessions, you will need to create an activity per individual live session. If you do not select a specific live session (i.e. leave the field empty), then points will be rewarded for all live sessions present in the workspace.

Live session Q&A

Link the activity challenge to either a single live session or all live sessions in the workspace, to encourage your audience to ask live session questions by rewarding points.

Points are rewarded for each Q&A question. Points can be rewarded for each Q&A participation within a live session, or for each Q&A participation within the workspace.

Follow the below steps to set up the activity:

• Live session
  Select the specific live session with the Q&A, to link it to the activity. Alternatively, if you do not select a specific live session (i.e. leave the Live session field empty), then points will be rewarded for all live sessions present in the workspace.
  
  
• How many points to earn per item done for this activity?
  Enter a number of points to be rewarded for each question posted in the Q&A.
  
  
• How many points earned when this activity has been completed?
  You can use this field to add additional points to be awarded once the participant has reached the specified threshold for the activity.
  
  
• Threshold
  If needed enter a threshold. This is the maximum number of times the points can be rewarded for participating in the Q&A, per participant.
  
  
• Specify a timeframe:
  You can also specify a time frame for when points will be rewarded, using the two "Count questions before/after a certain time" fields. By default, questions posted outside the duration of the live stream will be accounted for when rewarding points.

Note: If you wish to link your activity to multiple specific live sessions, you will need to create an activity per individual live session. If you do not select a specific live session (i.e. leave the field empty), then points will be rewarded for all live sessions present in the workspace.

Live session polls

Link the activity challenge to either a single live session or all live sessions in the workspace. Do this to encourage your audience to participate in live session polls by rewarding points.

Points are rewarded for each poll participation. Points can be rewarded for each poll participation within a live session, or for each poll participation within the workspace.

Follow the below steps to set up the activity:

• Live session
  Select the live session that contains the poll(s) that you wish to reward points for to the activity. Alternatively, if you do not select a specific live session (i.e. leave the Live session field empty), then points will be rewarded for all live sessions present in the workspace.
  Note: You cannot link the activity provider to a single poll within a live session. By linking a live session to the activity you will always reward points for all the polls that are launched in the live session and that attendees respond to.
  
  
• How many points to earn per item done for this activity?
  Enter a number of points to be awarded per poll participation. These points will be awarded for each poll participation.
  
  
• How many points earned when this activity has been completed?
  You can use this field to add additional points to be awarded once the participant has reached the specified threshold for the activity.
  
  
• Threshold
  If needed enter a threshold. This is the maximum number of times the points can be rewarded for participating in a poll, per participant.
  
  
• Award points for
  Using this field you can also specify whether to award points for any poll participation (so for all multiple choice and word cloud poll participations) OR for only correct answers to multiple choice polls. If only awarding points for correct answers, the attendee will only receive points for each correctly answered multiple choice poll. If nothing is selected in the "Award points for" dropdown, then points will be rewarded for all multiple choice and word cloud poll participations.

Note: If you wish to link your activity to multiple specific live sessions, you will need to create an activity per individual live session. If you do not select a specific live session (i.e. leave Live session field empty), then points will be rewarded for all live sessions present in the workspace.
You cannot link the activity provider to a single poll within a live session. By linking the activity to a live session you will reward points for all the polls that are launched in the live session. For example, if you have a live session with three polls and want to award points only for two of those polls, this is not possible - points will be awarded for all polls in the selected live session.

Messages sent (chat)

Reward points for when app users send messages to other app users via the chat in the app.

This could be used as a way to encourage your app users discover the chat functionality in the app, by rewarding them points for sending their first chat message. Make sure that you set a threshold to limit the number of points users can win.

• Total messages sent before/after a certain time
  Determine the period during which app users can earn points for this activity.

Notes taken

Reward points for when app users take notes via the app.

• Total notes taken before/after a certain time
  Determine the period during which app users can earn points for this activity.

Open frontstage page

Reward points for when app users open speaker, sponsor, or session pages in the app.

• Open frontstage page before/after a certain time
  Determine the period during which app users can earn points for this activity.
  
  
• Choose frontstage page type
  This is a mandatory field. Here you need to select what single type of page you will be rewarding app users for opening (speaker, sponsor, or session).
  If you would like to reward points for multiple types of pages, you will need to create multiple activities (one activity per page type).
  
  
• Choose speakers/sponsors/sessions
  Here, after choosing the frontstage page type (above option), you can select the specific pages (speaker, sponsor, or session) that you wish to reward points for when app user open them. You can choose one or multiple pages here.
  If nothing is selected here, users will receive points for each page they open (based on the page type selected previously).

Profile photo uploaded

Use this activity provider if you want to allow app users to earn points for uploading a profile picture.

Shortlinks scanned

Reward points for when app users scan QR code shortlinks via the app with their device. This could for example be used to create a scavenger hunt, where app users need to find hidden QR codes at the venue. You can also configure the specific QR codes or shortlinks that will reward points when they are scanned.

• Shortlinks scanned before/after a certain time
  Determine the period during which app users can earn points for this activity.
  
  
• Allow infinite scans
  Points will be awarded each time a QR code is scanned. The system will continues to award points even if same QR code scanned (until threshold is reached).
  
  
• Any specific shortlinks scanned
  Used to configure the specific codes that can reward points. Only codes defined here will reward points.

Steps

Reward users for the number of steps they take during an event. You can configure the activity to award points to app users who walk a certain number of steps in a given timeframe.

More information on configuring Steps in an activity challenge is available in the Steps article.

Submitted forms

Reward points for when app users submit form responses.

• Forms taken before/after a certain time
  Determine the period during which app users can earn points for this submitting forms.
  
  
• Any specific form(s) taken
  Here you can specify the form(s) that app users will be rewarded points for submitting responses to.
  
  
• Exclude these specific form(s)
  Here you can specify any forms that app users will not receive points for submitting responses to.
  
  
• Count each response
  Use this option to ensure that points are rewarded each time a form is submitted.

User metadata populated

Use this activity to reward points to app users for updating their personal information in their profiles:

• Take points from metadata (private fields only)
  This can for example be used for performing point adjustment en masse. To summarize, using this activity, you can:
  Step 1: Create a private "point_change" user metadata that will be exclusively used to adjust the activity challenge points. This metadata is invisible to the app users, so they won't see it in their profile.
  Step 2: You can then export the user list from Backstage, and populate the "point_change" column in the export for the users you wish to remove or add points to.
  For example, if you enter "-10" (i.e. a negative value) to the "point_change" column for a user, the users score would have -10 points. Likewise, if you enter "10" (i.e. a positive value) to the "point_change" column for the user, the user would receive +10 points.
  Step 3: Then re-upload the list to implement the point adjustment.

• Award points if metadata is populated (works with public, private or dynamic fields)
  You can use this field to determine whether, in addition to activating the app, the app user needs to populate a specific field in their profile in order to earn points for the activity.
  Example: You could create a "Expertise" public metadata field in the user's profile for your users to fill in to earn points. You can also specify multiple fields that need to be populated within the same activity to earn the points.

Technical notes

Please note that it can take up to 10 minutes for points to be displayed in the activities challenge page in the app.

The Leaderboard is by default updated every 20 minutes, but can also be updated anytime manually via Backstage.