Challenges

Challenges allows members to view and subscribe to all active challenges available to their segment(s), as well as see which challenges they're already participating in. Challenges also provides the roadmap of missions a member must accomplish in order to complete each challenge.

When the logged Member accesses the Experience Builder page where the Challenge component is at, they will be able to see all the Challenges from the Program that they are participating in. The Challenges are divided into two tabs:

• My Challenges - This one displays the Challenges that the Member is already taking part in. Moreover, if you enable the filtering and sorting options, Members will be able to filter the Challenges by status (scheduled, active, inactive and ended) and the start date, as well as sort them by Name. You can add more fields to filter and sort Challenges by; take a look in the section below to know-how.
• Available Challenges - This tab shows all the Challenges that the Member is not participating in, but in which they can enroll (i.e. that their segment applies to). Moreover, if you enable the filtering and sorting options, Members will be able to filter the Challenges by status (scheduled and active) and the start date, as well as sort them by Name. You can also choose which eligibility mode you want to be applied in the component. Find more details regarding these options in the section below.

The Available Challenges tab will display Global and Opt-In Challenges in which the member has not yet participated or enrolled. Challenges show up in My Challenges only when the member has enrolled or begun participating.

👍

Note that the Member will be able to keep track of all the Challenges in which they are participating or have participated in - regardless of their status - using the filters in the My Challenges tab, whereas Available Challenges shows only the Challenges that have not started yet or that are active, but the member is not yet participating in.

The member can also check the challenge's missions by clicking on the View Challenge button and, then, accessing the Missions tab. From there, they can check the mission's description and period, as well as its leaderboard (if it applies) and their progress.

The leaderboard shows members how they’re performing on the Mission compared to their fellow participants. It is great for fostering competition among members and increasing engagement in the Challenge.

The leaderboard will display the members who are in the first three positions plus the member who is viewing the component - and their current position - if they are not among the top three.

• Example A: when the logged member is in the top 3, only 3 members appear.
• Example B: when the logged member is in the 10th position in the mission, there will be 4 members displayed. The top 3 members + the logged member ranked as 10th place.

Configuring Challenges

Once you've added Member Selector and Challenges to your page, you can customize what data is shown and how it is shown.

Challenges can be configured via the following properties:

• Title: Enter the title you want displayed at the top of the component.
• Subtitle: Enter the subtitle to be displayed below the title.
• Layout Style: Leave this setting at Card for an optimized UI experience or switch to None if you plan to customize the component using CSS.
• Layout: Choose Table to display challenges in list format or Grid to display them in tile format. Don't worry, your members will be able to toggle back and forth between the views.
• # of Columns (Grid Only): Choose the number of columns you want to be displayed in grid layout.
  - Challenge Fields: Enter the API names of the fields you want to include in the challenge list, separated by commas.
• Challenge Detail Fields: Enter the API names of the fields you want to be displayed in challenge detail views, separated by commas.
• Eligibility mode: Choose which Challenges the member will be able to see in the Available Tab. On some of them, a Eligibility requirement link will appear, instead of Enroll. Further set up must be done while creating or editing a Challenge.
  • Apply: allows the member to see a list of the Challenges that uses segments they apply to and also the ones that they are enrolled on. This is the standard.
  • Not Apply: will list the Challenges with segments that the member doesn't apply to and also shows the Eligibility requirements link, which will open a dashboard (Progress view option) or message (Description View option) detailing which actions they need to accomplish in order to participate in the Challenge.
  • All: will show a Eligibility picklist that allows the logged member to filter by the Challenges they apply to the segment or not.
• Enable Filtering: Check this box to allow members to filter their challenges.
  • Filter Fields: If filtering is enabled, enter the API names of the fields you want members to be able to filter challenges by.
• Enable Sorting: Check this box to allow members to sort challenges.
  • Sort By Fields: If sorting is enabled, enter the API names of the fields you want members to be able to sort by, separated by commas.
• Show Missions: Check this box to display missions in challenge detail views.
  • Mission Fields: If showing missions, enter the API names of the mission fields you want to be displayed in challenge detail views, separated by commas.
• Show Mission Progress: Check this box to show members how they're doing on their missions. This only applies to missions that have a fixed objective.
• Show Mission Leaderboard: Check this box to display the leaderboard for each mission that has one.
  • Leaderboard Layout: Leave this setting at Card for an optimized UI experience or switch to None if you plan to customize the component using CSS.
  • Leaderboard Fields: If showing leaderboards, enter the API names of the fields you want to include on them, separated by commas.
  • Enable Leaderboard Paging: Check this box to allow leaderboard entries to be displayed in pages.
  • # of Leaderboard Entries per Page: If leaderboard paging is enabled, enter the maximum number of entries you want to be displayed on a single page.

🚧

Eligibility

It is possible to use the Eligibility option other than with Challenges or Program Promotions. This can be done using the Lightning Web Component ccEligibility. Find more information about it in Developers Hub's FieloPLT.ChallengeService Class.