Logo di Performance HubPerformance Hub
Sezione del sito: Documentazione

Risoluzione dei problemi

In questa pagina

Diagnosi a partire dai sintomi per il livello persone/AI. Per problemi di telecamere, registrazione, caricamento o appliance, inizia da Risoluzione dei problemi di TVCC: tutto ciò che segue presuppone che il video funzioni correttamente.

Sulla timeline People non compare nulla

La timeline mostra "No face detections — There are no face detection items in this current view range of the timeline."

  1. Tracciamento delle persone è attivo? È un'impostazione per singola telecamera ed è disattivata per impostazione predefinita: controlla ogni telecamera in Telecamere e dispositivi.
  2. Il filtro della soglia di rilevamento nasconde tutto? Per impostazione predefinita le persone devono avere un numero sufficiente di rilevamenti per un numero sufficiente di minuti per comparire. Disattiva il filtro di soglia: se le persone compaiono, erano solo al di sotto dei minimi.
  3. Controlla la finestra di date: è facile lasciare l'intervallo 1D/2D/3D e il selettore di date sul giorno sbagliato.
  4. La telecamera vede davvero dei volti? Il rilevamento delle persone richiede volti di dimensioni e angolazione utilizzabili. Una telecamera a soffitto che inquadra dritto verso il basso rileva teste, non volti. Controlla l'inquadratura della telecamera nella visualizzazione dal vivo.
  5. Attivazione della funzionalità: se manca l'intera area People o le API restituiscono "People feature is not enabled for this facility", la funzionalità non è attivata; contatta il tuo account manager.

Un membro non viene mai identificato (sempre "Unsure")

