Customer Events are various actions performed by contacts that capture their financial and marketing interactions. Customer events are processed by CRM.COM and are consumed for segmenting and rewarding contacts based on their actions. They also provide valuable analytics, and can even help facilitate payment flows.

There are several ways to create Customer Events:

Via an external integration system using CRM.COM’s Web APIs.
Automatically, through CRM.COM’s Automations when an event is performed.
Manually, by a system user through the CRM.COM back-end system.

THE ESSENTIALS

CRM.COM supports three different types of customer events:

Purchase Event
Achievement Event
Referral Event

When submitting a customer event, it's necessary to provide a unique identifier for the contact involved. The recommended method of identification is the CRM.COM Wallet’s code, however, if this is not possible, then the contact ID, contact code, CIM, or OTP are also acceptable methods of identification.

Purchase Events

A Purchase Event is a sales transaction captured by a third-party system, like a POS terminal, and submitted to CRM.COM through a dedicated Web API. The purchase event includes detailed information on who, where, when and which items where purchased along with detailed amounts information. Optionally, the purchase includes the contact’s request to spend an amount of money from their CRM.COM Wallet for fully or partially pay-off the purchase.

Additionally, when an invoice financial transaction is posted, it can also result in the generation of a Purchase Event. To enable this, an Automation must be configured to automatically generate the purchase event based on the invoice contents.

Achievement Events

An Achievement Event signifies a specific action performed by a Contact, such as topping-up their wallet. Achievement Events can be used in conjunction with Reward Offers to award contacts for achieving a target.

For example, an automation can be configured to automatically generate an Achievement Event whenever a Contact makes a new top-up. Then, an Achievement Reward Offer can be created whereby contacts who top-up their wallet with at least EUR100 within the space of a month will be awarded an additional EUR5. Segmentation enables the business to identify contacts with such achievements and configure targeted Reward Offers.

Referral Events

A Referral Event is generated when an existing contact recommends the business to a potential new customer, which could result in new contacts registering with the business. It's a way to motivate existing contacts to endorse the business.

Additionally, a Referral Event can be combined with a Referral Reward Offer to reward contacts for referring new customers to the business.

Purchase Estimates

Prior to submitting a Purchase Event, a Purchase Estimates API can be submitted to CRM.COM with the items intended to be purchased by the contact, along with the requested amount to be spent using the contact’s wallet. The response of this API includes the actual amount that the contact can spend using their wallet funds.

Transaction Processor Purchase Events

With the Transaction Processor, the Platform determines the routing paths for all events (e.g. purchase events) among the platform’s organisations (i.e. Service Owners, Businesses and Merchants/Service Providers). A transaction processor is responsible for verifying incoming purchase customer events, redirecting them to the relevant business, assessing event eligibility, and matching Purchase Events with transaction claims, if applicable.

Customer Event Utilities

Customer Event Utilities provide the ability for back-end system users to view and void Customer events, as well as process ad hoc returns where products are returned and the associated transactions are reversed.

A back-end system user can view purchase, achievement and referral customer events by navigating to Rewards > Reward Events from the sidebar menu.

To manage these events, navigate to the relevant contact screen and select the Activity Feed tab, select the event to see the allowed actions.

Activity Feed on the Contact screen

Selected purchase event allowed actions

Reference Material

You may also find it useful to refer to the following manuals for further reading in relation to Customer Events.

TABLE OF CONTENTS

- 1.1 THE ESSENTIALS
  - 1.1.1 Purchase Events
  - 1.1.2 Achievement Events
  - 1.1.3 Referral Events
- 1.2 Purchase Estimates
- 1.3 Transaction Processor Purchase Events
- 1.4 Customer Event Utilities
2 Reference Material
- 2.1 Contacts
- 2.2 Reward Offers
- 2.3 Automations