Challenges

Overview

Loyalty Challenges let you engage Members by challenging them to perform some action or activity on behalf of your brand. The platform supports a variety of Challenge types:

Submit Content: Submit Member-generated content, such as photo, video, or a caption .
Surveys: Quiz or survey Members with multiple questions.
Member Updates: Ask Members to update their Profile and Preferences.
Custom Challenges: Create your brand-specific Challenge by entering a custom JSON definition.

Access

To access the Challenges screen, select Challenges from the Main Navigation Menu. By default, Challenges is selected from the Sub-Category menu.

Features

Working with Challenges

The Challenges screen provides the following features:

Searching and Sorting

Click hereClick here

Search

The search feature allows you to search for a specified text string anywhere within the following Challenge fields: display name, internal name, category label, category name, or tag.

Optionally, in the search field near the top of the Challenges screen, enter the desired text string.
Optionally, from the "Status" drop-down menu, select a Challenge status (or "Any status").
Optionally, from the "Effectivity" drop-down menu, select a Challenge effectivity (or "Any effectivity").
Press Enter, or click the search button (magnifying glass icon).
The Challenges screen is refreshed to show only the Challenges that meet your search criteria. Please note that if you enter multiple search conditions, the platform displays only the Challenges that meet ALL criteria..
To remove all search criteria, click the remove button ("X" icon).

Sort

The "Sort" drop-down menu allows you to sort the Challenges on a variety of different fields. To sort the list of Challenges, select the desired sort option from this menu.

Name (the default option)
Created Date
Updated Date
Prize Amount
Total Responses
Total Points
Rank

Navigation

Once you've found the desired Challenge, you can navigate to the following other screens:

Click a Challenge to navigate to the Challenge Details screen.

Create a New Challenge

Click hereClick here

To create a new Challenge:

In the "Enter Display Name" field, enter the Display Name value for the new Challenge.
Click create. The "Edit Challenge" pop-up window is displayed.
The "Display Name" field is populated with the value you entered above in step 1; optionally edit this value.
The "Internal Name" is automatically populated based on the "Display Name" value. This field is disabled by default. To edit the Internal Name, check the "Edit Internal Name" check box. A confirmation dialog box is displayed; click ok. Edit the Internal Name value.
In the "Description" field, enter a description of the Challenge.
From the "Type" drop-down menu, select the Challenge type. The Challenge types are organized into categories, such as a "Submit Content" or "Social Media," for example.
To assign an image to this Challenge, click choose file. Browse to and select an image file, and click open.
If this Challenge has a prize associated with it, enter the number of points, and select the point metric to use. Optionally check auto approve if you want the prize to be awarded automatically without manual approval.
In the "Rank" field, enter a ranking for this Challenge.
In the "Categories" field, assign one or more Categories to this Challenge. Categories are used to organize Loyalty assets into groups. For more details, please see Challenge Categories.
In the "Tags" field, assign one or more Tags to this Challenge. Tags are used to help search, filter, and organize Loyalty assets within the platform (Tags are never visible to Members).
In the "Tracking Code" field, specify a value to track clicks to a Challenge when you share the Challenge's URL on external channels such as email or Facebook. Loyalty adds this Tracking Code to the Challenge URL.

Note: The Tracking Code is not used for tracking for Members logged into Marigold Loyalty apps.

Click save.

View or Edit a Challenge

Click hereClick here

To view or edit the details of a Challenge:

Search, sort, or filter the Challenges screen as described above.
Click on the desired Challenge.
The Challenge Details screen is displayed and populated with all of the information about this Challenge. See Challenge Details for more information.

Member Preview

Click hereClick here

To view a list of Challenges for which a specific Member is eligible:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Member Preview." The "Preview Eligible Contents for a Member" pop-up window is displayed.
In the Member field, begin typing the Member's name, then select the desired Member from the menu.
Click fetch contents.
The platform displays a list of all the Challenges for which this Member is eligible. Technical details regarding the search process are displayed beneath the "What Transpired" heading.
To view a Challenge, click on it. The Challenge Details screen is displayed.

Exporting Challenge Data

The Challenges screen provides the following features related to exporting Challenge records.

Create Export Definition

Click hereClick here

Export definitions can optionally be saved and reused, when you need to download Challenges from the Loyalty platform:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Export Challenges." The "Create New Export - Challenges" pop-up window is displayed.

Timing

Select when you want to execute the export:

Asynchronous -- check this option if you want to execute the export manually on an ad hoc basis.
Execute now -- check this option if you want to execute the export immediately.
Create schedule -- check this option if you want to define a schedule (either a one-off execution, or a recurring schedule).

If you checked "Create schedule" above, the schedule options are displayed.

Define Export ScheduleDefine Export Schedule

To define the export schedule:

From the "Recurrence" drop-down menu, select an option:

