Migliorare l'esperienza utente; Una guida al tracciamento degli errori con eventi personalizzati e proprietà personalizzate

Introduzione agli Eventi Personalizzati

I framework moderni di sviluppo web offrono una miriade di strumenti per monitorare le interazioni degli utenti e il comportamento del sistema. Tra questi, gli eventi personalizzati di Metricalp si distinguono come strumenti versatili per tracciare azioni e occorrenze specifiche all'interno della tua applicazione. Che si tratti di catturare clic, invii di moduli o anche errori, gli eventi personalizzati consentono agli sviluppatori di ottenere una comprensione più profonda del comportamento degli utenti e delle prestazioni del sistema.

Considera lo scenario del monitoraggio degli errori. Quando si verifica un errore, non si tratta solo di identificare il problema, ma di comprenderne il contesto e l'impatto sugli utenti. I log di errore tradizionali possono fornire dettagli tecnici, ma spesso mancano le informazioni contestuali cruciali necessarie per una risoluzione efficace. È qui che gli eventi personalizzati brillano.

Monitoraggio degli Errori con Eventi Personalizzati e Proprietà Personalizzate

Immagina uno scenario in cui un utente riscontra un errore mentre utilizza la tua applicazione. Invece di fare affidamento solo sui registri di errore generici, puoi implementare un evento personalizzato specificamente progettato per catturare queste occorrenze. Approfondiamo come si svolge questo processo:

Per prima cosa, in Metricalp puoi consentire tutti gli eventi personalizzati o puoi specificare quelli consentiti nelle impostazioni del Tracker.

La bellezza di Metricalp è che puoi avere diverse proprietà personalizzate per ogni evento personalizzato. Puoi anche definire alias di proprietà personalizzate per eventi personalizzati nelle impostazioni del Tracker.

Puoi ottenere ulteriori informazioni sugli alias delle proprietà personalizzate e sugli eventi personalizzati nella documentazione correlata.

Ora impariamo come utilizzare questi eventi personalizzati e proprietà per il monitoraggio degli errori passo dopo passo.

Definizione dell'Evento: Definisci un evento personalizzato chiamato "error" all'interno del tuo sistema di monitoraggio. Questo evento fungerà da indicatore per catturare gli errori nella tua applicazione.

Se hai permesso tutti gli eventi personalizzati nelle impostazioni del Tracker, non devi definirlo da nessuna parte. Puoi iniziare a produrre qualsiasi evento (come "error") dal primo giorno. Ma se hai limitato gli eventi consentiti (come nel nostro esempio), allora devi consentire l'evento "error" nelle impostazioni del Tracker.

Contesto dell'Errore: Allegare proprietà personalizzate all'evento "error" per fornire contesto e dettagli. Queste proprietà potrebbero includere "error_title" per descrivere la natura dell'errore e "error_message" per fornire ulteriori informazioni o indicazioni.

Come descritto nella documentazione, puoi sempre allegare proprietà personalizzate come "{ type:"error", custom_prop1: "my_value" }". Ma sappiamo che custom_prop1 non è... leggibile. La bellezza di Metricalp è che puoi definire diversi alias di proprietà personalizzate per evento. Poi puoi usare questi alias durante la produzione degli eventi: "{ type:"error", error_title: "my_value" }"

Ora definiremo anche alias delle proprietà personalizzate per il nostro evento di errore "error".

Abbiamo definito gli alias "error_title", "error_message", "user_id", "env", "app_version" per il nostro evento "error".

Ora è più leggibile e prezioso per l'analisi. Fantastico, vero?

Ora produrremo il nostro evento personalizzato quando intercettiamo un errore. Ci sono diversi modi per produrre eventi personalizzati. Se usi React o NextJS, puoi usare il metodo dalla libreria di integrazione come descritto nella documentazione. Se stai usando l'integrazione pura, controlla la documentazione sugli eventi personalizzati.

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',
    });
  }

Ecco tutto. Ora abbiamo iniziato a raccogliere i log degli errori nel modo corretto. Controlliamo il nostro dashboard.

Abbiamo i nostri errori, evviva. So che avere errori non è positivo, ma se possiamo catturarli, possiamo risolverli. Ora, quando selezioniamo il nostro evento di errore, possiamo vedere proprietà personalizzate come user_id ecc.

Ma non solo, abbiamo anche tutti i nostri dati standard come il browser dell'utente, il sistema operativo ecc. Quindi ora abbiamo tutti i dettagli sull'errore. Possiamo rilevarlo e correggerlo senza problemi.

Supponiamo di aver rilevato un errore 'xxx is not a function' nella proprietà personalizzata. Allora possiamo selezionare semplicemente quella proprietà personalizzata come filtro e cercare direttamente il browser, il dispositivo degli utenti per quell'errore. Se diciamo che il 95%+ è il browser Safari, allora bang, abbiamo trovato il bug. È un problema di compatibilità con il browser.

Con Metricalp puoi trovare la causa di qualsiasi errore. È un problema di sistema operativo? Dispositivo mobile o paese dell'utente? Tutti i casi possono essere analizzati in Metricalp.

Detto ciò, Metricalp non è solo uno strumento di analisi. Lo abbiamo utilizzato qui come cattura errori. È davvero fantastico avere sistemi robusti e sicuri. Ma non è limitato a questo, puoi utilizzare eventi e proprietà personalizzate per qualsiasi scenario. Ad esempio, puoi utilizzarlo per i tuoi test A/B. Puoi utilizzarlo per il monitoraggio delle conversioni. Dipende dalle tue esigenze e dalla tua immaginazione. Metricalp elimina i confini.

Ora hai imparato come puoi utilizzare Metricalp per catturare e tracciare errori nel modo giusto.