FMX.Analytics.AppAnalytics.TAppAnalytics.TrackEvent

• Aller au parent : TAppAnalytics

Delphi

procedure TrackEvent(const ACategory: string; const AAction: string = string.Empty;
const ALabel: string = string.Empty; const AValue: Double = 0.0);

C++

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

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	public	FMX.Analytics.AppAnalytics.pas FMX.Analytics.AppAnalytics.hpp	FMX.Analytics.AppAnalytics	TAppAnalytics

Description

Effectue le suivi d'un événement personnalisé.

Appelez cette méthode pour réaliser votre propre suivi des événements. Permet de faire le suivi de l'usage des fonctionnalités, des données de performance ou d'autres événements, à condition que les informations restent anonymes.

Vous pouvez définir un ensemble de paramètres d'entrée pour décrire l'événement faisant l'objet d'un suivi. Reportez-vous au tableau suivant pour obtenir une rapide explication de ces paramètres d'entrée.

Paramètre	Description
ACategory	Le paramètre ACategory est obligatoire. Il peut s'agir de toute chaîne comprenant jusqu'à 64 caractères. Il est typiquement utilisé pour la catégorie de l'événement faisant l'objet d'un suivi, mais vous pouvez l'utiliser comme vous le souhaitez.
AAction	AAction est facultatif. Il s'agit également d'une chaîne comprenant jusqu'à 64 caractères. Sert à désigner l'action entreprise par l'utilisateur pour provoquer cet événement.
ALabel	ALabel est facultatif. Il s'agit également d'une chaîne comprenant jusqu'à 64 caractères. Sert à fournir une information sur l'action ayant été réalisée.
AValue	AValue est facultatif. C'est un nombre. Il est typiquement utilisé pour associer une valeur à l'action, comme une mesure de performance, ou une mesure de la taille des données traitées, ou une valeur monétaire associée à une action. L'interface Web Usertility affiche des statistiques sur la valeur ; elles sont triées par catégorie, libellé et/ou valeur.

Remarque : Seul ACategory est obligatoire. Le service AppAnalytics enregistrera les 64 premiers caractères de chacun des paramètres ACategory, AAction et ALabel.

Si votre composant d'analyse de l'application n'est pas activé, TrackEvent n'a aucun effet.

Si ACategory est une chaîne vide, TrackEvent déclenche une exception EAppAnalyticsCategoryMissingException avec le message suivant :

Erreur d'événement personnalisé AppAnalytics : la catégorie ne peut pas être vide.

Voir aussi

• FMX.Analytics.TCustomAnalytics.Enabled
• FMX.Analytics.AppAnalytics.TAppAnalytics.ApplicationID

• Vcl.AppAnalytics.TAppAnalytics.TrackEvent