CompetitionLabs Academy

Step 2: Achievement scheduling

Step 2: Achievement scheduling

Scheduling controls when an Achievement is available and how often a player can get it.

SCHEDULING fields

EXAMPLES

» Availability DateTime

Mandatory

Available from (date/time) – Select the date (day/month/year) and time (hour: minute) in UTC time when the Achievement will become available for players to receive.

Optional

Available until (date/time) – Select the date (day/month/year) and time (hour: minute) in UTC time when the Achievement will become unavailable to players. This field can be left empty if an Achievement is on-going.
» Occurrence Enum

Mandatory

How many times, or when, an Achievement can be received.

Possible options:

  • Once – an Achievement is triggered only once
  • Repeatedly – an Achievement is triggered every time the conditions are met
  • On these days – an Achievement is triggered once every weekday, e.g. on Mondays. You can pick one or more weekdays (e.g. on Mondays and Fridays)
» Limit Total Issue Count Integer

Mandatory

Sets the maximum number of times this Achievement can be issued across all players. Once the limit is reached, no additional instances are issued. Enter 0 to apply no total limit.
» Limit Issue Count Per Member Integer

Mandatory

Sets the maximum number of times an individual player can earn this Achievement. This limit applies when the Achievement occurrence is set to Repeatedly. Enter 0 to apply no limit per player.
» Allow Repeated Opt-In Boolean

Mandatory

When selected, the opt-in endpoint used for the promotion can create multiple opt-in events. Leave this option unselected to use the default opt-in behaviour.

APP Example:

Achievement available from12/09/2018, 10:17 am UTC
Achievement available untilN/A
Members can achieveOnce

API Example:

{
    "jsonClass": "Achievement",
    ...
    "scheduling": {

    "scheduleType": "Once",
    "every": [],
    "startDate": "2018-09-12T10:17:36.172+02:00",
    "onlyAggregateOnActiveDays": false
    },
    ...
}

The API example provides only a simplified version of the POST body. A full example of POST Achievement can be found in the Achievements APP API documentation here.

MISSING ENTRIES
If any mandatory fields are missing, the field is shown in red as in the example below.

Step 2: Achievement scheduling

PREVIOUS – Click Previous and go back to the previous step.

CONTINUE – Click Next and continue to the next step.

Cookie Settings

We use cookies to keep the site working, understand usage, and improve relevance. Read our Cookie Policy and Privacy Policy.