Track Method

The track() function

To track custom events in Waymore you need to add the Waymore custom event code in the project with the help of waymore.track(), function, where you need to track the custom events details.

Add the below custom event code in the function with event name, track details, and event info.

waymore.track(eventName<string>, trackData<object>, eventInfo<object>)

Params Details

ParameterData typeRequiredDescription
eventNameStringtrueThe name of the event that you are tracking. (i.e. Custom event name). Validation: Max 30 characters
trackDataObjecttrueAn object of any properties you want to track the data with the custom event
eventInfoObjectfalseAn object of properties used to better define the custom event. Those properties can also be changed in Waymore GUI via the Schemas submenu.

Optional event info object properties:

ParametersData typeRequiredDescriptionValidaiton
typeStringfalseAccepts values: active/ passive
active - Use this value for active events (with user interaction)
passive - Use this value for passive events (without user interaction)
active/ passive
displayNameStringfalseHow the event will be displayed on the Waymore platform. This can change through Waymore Web interface using schemas.Max 30 chars.
descriptionStringfalseHow the event description will be displayed on the Waymore platform. This can change through Waymore Web interface using schemas.Max 100 chars.
naturalLanguageStringfalseHow this event will be displayed on the Segmentation system of the Waymore platform. This can change through Waymore Web interface using schemas.Max 100 chars.
waymore.track("eventName", trackData, eventInfo);
window.waymore.track("eventName", trackData, eventInfo);


If you are working with direct JavaScript / HTML, we can ignore window keyword. But If you are working with any Frontend Framework / Library, use window keyword.

Example: window.waymore.track("eventName", trackData, eventInfo)

Sample custom event for a sign up form submission on an a web platform:

waymore.track("signup-form", {
  email: "[email protected]",
  plan: "Premium",
  cost: "999.00"
}, { 
  type: "active", 
  displayName: "Signed Up",
  description: "User signed up on platform", 
  naturalLanguage: "has signed up on platform"

Reduced version of the previous example:

waymore.track("signup-form", {
  email: "[email protected]",
  plan: "Premium",
  cost: "999.00"

Code Example:
The below code is a HTML project. In that we have added latest waymore.js script. In that HTML project, there was a button, if user clicks that button, we need to track user signup details. In that button function onclick, we are calling our waymore.track() method with custom event name, track data and event info (if required).

<!DOCTYPE html>
<html lang="">

    <!-- Waymore web service script start -->
    <script type="module">
      !function (e) {
            let t=document,a=window,o=t.createElement("link"),s=t.createElement("script"),r=t.body,i=t.head;
            i.appendChild(o);s.src="";i.appendChild(s);let p;(p = a).addEventListener("load",()=>{
                if("routee"in p)e(p);else{let tnc=0,iId=a.setInterval(()=>{("routee"in p||tnc>20)&&(clearInterval(iId),e(p)),tnc++},500)}
        }(function (r) {
                routeeToken: "$UUID_HERE",  // Add your routee token
    <!-- Waymore web service script stop -->

    <button id="custom_event_button">Testing custom events</button>
        document.getElementById("custom_event_button")?.addEventListener('click', function () {
            waymore.track("signup-form", {
                email: "[email protected]",
                plan: "Premium",
                cost: "999.00"