Creating achievements
Create an achievement to check if a customer has reached a defined target within a specified period of time.
You can create achievements in Talon.One via the Campaign Manager or via the Management API after you enable the achievements feature in your campaign.
To create an achievement:
-
On the left-side menu of your campaign, click Achievements > Create Achievement.
-
Select the type of achievement you want to create:
- One-time: The achievement can be completed only once.
- Recurring on expiration: The achievement resets after it expires and becomes available again.
-
Choose how the achievement starts, ends, or resets for your customers:
-
User action: The achievement ends or resets relative to when the customer started the achievement.
-
Fixed schedule: The achievement starts, ends, or resets for all customers following a fixed schedule.
Examples: Achievement types and activation policies
Achievement type Activation policy Achievement period Achievement start date User action Achievement end date One-time
User action
1 day
N/A
10 October 2023, 09:30:45
11 October 2023, 09:30:45
One-time
Fixed schedule
1 month
10 October 2023, 00:00:00
18 October 2023, 10:20:00
10 November 2023, 00:00:00
Recurring on expiration
User action
3 months, last day of the month
N/A
10 October 2023, 09:30:45
31 January 2024, 23:59:59
Recurring on expiration
Fixed schedule
2 years
1 January 2023, 00:00:00
12 August 2023, 14:15:02
1 January 2025, 00:00:00
-
-
In Achievement name, enter a display name for the achievement.
noteWhen the campaign is running or after a customer makes progress in the achievement, you can change only the Achievement name and Description.
-
In API name, type an identifier for the achievement. It can be used for integration purposes.
-
(Optional) In Description, enter a description to help you identify the achievement.
-
In Target, enter the target value the customer must reach to complete the achievement.
-
For one-time user-action achievements, in Achievement period, define the period after which the achievement ends for each customer.
tip- If you set the achievement period to
1 month
, for example, you can select the Last day of the month checkbox for the achievement to end of reset on the last day of the month at 23:59:59.
- If you set the achievement period to
-
For one-time fixed-schedule achievements, set the following options:
- In Achievement start, set the achievement start date for all customers in the campaign. Individually, the achievement for each customer starts when the customer makes their first progress.
- In Achievement end, set the achievement end date for all customers in the campaign.
-
For recurring user-action achievements, in Reset every, define the period after which the achievement ends and resets for each customer.
tip- If you set the achievement period to
1 month
, for example, you can select the Last day of the month checkbox for the achievement to end of reset on the last day of the month at 23:59:59.
- If you set the achievement period to
-
For recurring fixed-schedule achievements, set the following options:
- In Achievement start, set the achievement start date for all customers in the campaign. Individually, the achievement for each customer starts when the customer makes their first progress.
- In Reset every, define the period after which the achievement ends and resets for each customer relative to the achievement start.
- (Optional) In Achievement end, set the achievement end date for all customers in the campaign.
-
Click Create Achievement.