Repeat -- Execute the export based on the defined schedule; see below for more details.
Once -- Execute the export once. In the "Execute once on" field, enter the date and time. Select the time zone from the "Time Zone" drop-down menu.
On demand -- Execute the export when specified by a user. In the "Execute once on" field, enter the date and time. From the "Time Zone" drop-down menu, select the time zone to use.

Define a Repeating Schedule

From the "Schedule Composer" drop-down menu, select a unit of time -- every minute, hour, day, week, month, or year.
Optionally, check "Advanced" to enable the "CRON expression" text field, and enter a custom CRON expression.
In the "From" and "To" field, enter the start date and time, and the end date and time, for the repeating schedule.
From the "Time Zone" drop-down menu, select the time zone to use.

Notification and Transport

If you checked "Asynchronous" above, this section is displayed.

To send email notifications when the import process is successful, enter one or more email addresses in the "Success Email Recipients" text field.
To send email notifications if the import encounters an error, enter one or more email addresses in the "Error Email Recipients" text field.

Fields

This section allows you to optionally include (or exclude) specific columns in the export file.

From the "Inclusion" drop-down menu, select an option:

All -- include all columns in the export file.
Only Included -- in the "Fields" field, select one or more columns you want to include in the export file.
Except selected -- in the "Fields" field, select one or more columns you want to exclude from the export file.

To include attachments in the export, select the desired attachment from the "Attachments" drop-down menu.
Optionally check include attachment url to include the attachment's URL.

Rules

This section allows you to create custom business rules to define which Segments are included in the export file.

Click the Add icon, then select Add Rule. The platform adds a new blank row for defining the Rule Condition.
From the first drop-down menu, select the desired Attributes. This menu is populated with all of the different Attributes for building a condition.
Select a mathematical operator. The available operators will vary based on the data type of the selected Attribute.
Enter or select a value.
Some attribute types allow you to define additional criteria, such as a date range, or a channel type, for example. Select or enter the additional criteria.
Repeat the above steps as needed to define more Rule Conditions. If you need to delete a Rule Condition, click the Delete icon to it.
Once you define more than one Rule Condition, select the logical operator. From the "Include customers that meet" drop-down menu, select either:

All of the following: The conditions are processed with a logical 'AND' operator such that all conditions must be true for an individual to be selected by this Segment.
Some of the following: The conditions are processed with a logical 'OR' operator such that at least one of the conditions must be true for an individual to be selected by this Segment.

You can also group rules by selecting Add Rule Group from the Add icon. Rule Groups have their own internal logical operator.

Associations

To export associated records:

Click add. A new row is displayed.
Check Enabled.
From the "Association" drop-down menu, select the type of associated record.
From the "Inclusion" drop-down menu, select an option:

All -- include all columns in the export file.
Only Included -- in the "Fields" field, select one or more columns you want to include in the export file.
Except selected -- in the "Fields" field, select one or more columns you want to exclude from the export file.

Repeat the above steps needed to include more associated records. To remove an association, click the delete icon next to it.

Children

To export child records joined to the main record:

Click add. A new row is displayed.
Check "Enabled."
From the "Child" drop-down menu, select a child record type.
From the "Inclusion" drop-down menu, select an option:

All -- include all columns in the export file.
Only Included -- in the "Fields" field, select one or more columns you want to include in the export file.
Except selected -- in the "Fields" field, select one or more columns you want to exclude from the export file.

Repeat the above steps needed to include more associated records. To remove an association, click the delete icon next to it.

Finish

When finished creating the Export Definition, click save.

View or Edit an Export Definition

Click hereClick here

To view or edit a Challenge Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Challenges Exports." The "Challenges Export Definitions" pop-up window is displayed and populated with a list of all Challenges Export Definitions.
From the "Action" column of the desired Export Definition, click the Edit icon. The "Edit Export" pop-up window is displayed.
Make any necessary changes to the Export Definition properties.
When finished, click save.

Manually Execute an Export Definition

Click hereClick here

To manually execute a Challenge Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Challenges Exports." The "Challenges Export Definitions" pop-up window is displayed and populated with a list of all Challenges Export Definitions.
From the "Action" column of the desired Export Definition, click the Enqueue this Export icon. A confirmation dialog box is displayed.
Click confirm.

Download an Export Definition

Click hereClick here

To download the last execution of an Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Challenges Exports." The "Challenges Export Definitions" pop-up window is displayed and populated with a list of all Challenges Export Definitions.
In the "Action" column of the desired Export Definition, click the Download File icon. The platform downloads the file to your PC.

Delete an Export Definition

Click hereClick here

To delete a Challenge Export Definition:

From the "Actions" drop-down menu in the top-right corner of the screen, select "Challenges Exports." The "Challenges Export Definitions" pop-up window is displayed and populated with a list of all Challenges Export Definitions.
From the "Action" column of the desired Export Definition, click the Delete icon. A confirmation dialog box is displayed.
Click confirm.

Back to Challenges Overview

Last Updated: October 2024