Monitoraggio
Session replay
L’SDK per browser può registrare la pagina come l’ha vista l’utente e caricare il minuto prima di un errore o di una segnalazione di bug. L’impostazione Replay delle sessioni di ogni progetto nella dashboard decide quando registrare, quindi funziona senza modificare il codice, anche in Odoo. Il registratore è un componente separato da 61 KB scaricato da blipit.io solo quando il replay è attivo, così lo script principale resta leggero.
1Scegli quando registra
Apri il progetto in app.blipit.io e scegli un’impostazione di Replay delle sessioni. Su errori e segnalazioni di bug, il valore predefinito per ogni progetto, tiene gli ultimi 60-120 secondi nella memoria del browser e li carica solo quando viene catturato un errore o qualcuno invia una segnalazione, poi continua a registrare; le visite senza problemi non vengono mai caricate. Tutte le visite, a campione registra dall’inizio la quota di visite scelta (dall’1 al 100%), che qualcosa si rompa o no, e mantiene il buffer degli errori sulle altre. Disattivato non carica nulla. Possono cambiarla proprietari, amministratori e chiunque possa modificare il progetto; i browser ricevono la modifica entro circa un’ora.
2Cosa si vede e cosa viene mascherato
Il mascheramento avviene nel browser prima di inviare qualsiasi cosa. Valori digitati, testo della pagina, celle di tabella e nomi dei record diventano asterischi, quindi un campo appare come Cliente: ******. Etichette e pulsanti restano leggibili così puoi seguire cosa ha fatto il visitatore: etichette dei moduli, legende, intestazioni di colonna di tabelle ed elenchi, didascalie, pulsanti, schede, voci di menu, link di navigazione e, in Odoo, le etichette dei campi, la barra di stato, le schede del notebook, il menu delle app e i pulsanti del pannello di controllo. Anche lì cifre, date, email, link e @nomi vengono mascherati, quindi un pulsante appare come Pay $**.**, e sono mascherati anche gli attributi title, alt, aria-label e placeholder. Tutto ciò che si trova in un valore di campo, una cella, una scheda kanban, un’attività o la chat resta mascherato anche se è disegnato come pulsante, e i titoli delle colonne kanban sono mascherati perché possono essere valori raggruppati. Sempre mascherati, anche dentro un’etichetta o un pulsante: campi di input, aree di testo, select e relative opzioni, aree modificabili, celle di tabella e valori dei campi, titoli, breadcrumb, il chatter, le schede kanban, i menu account, utente e profilo e gli elenchi di ricerca e completamento automatico. Immagini, video, audio, canvas, iframe e campi password diventano riquadri vuoti della stessa dimensione, tutto ciò che ha data-blipit-block viene bloccato e i valori simili a token nell’URL vengono oscurati. Per mascherare ogni parola come prima, disattiva Mostra etichette e pulsanti nelle registrazioni nel pannello Session replay del progetto. Aggiungi data-blipit-mask a un elemento per mascherarlo sempre, o data-blipit-unmask per mostrare il testo di quello che scegli; data-blipit-mask ha la precedenza.
<div data-blipit-mask>Always masked</div>
<span data-blipit-unmask>Plan</span>3Guarda un replay
Replay elenca le registrazioni per progetto, con o senza errori, e per URL. Il player ha play, 1x, 2x, 4x, salta l'inattività e un segno rosso per ogni errore che rimanda alla sua issue. Una issue il cui ultimo evento ha un replay mostra Guarda il replay.
4Sovrascriverla nel codice
Un’opzione replay in Blipit.init ha la precedenza sull’impostazione del progetto per quel sito: onErrorSampleRate (predefinito 1) è la quota di visite che mantiene il buffer degli errori, sessionSampleRate (predefinito 0) la quota registrata dall’inizio, e labels: false maschera tutto il testo su quel sito. replay: false disattiva il replay su quel sito qualunque cosa dica il progetto.
Blipit.init({
key: "<public key>",
release: "2026.09.28",
replay: { sessionSampleRate: 0.05, onErrorSampleRate: 1 }
});5App mobili: Android
Il replay delle sessioni su mobile funziona nelle app Android con blipit-android 0.3.0 o successivo, e anche sui dispositivi Huawei, perché l'SDK non usa Google Play services né Firebase. iOS, React Native e Flutter arriveranno presto. Vale la stessa impostazione del progetto: Con errori e segnalazioni di bug tiene in memoria sul dispositivo gli ultimi 30 secondi e li carica solo quando si verifica un errore o qualcuno invia una segnalazione; Tutte le visite, a campione registra per intero la quota di sessioni dell'app che scegli. Il replay richiede Android 8.0 (API 26) o successivo; i dispositivi più vecchi continuano a inviare gli errori, senza replay.
implementation("com.github.blipit-io:blipit-android:v0.7.5")Blipit.init(this) {
key = "<public key>"
project = "<project id>"
}6Chiedi prima il consenso
Non viene registrato nulla finché la tua app non chiama Blipit.setReplayConsent(true); il valore predefinito è false. Mostra la tua informativa (sotto) e chiamalo quando l'utente accetta. La scelta viene salvata sul dispositivo, quindi richiamalo solo quando cambia. Blipit.setReplayConsent(false) interrompe subito la registrazione ed elimina il buffer, quindi offrilo nelle impostazioni della tua app. Blipit.hasReplayConsent() restituisce la scelta attuale.
allowButton.setOnClickListener { Blipit.setReplayConsent(true) }
replaySwitch.isChecked = Blipit.hasReplayConsent()
replaySwitch.setOnCheckedChangeListener { _, on -> Blipit.setReplayConsent(on) }7Cosa registra un replay mobile
Circa un fotogramma al secondo delle schermate della tua app, codificato sul dispositivo come un piccolo video H.264, più tocchi, cambi di schermata, breadcrumb, modello del dispositivo, versione di Android e versione dell'app. Altre app, l'interfaccia di sistema, le notifiche e tutto ciò che accade mentre l'app è in background non vengono mai registrati: la registrazione va in pausa appena l'app passa in background e si ferma dopo 30 secondi. Blipit non usa mai un AccessibilityService né MediaProjection, quindi non c'è alcuna richiesta di cattura dello schermo né servizio in primo piano. La qualità del video si abbassa sulle reti a consumo (dati mobili) e tutto viene inviato via HTTPS solo a Blipit.
8Cosa viene mascherato sul dispositivo
Il mascheramento avviene sul dispositivo prima che un fotogramma venga salvato: tutto il testo, tutte le immagini, tutti i campi di inserimento (EditText e campi di testo di Jetpack Compose), le WebView e i lettori video vengono disegnati come blocchi pieni. Imposta replayLabels = true in Blipit.init per lasciare leggibili etichette e testo dei pulsanti nelle schermate basate su View; campi di inserimento e immagini restano mascherati e le schermate Jetpack Compose restano del tutto mascherate. Aggiungi android:tag="blipit-mask" a una view per mascherarla sempre.
<TextView
android:id="@+id/balance"
android:tag="blipit-mask" />9App per bambini
Lascia il replay spento nelle app rivolte ai bambini (norme Famiglie di Google Play, COPPA, categoria Bambini dell'App Store). Imposta childDirected = true in Blipit.init oppure chiama Blipit.disableReplayForChildApp(); così il replay non parte mai, nemmeno con il consenso.
Blipit.init(this) {
key = "<public key>"
project = "<project id>"
childDirected = true
}10Checklist di conformità per gli store
- Chiedi il consenso prima di registrare qualsiasi cosa: chiama Blipit.setReplayConsent(true) solo dopo che l'utente ha accettato.
- Mostra un'informativa ben visibile nell'app prima di chiedere, con il testo qui sotto.
- Cita Blipit e il replay delle sessioni nella tua informativa privacy; il paragrafo per AppGallery qui sotto va bene per qualsiasi store.
- Compila il modulo Sicurezza dei dati di Google Play e le etichette privacy di AppGallery con le risposte qui sotto.
- Tieni il replay spento nelle app rivolte ai bambini.
- Rispetta la revoca: offri nelle impostazioni dell'app un interruttore che chiama Blipit.setReplayConsent(false).
11Risposte per Sicurezza dei dati di Google Play
Usa queste risposte in Play Console, in Contenuti dell'app > Sicurezza dei dati. I nomi di categorie e finalità sono quelli della console in inglese.
- App activity > App interactions: raccolti, non condivisi, facoltativi. Finalità: App functionality, Analytics.
- App info and performance > Crash logs: raccolti, non condivisi. Finalità: App functionality, Analytics.
- App info and performance > Diagnostics: raccolti, non condivisi. Finalità: App functionality, Analytics.
- Tutti i dati utente raccolti dalla tua app sono criptati in transito? Sì.
- Offri agli utenti un modo per chiedere la cancellazione dei loro dati? Sì.
12Informativa nell'app, pronta da incollare
Mostrala prima di chiedere il consenso, in una schermata o finestra apposita con i pulsanti Consenti e Non ora, e adatta il percorso delle impostazioni alla tua app.
- Questa app registra un video mascherato del tuo schermo e dei tuoi tocchi fino a 30 secondi prima di un errore o di una segnalazione di bug e lo invia al nostro fornitore di monitoraggio degli errori, Blipit, per risolvere i problemi. Testo, immagini e ciò che digiti restano nascosti. Puoi disattivarlo nelle Impostazioni.
13Informativa privacy per Huawei AppGallery
Incolla questo testo nella tua informativa privacy e sostituisci le parti tra parentesi quadre; va bene anche per Google Play e altri store. In AppGallery Connect, dichiara nelle etichette privacy dell'app che un SDK di terze parti raccoglie attività nell'app (interazioni) e diagnostica (log degli arresti anomali), non condivise e non usate per la pubblicità.
- Monitoraggio degli errori e replay delle sessioni. Usiamo Blipit, un servizio di monitoraggio degli errori gestito da Louward Labs FZC LLC (Ajman, EAU), come responsabile del trattamento. Con il tuo consenso, l'app conserva una breve registrazione mascherata delle schermate dell'app stessa (testo, immagini e ciò che digiti vengono nascosti sul tuo dispositivo prima di qualsiasi salvataggio), dei tuoi tocchi e cambi di schermata, del modello del dispositivo, del sistema operativo e della versione dell'app. Viene inviata tramite una connessione criptata (HTTPS) solo quando si verifica un errore, quando invii una segnalazione di bug o per un piccolo campione di sessioni, e viene usata solo per trovare e correggere problemi dell'app. Non viene venduta né usata per la pubblicità. Le registrazioni vengono eliminate automaticamente dopo [7/14/30] giorni. Puoi revocare il consenso in qualsiasi momento in [Impostazioni > Privacy] e chiedere l'accesso ai tuoi dati o la loro cancellazione a [contatto].
14Etichetta privacy dell'App Store (per la versione iOS)
Per il prossimo SDK iOS. In App Store Connect, alla voce App Privacy, dichiara:
- Usage Data > Product Interaction: finalità App Functionality e Analytics.
- Diagnostics > Crash Data e Other Diagnostic Data: App Functionality, Analytics.
- Non collegati all'identità dell'utente, a meno che tu non chiami Blipit.setUser; in quel caso indicali come collegati.
- Non usati per il tracciamento (tracking).
Buono a sapersi
- Replay al mese: Free 25, Solo 500, Team 2.500, Scale 5.000, conservati 7 giorni su Free, 14 su Solo e 30 su Team e Scale. Esauriti i replay del mese, l’impostazione del progetto risponde Disattivato fino al mese successivo e non viene addebitato nulla.
- Una registrazione si ferma dopo 60 minuti, 500 segmenti o 20 MB. I chunk partono ogni 10 secondi o a 1 MB, gzippati, e l'ultimo alla chiusura della scheda.
- Sui siti web lo script Blipit per browser registra i replay; nelle app Android li invia l'SDK Blipit per Android.
- I replay mobili condividono la quota mensile e la conservazione dei replay web, e i loro file video vengono eliminati insieme al replay.
Bloccato? Scrivi a support@blipit.io. Le chiavi e l'id di ogni progetto sono sotto Chiavi API in app.blipit.io.