Skip to main content
Version: SDK 5.0.x

Send app events

With the justtrack SDK, you can monitor and record user behaviors as events. These allow you to track how your users are using your app. For each event, you can also specify dimensions which you can later use to filter, sort, and group your events in the dashboard.

In this guide, you'll learn to:

  • Send predefined events
  • Send custom events
  • Await the results of publishing events

Publish a predefined event​

With our SDK, you can send predefined events to your justtrack account. These events are defined by justtrack and are given special attention in the platform. For example, some metrics are calculated for you if you send data in certain predefined events.

info

You can find our list of predefined events here.

To send a predefined event, you first create an event object:

const event = new JtLoginEvent('success', 'facebook');

Here, JtLoginEvent is a subclass of AppEvent. It represents a JtLoginEvent and accepts two predefined dimension, called jt_action and jt_method. In this example, you pass the value for that dimension in the constructor.

You can add more dimensions with .addDimension():

const event = new JtLoginEvent('success', 'facebook');
event.addDimension('dimension_name', 'value');
info

You can pass all predefined dimensions that belong to a predefined event to the constructor. For all other dimensions, you must use .addDimension().

When you've created and configured an event object, call .publishEvent():

await JustTrackSdk.publishEvent(event);

This sends the event to the justtrack platform where you can visualize and analyze your data.

Publish a custom app event​

Along with predefined events, you can also send custom events to your justtrack account. You define these events yourself and they're not given any special attention in the platform.

To send a custom event, you first create an event object:

const customEvent = new AppEvent('custom_event_name');

Here, you create a custom AppEvent object and supply an event name, my_event.

You can add dimensions to your custom event with .addDimension():

const customEvent = new AppEvent('custom_event_name');
customEvent.addDimension('dimension_name', 'value');

When you've created and configured an event object, call .publishEvent():

await JustTrackSdk.publishEvent(customEvent);

This sends the event to the justtrack platform where you can visualize and analyze your data.

Conclusion​

Now that you know how to send events to your justtrack account, you can review further details of the AppEvent class in our AppEvent API documentation.

Jump to