From RAD Studio API Documentation
Jump to: navigation, search


procedure TrackEvent(ACategory: string; AAction: string = '';
ALabel: string = ''; AValue: Double = 0.0);


void __fastcall TrackEvent(System::UnicodeString ACategory, System::UnicodeString AAction = System::UnicodeString(), System::UnicodeString ALabel = System::UnicodeString(), double AValue = 0.000000E+00);


Type Visibility Source Unit Parent
Vcl.AppAnalytics TAppAnalytics


Tracks a custom event.

Call this method to do your own event tracking. You might use this to track feature usage, performance data, or anything else you like, provided the information remains anonymous.

You can define a set of input parameters to describe the event being tracked. See the following table with a brief explanation of these input parameters.

Parameter Description


The ACategory parameter is required. It can be any string, up to 64 characters. This is typically used for the broad category of the event that is tracked, but you can use it however you like.


AAction is optional. It is also a string, up to 64 characters. This is used to denote the action taken by the user to cause this event.


ALabel is optional. It is also a string, up to 64 characters. This is used to provide a detail about the action that was performed.


AValue is optional. It is a number. This is typically used to associate a value with the action, such as a performance measurement, or a measure of the size of data processed, or a monetary value associated with some action. The Usertility web interface shows aggregate statistics about the value, categorized by category, label, and/or value.

Note: Only ACategory is required. The AppAnalytics service will record the first 64 characters of each of ACategory, AAction, and ALabel.

See Also