All Collections
Real-time Audience Segmentation
What are Audience Segmentation Custom Events?
What are Audience Segmentation Custom Events?

Learn what custom events for audience segmentation are and how to trigger them.

W
Written by Will Wadman
Updated over a week ago

LimeSpot Audience Segmentation engine relies on automatic user behavior tracking. This provides numerous options for creating personalized experiences based on shoppers' page visits, store activities, and various interactions with products.

In some cases, there might be a need to create segments based on specific user activities not automatically handled by our standard event tracking. For example, you might want to add audience members to a segment when they click a specific link on the home page or add a product to the cart from a custom landing page. This is where Custom Events come into play.

What are Custom Events?

Custom events are user-defined events that can be used to track a non-standard user activity, which could then be used in the Audience Segmentation module for defining segment criteria. Each custom event has 3 attributes:

  • customEventIdentifier (required): The internal Identifier (or title) you assign to the event, which will be used to identify those events in the segment criteria.

  • count (optional - default: 1): An optional parameter to track the Number of Times the event has been triggered. For example if you are tracking a special add to cart event, you might want to provide the Quantity as Count.

  • value (optional - default: 0): An optional parameter to track a Value associated with the event. For example if you are tracking a special add to cart event, you might want to provide the product price as the Value.

How to Track Custom Events?

Custom Events can be tracked on the client-side via Javascript. The LimeSpot Storefront Library (already included on all storefronts) provides a method for tracking the custom events with the input parameters as described above. Here's an example of of a custom event:

<script>
LimeSpot.tracker.logCustomEvent({
customEventIdentifier: "custom_event",
count: 2,
value: 100.54
});
</script>

How to Use Custom Events to Create Audience Segments?

There are 3 specialized types of criteria available on the Audience Segment definition page that could be used to define segments based on the tracking described above:

  • Custom Event Value to create segments based on the Total value of the tracked events (sum of all value amounts submitted).

  • Custom Event Value Average to create segments based on the Average value (average of all value amounts submitted).

  • Custom Event Count to create segments based on the total number of times the event has been triggered (sum of all count values).

In order to create segments based on these criteria, you can login to your LimeSpot Admin Panel > Go to Segmentation (Audience) at the top > Click CREATE > Blank > Find the Custom Event criteria you need.

Using Shopify Flows?

If you'd like to use LimeSpot Custom Events with Shopify Flow, follow this guide for more info.

Did this answer your question?