Now, you can capture any valuable activity performed by your visitors and users on your website. They are called events. It can be a simple click on a button of your choice (adding something to the cart, sending a contact form, requesting to download an ebook). When you send the data to UserEngage, you can then filter the user data based on these events. It allows to send personalized messages to a specific group of people that performed a given activity.

Events vs custom attributes

  • Custom attributes is something about your users; a type of data that characterizes them, e.g. client ID or shoe size.
  • Events is the information on the record what users do, and when they do it, e.g. when they add something to the cart.

Custom attributes are the best solution for:

  • Any sort of information that gives a description of a user: location, subscription plan etc.
  • A value to be updated: a number that indicates the on-boarding progress (what stages have been accomplished).

Events record are perfect for:

  • Any sort of activity that is perfomered (when a button is clicked)
  • A situation when a data is changed (when somebody places an order)

How do I do it?

Simple event binding:

All you need to do is to bind an event on your website. For example, on a click of a button of your choice.

<a href="#" onclick="userengage('event.name_your_event_here')">CLICK ME!</a>
If you are missing an event in our app, go to the page you've added that button to, click the button (to trigger the event) and head over to your action path creator.
  1. Create a new action, or edit an existing one
  2. Add Event trigger to the path
  3. Configure Event trigger, set it to the newly created event (name_your_event_here)
  4. Go on with Actions: send a chat message
  5. Configure that action with your message.

If you want to pass through an argument, you can do that by setting second parameter:

<a href="#" onclick="userengage('event.name_your_event_here', {'price': '10'})">CLICK ME!</a>

If you want to pass through some more arguments, you can do that by setting second parameter as an array:

<a href="#" onclick="userengage('event.name_your_event_here', {'sku': '7', 'size': '39', 'color': 'teal', 'price': '39'})">CLICK ME!</a>

With arguments as a paremeter, you can filter users as shown below:


Or create complex actions via action path creator


If you need help setting this up, feel free to contact us!