The table below summarises the four types of events and where you can view them.

Custom CDP Events

After loyalty is enabled on your project, all configured events under Data Manager are available for use in the Loyalty Hub. These are the primary events you use as in your loyalty solution to trigger reward rules, quests, and perks.

To view these events, go to the Custom Events Sent by You in the Event Trigger section when you configure any reward rule, quest, or perk.

📘

The list of the Custom CDP events can only be viewed under Data Manager >Events. There is no dedicated tab in the Loyalty Hub to view the list of these events.

Internal Events

Internal Events are pre-set events within the Loyalty hub that are triggered when users interact with your loyalty widget. For example, ACHIEVEMENT REWARD CLAIMED or QUEST STARTED.

These events appear in the Loyalty Hub under Events > Internal Events. You cannot edit these events or add new internal events.

When you configure a reward rule, quest, or perk, these events are available under Internal Events in the Event Trigger section.

Following is the list of internal events and when they’re triggered:

Scheduled Events

In the Loyalty Hub, you can create scheduled events that trigger at a specific time frame that you define. These timestamp events that the same payload:

"day": (number) 
"dayOfweek": (number)
"dayOfyear": (number)
"hour": (number)
"month": (number)
"timezone": (string)
"unixTimestamp": (number)
"weekOfyear": (number)
"year": (number)
"type": (string)
"eventId": (string)
"namespace": (string)
"userId": (string)

To create these events go to Events > Scheduled Events. You must use a CRON expression to define the event schedule.

Use these events in scenarios where you want to automate user attribute changes using reward rules. Some example include:

• A weekly scheduled event that is used as a trigger for a reward rule. This reward rule resets the weekly_bets attribute for all users to 0.
• A monthly scheduled event that is used as a trigger for a reward rule. This reward rule sets the user_activity status to low for all users with a total_quest_completed attribute of less than 10.

To view these events when you configure a reward rule, quest, or perk, go to the under Scheduled Events section when selecting an Event Trigger.

User Attribute Events

In the Loyalty Hub, events are generated when a user’s attribute value changes. These value changes are recorded in the All Users tab for each user profile.

All User Attribute events have the same following payload:

"new": (boolean)
"previousValue": (string/boolean/number/Array<string>)
"value": (string/boolean/number/Array<string>)
"dataType": (string)
"eventId": (string)
"namespace": (string)
"userID": (string)

The previousValue field indicates the former value of the attribute, while the value field indicates the new attribute value.

You can view user attribute events under Loyalty Hub > Events > Attributes.

You can use these events to trigger a reward rule, quest, or perk. For example, you might use a change in an account_verification attribute to trigger a reward rule. When the status changes from unverified to verified, a reward rule is triggered where a user receives 100 tokens.

These events are listed under Attribute Events when you configure a reward rule, quest, or perk.