È il problema più comune ed è quasi sempre dovuto alla foto:

  1. Controlla lo stato della foto. Nell'elenco People, trova il membro. Un badge "Invalid Photo" (il tooltip mostra il punteggio e il motivo del mancato superamento) o lo stato "Not Processed" indicano che l'abbinamento facciale non ha nulla su cui lavorare. Correggi la foto nel tuo sistema dei membri o modificala direttamente ("Edit Profile" → "Change").
  2. Nessuna foto? Self Learning può comunque identificare il membro tramite la correlazione delle visite: controlla se si trova nella sua coda e verifica che Enhanced AI Analysis sia attivo.
  3. Identificalo manualmente una volta. L'azione "Identify This Person" sul suo profilo unsure lo collega immediatamente e le shadow photo che si accumulano migliorano gli abbinamenti futuri.
  4. Mancati abbinamenti ricorrenti per poco (il popover mostra una somiglianza appena sotto l'85%) → vedi Ottimizzazione del riconoscimento facciale, ma migliora la foto prima di modificare le soglie.

La stessa persona continua a ricevere nuovi profili "Unsure"

Il riconoscimento non collega tra loro le sue visite:

  1. Unisci i duplicati: seleziona i profili sulla timeline e uniscili. Ogni unione consolida i riferimenti facciali e rende più probabile il collegamento alla visita successiva.
  2. Controlla la qualità delle immagini della telecamera: cupole sporche, controluce (una telecamera rivolta verso un ingresso luminoso) e scarsa illuminazione producono tutti foto di riferimento troppo scadenti per l'abbinamento. La soluzione è l'inquadratura della telecamera, non le impostazioni.
  3. Se il problema riguarda l'intera struttura, il preset di qualità degli shadow profile potrebbe essere troppo rigido per la tua illuminazione: vedi la tabella dei sintomi.

Identificata la persona sbagliata

Raro, ma da trattare con serietà:

  1. Correggi il record: apri il profilo della persona e controlla le sue shadow photo: un'unione errata o una foto aggiunta automaticamente sbagliata di solito è visibile. Rimuovi le immagini errate oppure unisci/identifica nuovamente con il membro corretto.
  2. Se il collegamento è stato creato da Self Learning, usa "Unlink" sul record ("the self-learn record will be reverted") e rifiuta la corrispondenza con "Reject" indicando un motivo, in modo che non venga riproposta.
  3. Rendi l'abbinamento più rigido: sposta Member Matching verso Strict: vedi Ottimizzazione del riconoscimento facciale.

Un poster / manichino / televisore continua a comparire come persona

Il sistema funziona come previsto ed esiste una soluzione apposita: inseriscilo in blacklist. Apri il menu della falsa persona → "Add to Blacklist" con un motivo ("e.g. Store Mannequin"). I rilevamenti futuri vengono scartati prima di qualsiasi elaborazione. Se i rilevamenti persistono da una seconda angolazione della telecamera, aggiungi una seconda voce di blacklist a partire da uno di quei rilevamenti.

I report sono vuoti o mancano delle zone

  1. I report sono in ritardo per progettazione: gli snapshot vengono generati durante la notte per il giorno precedente. Una struttura appena configurata vede i dati dal secondo giorno.
  2. "No zones configured — assign cameras to access zones in Settings": le analisi per zona richiedono zone di accesso con telecamere assegnate.
  3. I KPI sembrano bassi rispetto ai check-in: controlla su quali telecamere è attivo Tracciamento delle persone; i dati dei report provengono solo dalle telecamere analizzate.

Le violazioni di accesso sembrano errate

  1. Le false violazioni dopo la configurazione sono quasi sempre errori nelle regole: un piano legittimo che manca dall'elenco dei piani consentiti di una zona. Rivedi le regole Membership Plans della zona prima di attribuire la causa al comportamento dei membri.
  2. Ricorda la definizione: una violazione è una mancata corrispondenza con una regola sui piani ("excluded, or not in the allowed plans"), comprese le finestre temporali di Access Hours. Un membro con il piano giusto all'orario sbagliato commette comunque una violazione.
  3. Le zone aperte non generano mai violazioni: se ti aspetti violazioni da una zona con il badge "Anyone can access", devi prima definire delle regole.
  1. Enhanced AI Analysis deve essere attivo: se è disattivato, la correlazione non viene eseguita affatto (e la sezione delle impostazioni è nascosta).
  2. Controlla la soglia di evidenza: i profili hanno bisogno del numero minimo di visite correlate (predefinito 8). La scheda In Pipeline mostra l'avanzamento per profilo ("N/M visits"); i visitatori poco frequenti impiegano settimane ad accumulare evidenze.
  3. I check-in devono essere sincronizzati: senza dati sui check-in non c'è correlazione. Verifica con lo strumento MCP insights_checkins o con lo stato della tua integrazione Partner.
  4. Una scheda "No Match" molto piena riguarda spesso coppie che arrivano sempre insieme: il sistema si rifiuta di scegliere a caso tra due candidati. Identifica manualmente uno dei due.
  5. Una scheda "Unable to Link" molto piena indica un problema di qualità dei dati del sistema dei membri: in genere record privi dei campi necessari per completare il collegamento.

Un'unione, un'identificazione o un'eliminazione sembra bloccata

Queste operazioni vengono eseguite come processi in background monitorati: riattribuire una lunga cronologia di rilevamenti richiede tempo. Le schede mostrano stati temporanei ("PROCESSING", "DELETING..."); le unioni mostrano "Processing N of M…" con un'opzione "Retry Failed" in caso di errore parziale e le eliminazioni non riuscite mostrano "DELETE FAILED - RETRY". Riprova una volta prima di contattare l'assistenza con l'ID della persona ("Copy Person ID").

Quando contatti l'assistenza

Includi: il nome della struttura, il Person ID (copiabile dal menu di qualsiasi riquadro o dal profilo), la telecamera coinvolta, la finestra di data/ora e, per i problemi di identificazione, se lo stato della foto del membro è valido. Screenshot anonimizzati del popover (che mostra il punteggio di somiglianza) accelerano la maggior parte delle indagini sull'abbinamento.