Create advanced or multi-event reactors using Audiences

Introduction

Using audiences and reactors together can be a powerful tool when it comes to engaging the end-users of your loyalty program. By incentivising specific behaviour with extra rewards you can help to ensure the success of your program.

The exact configuration used depends on whether you are wanting to simply reward multiple instances of the same event type or reward different event types when completed together. You can also include non-event based criteria, such as profile data, in the logic to only reward users who meet very specific criteria.

1. Multiple instances of the same event type.

Overview

In this tutorial we'll create an audience and reactor setup which gives end-users double points when they make their third purchase in a specific month. We'll be setting up four elements to create the full campaign.

• The custom event type - this is the event the campaign will be based on.

• The base reactor - this is the standard amount of points a user gets for making a purchase.

• The bonus eligible audience - this tracks which users are eligible for the bonus points.

• The bonus reactor - this awards the user the bonus points. It works in addition to the base reactor.

Event setup

1. Navigate to Events > Types. Click 'Create' in the top right corner.

2. Call the new event PURCHASE_COMPLETED and give it a description. Leave 'Active', 'Is private' and 'Omit from user activity' as they are. Add the 'Audience Enhancer'.

3. Move to the schema tab. Replace the empty schema with the following.

   Copy

   {
     "type": "object",
     "$schema": "http://json-schema.org/draft-06/schema#",
     "required": [],
     "properties": {
       "amount": {
         "type": "number",
         "title": "Transaction Value"
       }
     }
   }

4. Click 'Save'.

Base reactor setup

1. Navigate to Events > Reactors. Click 'Create' in the top right corner.

2. Give the reactor a name and choose PURCHASE_COMPLETED from the 'Event trigger' list.

3. Under 'Reactions' tab click the + icon to add a new block. Choose Adjust Points and then select 'Amount' from the variables list.

4. Click Save.

Audience setup

1. Navigate to Users > Audiences. Click 'Create' in the top right corner.

2. Give the audience a name and description. Leave AUDIENCE_JOINED and AUDIENCE LEFT events toggled off. Set the refresh rate to 'Reactive'.

3. Move to the criteria tab and click 'Add Group'.

4. Set the audience criteria as follows:

   • Event type is PURCHASE_COMPLETED

   • Event occurrence count is 2.

   • Reported at between from 01/10/24 00:00 to 31/10/24 23:59

5. Click Save.

Bonus reactor setup

1. Navigate to Events > Reactors. Click 'Create in the top right corner.

2. Give the reactor a name and choose PURCHASE_COMPLETED from the 'Event trigger' list.

3. Set the start date to 01/10/24 00:00 and the end date to 31/10/24 23:59.

4. Set the activation limit to 1 per subject.

5. Under 'Payload Conditions' click the + icon to add a new block. Select 'User In Audience(s)' and choose the audience you made in the previous step.

6. Under 'Reactions' tab click the + icon to add a new block. Choose Adjust Points and then select 'Amount' from the variables list.

7. Click Save.

Testing the configuration

1. Navigate to Events > Activity. Click 'Report Activity' in the top right corner.

2. Select PURCHASE_COMPLETED from the 'Event Type' list. Select any user from the 'User' list.

3. Put any numeric value in the 'Transaction Value' field of the payload section. Click 'Save'

4. Repeat Steps 1 - 3 two more times, making sure you select the same user each time.

5. After the third event being recorded click the 'Reactions' tab on the event details page. You should see that double points have been awarded, with both the base and bonus reactions having been triggered.

2. Multiple instances of different event types

Overview

This example covers tracking different event types together. We'll create a scenario in which users get 100 bonus points for making a purchase, tagging on social media and leaving a review in October 2024. You could also include non-event based criteria in the Audience.

Audience setup

1. Navigate to Users > Audiences. Click 'Create' in the top right corner.

2. Give the audience a name and description. Turn AUDIENCE_JOINED events on. AUDIENCE LEFT events can be turned on or off depending on your needs. Set the refresh rate to 'Reactive'.

3. Move to the criteria tab and click 'Add Group'.

4. Set the criteria of this group as follows:

   • Event type is PURCHASE_COMPLETED

   • Event occurrence count is greater than 0

   • Reported at between from 01/10/24 00:00 to 31/10/24 23:59

5. Click the top 'Add Group' again to create a second top level group. Set the criteria of this group as follows:

   • Event type is MENTIONED_YOU_SOCIAL

   • Event occurrence count is greater than 0

   • Reported at between from 01/10/24 00:00 to 31/10/24 23:59

6. Click the top 'Add Group' again to create a third top level group. Set the criteria of this group as follows:

   • Event type is LEFT_A_REVIEW

   • Event occurrence count is greater than 0

   • Reported at between from 01/10/24 00:00 to 31/10/24 23:59

7. Click Save.

Reactor Setup

1. Navigate to Events > Reactors. Click 'Create' in the top right corner.

2. Give the reactor a name and choose AUDIENCE_JOINED from the 'Event trigger' list.

3. Set the start date to 01/10/24 00:00 and the end date to 31/10/24 23:59. Activation limit can be left as unlimited.

4. Under 'Payload Conditions' click the + icon to add a new block. Select 'Specific Audience Joined' and choose the audience you made in the previous step.

5. Under 'Reactions' click the + icon to add a new block. Choose 'Adjust Points' and enter 100 in the points value field. Click Confirm.

6. Click Save.