FMX.Analytics.AppAnalytics.TAppAnalytics.TrackEvent

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
FMX.Analytics.AppAnalytics.pas
FMX.Analytics.AppAnalytics.hpp
FMX.Analytics.AppAnalytics TAppAnalytics


Beschreibung

Protokolliert ein benutzerdefiniertes Ereignis.

Mit dieser Methode können Sie eine eigene Ereignisprotokollierung durchführen. Sie können damit die Nutzung bestimmter Funktionen, Leistungsdaten oder was immer Sie möchten, unter der Voraussetzung verfolgen, dass die Informationen anonym bleiben.

Mit Eingabeparametern, die Sie definieren, können Sie das zu verfolgende Ereignis beschreiben. Die folgende Tabelle enthält eine kurze Beschreibung dieser Eingabeparameter.

Parameter Beschreibung

ACategory

Der Parameter ACategory ist erforderlich. Der Parameter kann ein beliebiger, bis zu 64 Zeichen langer String sein. Normalerweise wird dieser Parameter für die weitgefasste Kategorie des verfolgten Ereignisses verwendet, aber Sie können ihn beliebig einsetzen.

AAction

AAction ist optional. Dieser Parameter kann ebenfalls ein bis zu 64 Zeichen langer String sein. Damit wird die vom Benutzer ausgeführte Aktion, die dieses Ereignis verursacht hat, bezeichnet.

ALabel

ALabel ist optional. Dieser Parameter kann ebenfalls ein bis zu 64 Zeichen langer String sein. Damit wird ein Detail über die ausgeführte Aktion bereitgestellt.

AValue

AValue ist optional. Dieser Parameter ist eine Zahl. Damit wird normalerweise einer Aktion ein Wert zugeordnet, wie z. B. eine Maßzahl für die Leistung oder eine Maßzahl für die Größe der verarbeiteten Daten oder ein Geldwert, der bestimmten Aktionen zugeordnet ist. In der Usertility-Weboberfläche wird eine Gesamtstatistik dieses Wertes, unterteilt nach Kategorie, Bezeichnung und/oder Wert, angezeigt.

Hinweis: Nur ACategory ist erforderlich. Der AppAnalytics-Dienst zeichnet jeweils die ersten 64 Zeichen der Parameter ACategory, AAction und ALabel auf.

Wenn Ihre Anwendungsanalyse-Komponente nicht aktiviert ist, hat TrackEvent keine Auswirkung.

Wenn ACategory ein leerer String ist, löst TrackEvent eine EAppAnalyticsCategoryMissingException-Exception mit der folgenden Meldung aus:

Fehler in benutzerdefiniertem AppAnalytics-Ereignis: Kategorie muss angegeben werden.

Siehe auch