In-app Events

Events help you to track all the user actions within your app. For example, sign up, purchase made, feedback given and so on. Events analytics and the associated data helps you understand your users. 

Event types

Zoho Apptics provides two types of event analytics; Defined events and Custom events. 

Defined events - These are the default events that are available for your use once you have integrated our SDK.

Custom events - These are the events that you want to capture using our SDK.

To be able to use either the defined or custom events, you need to:

  • Make sure that you have integrated Apptics with your app, refer to the integration guide for detailed steps.

Logging custom events

Use AppticsEvents.addEvent() method to log the custom events, event groups, and custom properties. Event name and event group name are mandatory to be added and cannot be null or empty.

Copiedimport { Apptics } from '@zoho_apptics/apptics-react-native';

Apptics.addEvent("eventName", "eventGroupName")

Make sure that event name and group name follow the below norms, else the event won't be logged within the SDK.

  • should not be more than 100 characters.
  • should start with an alphabet.
  • should not contain any space or special characters apart from underscore (_).
  • cannot start with 'ap_' or 'AP_'. These are reserved for the defined events.

An example of a valid event name : 'helloworld' , 'Hello_world' , 'helloWorld'
An example of an invalid event name : '_helloworld' , '1hello' , `Hello World` , 'ap_helloworld`

Custom events with properties

Event properties are any additional information that can be associated with the events you are capturing using our SDK. These properties are can be passed as maps.

Sample snippet to use properties as maps.

Copiedimport { Apptics } from '@zoho_apptics/apptics-react-native';

let prop = {'plan':'premium'}
Apptics.addEvent("eventName", "eventGroupName", prop)

Make sure that the event properties follow the below norms else, the properties won't be logged with the events.

  • property key should not be more than 50 characters.
  • property key should start with an alphabet.
  • property key should not contain any space or special characters except underscore (_).
  • property key should not start with 'ap_' or 'AP_'.
  • property value can be a number (init, float, double, long), boolean, or string. Other data types such as JSONObject or JSONArray will be converted to string.
  • property value length should not be more than 250 characters.