Vcl.AppAnalytics.TAppAnalytics.TrackEvent

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

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

C++

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

Properties

Type Visibility Source Unit Parent
procedure
function
public
Vcl.AppAnalytics.pas
Vcl.AppAnalytics.hpp
Vcl.AppAnalytics TAppAnalytics

Description

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

ACategory

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

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

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

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