Transfer loyalty points between customers

Published May 05, 2022

Modules

Difficulty

Selected Clients

Industry

Rewards and loyalty points can and do build customers’ loyalty as well as they can create some value by motivating new customers to try a product or service. By adding more functionalities, like loyalty points transfers between customers, your mobile app may appear more user-friendly and can help you acquire new customers.

In this use case, you will learn how to integrate the mechanism of loyalty points transfer in your mobile application. For better user experience, it will be enriched with mobile push notification for the recipient of points.

Prerequisites

Integrate mechanism for awarding loyalty points.
For example, you can award loyalty points after transaction. In such case, create an expression that counts how many loyalty points are assigned to a customer for a transaction. Once you prepare the expression, please contact Support Team to configure materialization of loyalty points. After such configuration, every time loyalty points are assigned to a customer, the points.loyalty event will be generated in a customer’s profile with information about the number of loyalty points they received after a transaction (the points parameter).

Tip: Learn more about events here.
Implement mobile pushes in your mobile application: iOS, Android.

Security configuration

Before you start working with this module, if you are a Synerise customer or partner, consider reading the section about denylisting events. This natively accessible configuration will allow you to manage the restrictions in points management that may help you prevent fraud.

Process

In this use case, you will go through the following steps:

Configure loyalty points transfer.
1. Define segmentations of senders to group customers who are allowed to make a transfer.
2. Define segmentations of recipients to group customers who are allowed to receive a transfer.
3. Define an expression with points balance to calculate how many loyalty points the customer currently owns.
4. Complete configuration.
Implement loyalty points transfer module in the mobile app.
Create a mobile push template.
Create a workflow.

Configure loyalty points transfer

Define segmentations of senders

In this part of the process, create a segmentation or segmentations of people who can transfer loyalty points. In our case, we select people who made at least one transaction.

Go to Analytics > Segmentations > New segmentation.
Enter the name of segmentation.
From the Choose filter dropdown list, select the transaction.charge event.
Using the date picker in the lower-right corner, set the time range to Lifetime.
Confirm the settings by clicking Save.
Important: The conditions used in the segmentation may vary depending on your business needs and loyalty program assumptions.

An example of a customer segmentation of senders

Define segmentations of recipients

In this process, create a segmentation or segmentations of people who can receive loyalty points from other customers. In our case, we select people who received less than 2 transfers during last 24 hours.

Go to Analytics > Segmentations > New segmentation.
Enter the name of segmentation.
From the Choose filter dropdown list, select the points.received event.
Click Add funnel step.
From the dropdown list, select the points.received event.
Using the date picker in the lower-right corner, set the time range to Last 24 hours.
Change the Contacts matching funnel expression to Contacts not matching funnel by clicking the matching word.

Important: The conditions used in the segmentation may vary depending on your business needs and loyalty program assumptions.

An example of a customer segmentation of recipients

Define an expression with points balance

In this part of the process, create an expression which will be used to calculate points balance for the customer. First, we will create the aggregates based on the following events:

points.loyalty (event that is sent every time the customer is awarded with loyalty points),
points.received (it is sent when a customer receives points from someone),
points.sent (it is sent when the customer sends points to someone).
Based on the aggregates, we will create the expression that calculates the loyalty points for every customer.

Define 3 aggregates that sum points from the events mentioned above.
1. Go to Analytics > Aggregates > New aggregate.
2. Enter a meaningful name of the aggregate.
3. Set the Aggregate option to Sum.
4. Click the Choose event dropdown list.
5. From the dropdown list, select the points.loyalty event.
6. From the second dropdown list, select points parameter.
7. Using the date picker in the lower-right corner, set the time range to Lifetime.
The aggregate that sums points from event points.loyalty
1. Save the aggregate.
2. Repeat steps 1-8 for points.received and points.sent event.
Create an expression using the aggregates created in step 1.
1. Go to Analytics > Expressions > New expression.
2. Enter a meaningful name of the expression.
3. Leave the expression type at default (Attribute).
4. Build the formula of the expression.
  1. Click the Select node.
  2. From the dropdown list, select Customer.
  3. Click the unnamed node that appeared on the canvas.
  4. Scroll down the page and click Choose attribute.
  5. On the dropdown list select the aggegate for points.loyalty that you created in step 1.
  6. Next to the aggregate added to the canvas, click the plus button.
  7. Repeat steps from 1 to 6 for the aggregates with points.received and points.sent.
  8. Click the mathematical operator between points.loyalty and points.received node and select the brackets icon.
  9. Click the mathematical operator between points.received and points.sent node and select the subtraction icon.
  The configuration of the expression
5. Save the expression.

Complete configuration

In this part of the process, you must complete the points transfer settings by executing configuration method. To define transferSettings, use analysis created in the following steps:

Define segmentations of senders,
Define segmentations of recipients and
Create an expression that calculates loyalty points.
In order to execute request, you can use Postman or similar tool.

Implement loyalty points transfer module in the mobile app

In this part of the process, implement the loyalty points module in your mobile app that enables a user to transfer their points. Use the points transfer method when the transfer is sent. This method automatically generates the points.received event on the profile of customer who received points and the points.sent event on the profile of customer who sent points.

Create a mobile push template

In this part of the process, create a mobile push template that will be used later in a workflow. It should inform a mobile app user that they just received points transfer from someone.

Go to Communication > Mobile > Templates.
Create your mobile push in the code editor.

For more information on creating a simple mobile push, visit our User Guide.

Create a workflow

In this part of the process, prepare a workflow that will be triggered by receiving points transfer from someone and will send push notification for the customer who received them.

Go to Automation > Workflows > New workflow.
Enter the name of the workflow.
As the first node of the workflow, add Profile Event. In the node settings:
1. From the Choose event dropdown menu, select points.received event.
2. Confirm by clicking Apply.
As the next node, add Send Mobile Push. In the configuration of the node:
1. Define the Template type.
2. Select the Push template created in this step of the process.
3. Confirm by clicking Apply.
Add the End node to finish the workflow.
Click Save & Run.

Final configuration of a workflow that is triggered by receiving points transfer from someone and sends push notification for the customer

Inserts
Mobile campaigns
[Workflow]](/docs/automation/)