LimeSpot Audience Segmentation engine relies on the user behavior tracking that is automatically running on the storefront. This provides the Segmentation with numerous options to target the shoppers according to their page visits, store activities and various interaction with products.
That said, there are special use cases where the store would like to create Audience Segments based on specific user activities that are not automatically tracked via the standard event tracking. Imagine you would like to add the audience to the segment when they click on a certain link on the home page, or when they add a product to the cart from a custom landing page. This is where the Custom Events come into play.
What are Custom Events?
Custom Events are user-defined events that could 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 criteriacount(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 could 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 3 input parameters as described above. Here's an example of how this could be called:
<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
valueamounts submitted)Custom Event Value Average: to create segments based on the Average value (average of all
valueamounts submitted)Custom Event Count: to create segments based on the total number of times the event has been triggered (sum of all
countvalues)
In order to create Audience 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.
If you'd like to use LimeSpot Custom Events with Shopify Flow, follow this guide for more info.