Verwenden von AppAnalytics in der VCL

Nach oben zu VCL

RAD Studio integriert AppAnalytics für VCL-Win32- und VCL-Win64-Anwendungen, die in Delphi und C++Builder geschrieben werden.

AppAnalytics für die VCL verwendet Windows-Meldungswarteschlangen, um die Anwendungsdaten abzurufen.

Einstieg in die Verwendung von AppAnalytics in der VCL

Um AppAnalytics in der VCL nutzen zu können, müssen Sie eine TAppAnalytics-Komponente in Ihre Anwendung einfügen. Danach müssen Sie im Objektinspektor die ApplicationID hinzufügen.

Hinweis: Sie benötigen ein AppAnalytics-Konto und eine Anwendungs-ID, um AppAnalytics in Ihrer Anwendung verwenden zu können.

Nach der Aktivierung von AppAnalytics sind nach wenigen Minuten Nutzungsanalysen in der AppAnalytics-Weboberfläche verfügbar.

Aktivieren/Deaktivieren der Datensammlung mit AppAnalytics

Sie können AppAnalytics während der Entwicklung aktivieren, damit Sie Informationen über die gesamte Nutzung während der Anwendungssitzung erhalten. Außerdem können Sie dem Benutzer erlauben, AppAnalytics zur Laufzeit zu aktivieren.

Wenn der Benutzer AppAnalytics zum ersten Mal aktiviert, wird ein Datenschutzhinweis angezeigt, der den Benutzer darüber informiert, dass seine Aktionen protokolliert werden. AppAnalytics erfasst nur anonyme Daten. Die Datenschutzmeldung wird in einem Dialogfeld mit der Schaltfläche "OK" angezeigt. Der Endbenutzer kann jedoch nicht die Protokollierung von Informationen aktivieren oder deaktivieren.

Hinweis: In der Abbildung wird der Standardtext des Datenschutzhinweises dargestellt. Sie können diesen Text jedoch ändern, indem Sie die Eigenschaft PrivacyMessage bearbeiten.

Um dem Endbenutzer die Möglichkeit zu bieten, die Protokollierung zu starten und zu beenden, können Sie die Methode CheckPrivacy verwenden, die AppAnalytics in der VCL implementiert. Diese Methode zeigt ein Dialogfeld an, in dem der Benutzer um seine Zustimmung gebeten wird.

Warnung: Weder Sie noch Ihre Benutzer sollten persönliche, vertrauliche oder identifizierbare Informationen über diese Verbindung senden. Die Übermittlung dieser Daten stellt eine Verletzung der Datenschutzrichtlinien dar.

Konfigurieren der Protokollierungsoptionen für AppAnalytics in der VCL

Sie können entscheiden, welche Daten AppAnalytics automatisch sammelt, indem Sie eine beliebige Parameterkombination in der Eigenschaft TAppAnalytics.Options auswählen.

Standardmäßig wird bei Aktivierung von AppAnalytics in der VCL Folgendes protokolliert:

• Wenn die Anwendung gestartet und geschlossen wird (aoTrackStartup).
• Wenn sich das aktive Formular in der Anwendung ändert (aoTrackFormActivate).
• Wenn eine Exception ausgelöst und auf der Anwendungsebene abgefangen wird (aoTrackExceptions).

AppAnalytics implementiert auch das Ereignis TrackEvent, mit dem Sie eine benutzerdefinierte Ereignisprotokollierung einsetzen können, wenn Sie die Nutzung von Funktionen, Leistungsdaten oder andere Ereignisse verfolgen möchten, sofern die Daten anonym bleiben.

Andere Konfigurationsoptionen

Mit der Eigenschaft CacheSize können Sie die maximale Anzahl von Ereignissen definieren, die AppAnalytics sammelt, bevor die Daten zur Analyse an den Server gesendet werden. Diese Eigenschaft ist standardmäßig auf 500 gesetzt.

Sie können entscheiden, in welchem Intervall AppAnalytics die gesammelten Daten automatisch an den Server zur Analyse sendet. Dieses Intervall wird mithilfe der Eigenschaft UpdateInterval in Millisekunden festgelegt. Der Standardwert ist 600 Millisekunden.

Zählen der Endbenutzer mit AppAnalytics

AppAnalytics zählt einen Endbenutzer als Benutzer einer einzelnen Anwendung unter einem einzelnen Benutzerkonto auf einem Client-Computer. Genauer gesagt, stellt ein Endbenutzer eine Kombination einer ApplicationID und eines Windows-Benutzerkontos (das durch den Registrierungsschlüssel HKEY_CURRENT_USER festgelegt wird) dar.

Verfolgung benutzerdefinierter Ereignisse

AppAnalytics ermöglicht Entwicklern, benutzerdefinierte Ereignisse mit einer einzigen Codezeile zu erstellen. Anhand der Verfolgung benutzerdefinierter Ereignisse können Entwickler weitere Einzelheiten über die Verwendung der Anwendung durch Benutzer herausfinden, zum Beispiel, wann der Benutzer auf eine Schaltfläche klickt, wann der Benutzer eine Option aus einem Menü auswählt, wenn er einen Drag&Drop-Vorgang ausführt etc.

Um ein benutzerdefiniertes Ereignis nachzuverfolgen, müssen Sie die Methode TrackEvent von TAppAnalytics aufrufen.

Weitere Informationen finden Sie unter Vcl.AppAnalytics.TAppAnalytics.TrackEvent und Tracking Custom Events Code Snippet on VCL (EN).

Siehe auch

• Übersicht über AppAnalytics
• Verwenden von AppAnalytics in FireMonkey
• AppAnalytics-Weboberfläche (EN)
• AppAnalytics-Produktseite (EN)

Codebeispiele

• VCL.AppAnalytics (Beispiel)
• FMX.AppAnalytics (Beispiel für Delphi und C++)
• Tracking Custom Events Code Snippet on FireMonkey (EN)
• Tracking Custom Events Code Snippet on VCL (EN)