Documentazione / Usare CloseYourIt
Session replay
Registra la navigazione di chi usa il sito e la riguardi come un video, anche accanto a un errore.
Il Session replay registra la navigazione di chi usa il tuo sito e te la restituisce come un video. Serve quando una segnalazione non si riesce a riprodurre: invece di ricostruire i passi a parole, li guardi.
Accendere le registrazioni
Servono due cose insieme: l'interruttore sul progetto e il codice nelle pagine. Con una sola delle due non arriva nessuna sessione, e nessuno te lo segnala.
- Il progetto deve avere la piattaforma Web: le sessioni si registrano solo lì.
- Nelle Impostazioni del progetto accendi Registra le sessioni.
- Incolla questo codice nelle pagine del sito, dentro l'intestazione:
<script src="https://cdn.jsdelivr.net/npm/rrweb@2/umd/rrweb.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/@bussolabs/closeyourit-js@0/dist/closeyourit.min.js"></script>
<script>
CloseYourIt.init({
endpointUrl: "https://bugs.example.com",
publicKey: "<chiave pubblica del progetto>",
projectId: "<id del progetto>",
environment: "production",
replay: true,
})
</script>
La prima riga carica la parte che registra davvero. Senza, il resto funziona e le registrazioni no, in silenzio. Tienila prima delle altre.
La guida nell'app ti dà lo stesso codice già compilato per il progetto che scegli. Le altre opzioni dell'SDK sono in JavaScript.
Cosa resta nascosto
La registrazione parte già oscurata. Copre sia quello che la persona scrive sia quello che la pagina le mostra:
| Opzione | Di base | Cosa fa |
|---|---|---|
replayMaskAllInputs | true | oscura il contenuto di tutti i campi da compilare |
replayMaskTextSelector | "*" | oscura il testo di tutti gli elementi della pagina |
replayBlockSelector | nessuno | esclude del tutto gli elementi indicati: non vengono registrati |
Per vedere il testo in chiaro passi un selettore più stretto. Con replayMaskTextSelector: ".riservato" resta oscurato solo quello che ha la classe riservato; tutto il resto si vede.
CloseYourIt.init({
// ...
replay: true,
replayMaskTextSelector: ".riservato",
replayBlockSelector: ".pagamento",
})
Una registrazione non si corregge dopo: un dato registrato in chiaro si toglie solo cancellando la registrazione. Allarga il testo in chiaro solo dove sei sicuro.
Di chi ha navigato resta solo un'impronta anonima, non il nome né l'email. Serve a capire che due sessioni sono della stessa persona, non a sapere chi è.
Trovare una sessione
La pagina Session replay elenca le sessioni dalla più recente. Per ognuna vedi progetto, utente, pagina d'ingresso, numero di errori, durata e inizio.
- Filtra per Progetto e Ambiente.
- Cerca per pagina d'ingresso.
- Nel filtro Errori scegli Solo con errori per vedere le sessioni in cui è successo qualcosa.
Aprendo una sessione la guardi come un video, con le pagine visitate e gli errori successi durante la navigazione.
Dall'errore alla registrazione
Nella pagina di un errore, sotto i dettagli dell'occorrenza, c'è il riquadro Session replay: la sessione in cui l'errore è successo. Da lì vedi cosa faceva la persona prima del guasto, senza cercare la sessione a mano. Nell'elenco delle occorrenze un simbolo segna quelle che hanno una registrazione.
Se il riquadro dice che non c'è nessuna registrazione, non è un guasto: la registrazione non era accesa, oppure l'errore non arriva da una navigazione sul sito.
Anche le richieste di Assistenza portano la stessa visita: nella richiesta vedi gli errori successi a chi ha scritto.
Quanto restano
Le registrazioni si conservano 30 giorni. Poi vengono cancellate davvero, video compresi.