Tracking User Actions

Important: Please ensure your CMP configuration includes new Vendor ID 1469 for 1st Party data tracking. Additionally, include Vendor ID 301 if cookie sync is enabled. Learn more

Description:
Use this method to track specific user interactions on your website. These interactions can include product views, action button clicks and other custom behaviors relevant to your application. Parameters:

eventName: string – A name that describes the user action (e.g., 'Checkout', 'productViewed', 'AddToCart').
properties: object (optional) – Key-value pairs with details about the event: Eg:
- productId
- cartValue
- quantity, etc

Usage Example:

window.zeotap.setEventProperties('AddToCart', {
  productId: 'PQR-222',
  quantity: 1,
  cartValue: 29.99
});

Verification: The page properties will be passed in the payload of the https://spl.zeotap.com/fp? call:

Event properties in payload

            "events": [
                {
                "event": {
                    "id": "m9Tva77fUH4ILi3SPBBVn",
                    "eventName": "AddToCart", //AddToCart event name,
                    "productId": "PQR-222", //EventProperties
                    "quantity": 1,
                    "cartValue": 29.99,
                    "eventTimestamp": 1745959356443
                },
                "user": {
                    "zs": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
                    "zi": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
                    "zi_domain": ".zeotap.com",
                    "email": "jane.doe@email.com"
                },
                "page": { 
                    "path": "/products",
                    "referrer": "https://test.zeotap.com/",
                    "url": "https://test.zeotap.com/product1"
                },
                "version": "4.4.3"
                }
            ]

Verification: To verify that the user action tracking is working:

Open your browser’s Developer Tools (F12 or right-click → Inspect).
Go to the Network tab.
Perform the action you’re tracking (e.g., add an item to a cart or view a product).
Look for a network POST request sent to https://spl.zeotap.com/fp?.
Check the request payload — it should contain:
- An event node with the eventName (e.g., "AddToCart")
- A properties object with the custom values you passed (e.g., productId, quantity, price)

This confirms that the SDK is successfully capturing and sending user action events.

Overview

Web JavaScript SDK

Google Tag Manager

Adobe Launch

iOS SDK

Android SDK

React Native SDK

Tracking User Actions