Tracking Events

NOTICE

Microsoft is replacing Xamarin with .NET MAUI and the support for the latest release of Xamarin is till November 2023. MoEngage will stop providing updates for the MoEngage Xamarin SDK due to the deprecation. Deprecation impacts Xamarin In-App Messaging and will stop working after June 2022. All other features will continue to work in the Xamarin SDK until November 2023.

Tracking events is how you record any actions your users perform, along with any properties that describe the action. Every trackEvent call records a single user action. We recommend that you make your event names human-readable so that everyone on your team can know what they mean instantly.

Every TrackEvent() call expects 2 parameters, event name and Properties instance which represents additional event attributes about the event. Add all the additional information which you think would be useful for segmentation while creating campaigns. For eg: the following example shows an example of tracking an event with all the possible data types.

// Create Properties instance with all the event attributes info
Properties properties = new Properties()
              .AddBoolean("booleanAttr", true)
              .AddDouble("doubleAttr", 12.34)
              .AddInteger("intAttr", 123)
              .AddLocation("locationAttr", new GeoLocation(12.21, 13.42))
              .AddISODateTime("dateAttr", "2019-01-02T08:26:21.170Z")
              .AddString("stringAttr", "test String");

// Track Event to track the Event
MoEXamarin.Current.TrackEvent("XamarinEvent", properties);

Naming Restrictions

Event names should not contain any special characters other than "_". It can contain just spaces and underscore.

Analytics

MoEngage SDK has started tracking user sessions and application traffic sources. Refer to the Sessions in MoEngage Analytics and Source Analysis in MoEngage Analytics to learn more about how user session and application traffic source tracking works.

With user session tracking we have introduced the flexibility to selectively mark events as non-interactive.

What is a non-interactive event?

Events that do not affect the session calculation in anyways are called non-interactive events. Non-interactive events have the below properties

Do not start a new session.
Do not extend the session.
Do not have information related to a user session.

How to mark an event as non-interactive?

To mark an event as a non-interactive call SetNonInteractive() for Properties instance as shown below:

// Create Properties instance with SetNonInteractive()
Properties properties = new Properties()
              .AddBoolean("booleanAttr", true)
              .AddString("stringAttr", "test String")
              .SetNonInteractive();

// Track Event to track the Event
MoEXamarin.Current.TrackEvent("NonInteractive Event", properties);