Send user 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 user 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.

You can find our list of predefined events here.

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

Java

UserEvent event = new JtLevelStartEvent("LEVEL_1");

Kotlin

val event = JtLevelStartEvent("LEVEL_1")

Here, JtLevelStartEvent is a subclass of UserEvent. It represents a JtLevelStart and accepts a single predefined dimension, called "jt_level_name". In this example, you pass the value for that dimension in the constructor.

You can add more dimensions with .addDimension():

Java

UserEvent event = new JtLevelStartEvent("LEVEL_1")
    .addDimension("dimension_name", "value");

Kotlin

val event = JtLevelStartEvent("LEVEL_1")
    .addDimension("dimension_name", "value")

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():

Java

sdk.publishEvent(event);

Kotlin

sdk.publishEvent(event)

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

Publish a custom user event

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

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

Java

UserEvent event = new UserEvent("my_event");

Kotlin

val event = UserEvent("my_event")

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

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

Java

UserEvent event = new UserEvent("my_event")
    .addDimension("dimension_name", "value");

Kotlin

val event = UserEvent("my_event")
    .addDimension("dimension_name", "value")

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

Java

sdk.publishEvent(event);

Kotlin

sdk.publishEvent(event)

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 UserEvent class in our UserEvent API documentation.