Verbesserung der Benutzererfahrung; Ein Leitfaden zur Fehlerverfolgung mit benutzerdefinierten Ereignissen und benutzerdefinierten Eigenschaften

Einführung von Benutzerdefinierten Ereignissen

Moderne Web-Entwicklungsframeworks bieten eine Fülle von Werkzeugen, um Benutzerinteraktionen und Systemverhalten zu überwachen. Unter diesen stechen die benutzerdefinierten Ereignisse von Metricalp als vielseitige Instrumente hervor, um spezifische Aktionen und Vorkommnisse innerhalb Ihrer Anwendung zu verfolgen. Ob es sich um das Erfassen von Klicks, Formularübermittlungen oder sogar Fehlern handelt, benutzerdefinierte Ereignisse ermöglichen es Entwicklern, tiefere Einblicke in das Benutzerverhalten und die Systemleistung zu gewinnen.

Betrachten Sie das Szenario der Fehlerverfolgung. Wenn ein Fehler auftritt, geht es nicht nur darum, das Problem zu identifizieren, sondern auch den Kontext und die Auswirkungen auf die Benutzer zu verstehen. Traditionelle Fehlerprotokolle können technische Details liefern, aber oft fehlt die entscheidende kontextuelle Information, die für eine effektive Problemlösung erforderlich ist. Hier glänzen benutzerdefinierte Ereignisse.

Verfolgung von Fehlern mit Benutzerdefinierten Ereignissen und Benutzerdefinierten Eigenschaften

Stellen Sie sich ein Szenario vor, in dem ein Benutzer einen Fehler in Ihrer Anwendung erlebt. Anstatt sich ausschließlich auf generische Fehlerprotokolle zu verlassen, können Sie ein benutzerdefiniertes Ereignis implementieren, das speziell darauf zugeschnitten ist, diese Vorkommnisse zu erfassen. Lassen Sie uns den Ablauf dieses Prozesses genauer betrachten:

Erstens können Sie in Metricalp alle benutzerdefinierten Ereignisse zulassen oder die erlaubten Ereignisse in den Tracker-Einstellungen angeben.

Das Schöne an Metricalp ist, dass Sie pro benutzerdefiniertem Ereignis unterschiedliche benutzerdefinierte Eigenschaften haben können. Sie können auch benutzerdefinierte Eigenschaftsalias pro benutzerdefinierten Ereignissen in den Tracker-Einstellungen definieren.

Weitere Informationen zu benutzerdefinierten Eigenschaftsalias und benutzerdefinierten Ereignissen finden Sie in der zugehörigen Dokumentation.

Schauen wir uns jetzt Schritt für Schritt an, wie wir diese benutzerdefinierten Ereignisse und Eigenschaften zur Fehlerverfolgung nutzen können.

Ereignisdefinition: Definieren Sie ein benutzerdefiniertes Ereignis mit dem Namen "error" innerhalb Ihres Trackingsystems. Dieses Ereignis dient als Signalgeber zum Erfassen von Fehlerereignissen in Ihrer gesamten Anwendung.

Wenn Sie in den Tracker-Einstellungen alle benutzerdefinierten Ereignisse zugelassen haben, müssen Sie es nirgendwo definieren. Sie können ab dem ersten Tag jedes Ereignis (wie "error") erzeugen. Wenn Sie die erlaubten Ereignisse (wie in unserem Beispiel) eingeschränkt haben, müssen Sie das "error"-Ereignis in den Tracker-Einstellungen zulassen.

Fehlerkontext: Fügen Sie dem "error"-Ereignis benutzerdefinierte Eigenschaften hinzu, um Kontext und Details bereitzustellen. Diese Eigenschaften könnten "error_title" umfassen, um die Art des Fehlers zu beschreiben, und "error_message", um zusätzliche Informationen oder Anweisungen zu liefern.

Wie in der Dokumentation beschrieben, können Sie jederzeit benutzerdefinierte Eigenschaften anhängen wie "{ type:"error", custom_prop1: "my_value" }". Aber wir wissen, dass custom_prop1 nicht... lesbar ist. Das Schöne an Metricalp ist, dass Sie pro benutzerdefinierten Ereignis unterschiedliche Alias für benutzerdefinierte Eigenschaften definieren können. Dann können Sie diese Alias verwenden, während Sie Ereignisse erzeugen: "{ type:"error", error_title: "my_value" }"

Nun werden wir auch benutzerdefinierte Alias für unsere Fehlerbenutzerdefinierte Ereignis "error" definieren

Wir haben "error_title", "error_message", "user_id", "env", "app_version" Aliase für unser "error"-Ereignis definiert.

Jetzt ist es lesbarer und wertvoller zu analysieren. Wie toll, oder?

Nun werden wir unser benutzerdefiniertes Ereignis erzeugen, wenn wir einen Fehler fangen. Es gibt verschiedene Möglichkeiten, benutzerdefinierte Ereignisse zu erzeugen. Wenn Sie React oder NextJS verwenden, können Sie die Methode aus der Integrationsbibliothek verwenden, wie in den Dokumentationen beschrieben. Wenn Sie eine reine Integration verwenden, lesen Sie die Dokumentation zu benutzerdefinierten Ereignissen.

try {
    // ....
  } catch (err) {
    window.metricalp.event({
      type: 'error',
      error_title: 'Register Attempt Error',
      error_message: err.message,
      user_id: user.id,
      env: 'production',
      app_version: '1.0.0',
    });
  }

Das war's. Jetzt haben wir angefangen, Fehlerprotokolle auf die richtige Weise zu sammeln. Lassen Sie uns unser Dashboard überprüfen.

Wir haben unsere Fehler, juhu. Ich weiß, Fehler zu haben ist nicht gut, aber wenn wir sie fangen können, können wir sie beheben. Wenn wir jetzt unser Fehlerereignis auswählen, können wir benutzerdefinierte Eigenschaften wie user_id usw. sehen.

Aber nicht nur das, wir haben auch alle unsere Standarddaten wie Benutzerbrowser, Betriebssystem usw. Also haben wir jetzt alle Details zum Fehler. Wir können ihn reibungslos erkennen und beheben.

Angenommen, wir haben einen Fehler 'xxx is not a function' in der benutzerdefinierten Eigenschaft gefunden. Dann können wir diese benutzerdefinierte Eigenschaft einfach als Filter auswählen und direkt nach Browser und Gerät der Benutzer für diesen Fehler suchen. Wenn z.B. 95%+ der Fehler auf Safari-Browser zurückzuführen sind, dann haben wir den Fehler gefunden. Es handelt sich um ein Kompatibilitätsproblem mit dem Browser.

Mit Metricalp können Sie die Ursache jedes Fehlers finden. Handelt es sich um ein Betriebssystemproblem? Ein mobiles Gerät oder das Land des Benutzers? Alle Fälle können in Metricalp analysiert werden.

Wie gesagt, Metricalp ist nicht nur ein Analysetool. Wir haben es hier als Fehlerfänger verwendet. Es ist großartig, robuste, sichere Systeme zu haben. Aber es ist nicht darauf beschränkt, Sie können benutzerdefinierte Ereignisse und Eigenschaften für jedes Szenario verwenden. Zum Beispiel können Sie es für Ihre A/B-Tests verwenden. Sie können es zur Verfolgung von Konversionen nutzen. Es hängt von Ihren Bedürfnissen und Ihrer Fantasie ab. Metricalp beseitigt Grenzen.

Jetzt haben Sie gelernt, wie Sie Metricalp richtig verwenden können, um Fehler zu erfassen und zu verfolgen.