📘
Kindly ensure to update your products and historical customer data (if any) before sending events to use automations, segments, and campaigns on the Contlo dashboard.

Now that you have created your account, synced your products, and connected your website with Contlo, all you need to do is to start sending across your users' events.

Events

Analyzing events is very important for understanding how users interact with a website. The events play an important role in decision-making.

Types of Events

There are three types of events handled by Contlo for custom businesses:

Message Events

These events are related to push notifications and are automatically captured when a user interacts with the notification after you have integrated our custom snippet with your website.

Custom Events

These events are your user journey events that you would track across the user journey.

You can send events with custom property, using Contlo's Track API v1. Some examples of custom store events -

Use our Track API v1 for sending the following example events-

EVENTS	DESCRIPTION
Viewed Product	When someone views a product
Added to Cart	When someone adds an item to their cart
Started Checkout	When someone lands on the checkout page
Placed Order	When an order successfully processes on your system
Fulfilled Order	When an order is processed
Cancelled Order	When an order is cancelled
Refunded Order	When a customer’s order is refunded
Order in Transit	When an order is in transit
Order Delivered	When an order is delivered to the customer.

Over here - Track API v1, you'll find a generic example for how to use the Track API v1. This example does not point out to the usage of a specific event but instead, generally points out to what the Track API v1 for an event could look like.

Charged Events

You should record transactions or purchases in Contlo using a special event called Charged.

What makes Charged a special event?

Charged is a special event because it provides a way for you to specify the items sold, their categories, transaction amount, the transaction id, and the information about your users.
Recording a purchase against a user marks them as a customer in Contlo. This enables you to compare your funnel reports between customers and non-customers.
Recording the Transaction Amount
The transaction total or charge should be recorded in an event property called Transaction value.

Mandatory Properties to record a Charged event

Parameter	Type	Description
event_id	string	Used to map the event.
transacation_value	string	The value attributed to the revenue.
variant_id	string	The corresponding variant(s) ID for which transaction is taking place.
event_type	string	Type of event (Charged)
currency	string	Currency code of variant prices. Follow ISO 4217:2015 Format: https://en.wikipedia.org/wiki/ISO_4217
transaction_id	string	Unique identifier of the transaction.
email	string	Email ID of the customer
phone number	string	Phone number of the customer.
product_id	string	The corresponding product (s) ID for which the transaction is taking place.
time	Long	Epoch time in milli seconds.

Example JSON:

{
   "event_id":1234,
   "event":"order_placed",
   "email":"[email protected]",
   "phone_number":"+911234567890",
   "properties":{
      "event_type":"charged",
      "transaction_value":29.98,
      "transaction_id":12345,
      "currency":"INR",
      "product_ids": ["prod1", "prod2", "prod3"],
      "collection_ids": ["col1", "col2", "col3"],
      "variant_ids": ["var1", "var2", "var3", "var4"]
   },
   "time":1695275574000
}

Advantages of the Charged Event

Helps you identify your customers, and how are they using your app or website
Run campaigns to reward loyal users or get lost customers back
Measure customer loyalty via running a cohort analysis on repeat purchases
Analyze paid campaign performance by total revenue earned
Get revenue insights like – total revenue, number of transactions, count of paying users and much more.

You can use all the above events created through the Track API v1 in your Automations.

Verify Integration:

After setting up, to verify your integration you can send a sample event to Contlo. Once the event is sent, go to Audience section on the Contlo platform.

If you are able to see a user profile created with the sample event, then this means that you have successfully completed the integration.

Welcome aboard!!