Custom Events

       In addition to the clearly predefined events, developers can report custom events according to their own analysis needs.

       Custom event names can be defined by the developer.

Here are the naming conventions for event names:

• String type
• Start with letters only.
• No more than 40 characters.
• Contain numbers, lowercase letters and underscores only.

Custom Properties

       A custom property is a JSONObejct object where each key-value represents a property.

Key: Property Name

• String type
• Start with letters only.
• No more than 40 characters.
• Contain numbers, lowercase letters and underscores only.

Value: Property Value

• Support basic data types like String, int, long, float, double, boolean, and date
• For elements of an array, only string type is supported.
• For other types, they will be forcibly converted to strings and stored.

Custom Property Types

       The data type of custom event properties is determined by their data types reported for the first time and cannot be changed once confirmed. For subsequent reporting of the same properties, only properties with the same data types as the first occurrence will be stored in the database.

Note:

       The data type of the property determines their analysis logic available in analysis models. For example, the numerical type can perform calculations such as maximum value, minimum value, and summation, while the Boolean type can perform calculations of true and false values. Therefore, when determining the format of data reporting, you need to consider the analysis scenarios and business needs and formulate a complete event tracking plan as directions.

Function

public synchronized void track(SECustomEventModel seCustomEventModel);

Sample Code

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;

JSONObject customEventData = new JSONObject();
try {
    //Developer custom event properties in JSON format.
    customEventData.put("key1","value1");
    customEventData.put("key2","value2");
} catch (JSONException e) {
///
}
JSONObject preEventData = new JSONObject();
try {
     //Developer custom event properties in JSON format.
     preEventData.put("_currency_type", "USD");
     preEventData.put("_pay_amount", 11.2);
} catch (JSONException e) {
  ///
}
SECustomEventModel seCustomEventModel = new SECustomEventModel("xxxCustomEventNamexxx",preEventData,customEventData);
SolarEngineManager.getInstance().track(seCustomEventModel);