Custom Events

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

       The custom event names should be customized by the developer.

Rules for Event Names:

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

Property

Event property is a Dictionary, where each key-value pair 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 static void track(string customEventName, Dictionary<string, object> customAttributes, Dictionary<string, object> preAttributes)

Note: preAttributes only support _currency_type and _pay_amount.

Sample Code

Dictionary<string, object> customAttributes = new Dictionary<string, object>();
customAttributes.Add("K1", "V1");
customAttributes.Add("K2", "V2");   
customAttributes.Add("K3", 2); 
Dictionary<string, object> preAttributes = new Dictionary<string, object>();
preAttributes.Add("_currency_type", "USD");
preAttributes.Add("_pay_amount", 11);
SolarEngine.Analytics.track("xxxxxx",customAttributes,preAttributes);