Verifiche stato

I controlli di integrità analizzano gli schemi e le identità utilizzati nella sandbox e forniscono un riepilogo dei problemi che è possibile utilizzare per esplorare e risolvere i problemi con l’Assistente AI. In futuro, sarà possibile eseguire la scansione di un numero maggiore di oggetti per ottenere un rapporto più completo.

Configurazioni di schema e identità inadeguate causano significativi problemi a valle, tra cui creazione di profili errata, qualificazione dei segmenti non riuscita e attivazione imprecisa. Questi problemi sono difficili da rilevare e spesso richiedono competenze specialistiche da diagnosticare. I controlli di integrità spostano l'approccio dalla risoluzione reattiva dei problemi alla manutenzione proattiva e preventiva.

I controlli di integrità consentono di:

  • Rileva problemi di configurazione in anticipo: identifica best practice mancanti, configurazioni non corrette e pattern che causano inefficienze nella personalizzazione, nell'attivazione e altro ancora.
  • Ricevi correzione guidata: ottieni indicazioni chiare su ogni problema e su come risolverlo.
  • Monitoraggio continuo: attualmente, i controlli di integrità eseguono scansioni automatiche giornaliere in modo da poter rilevare i problemi prima che diventino errori critici. La pianificazione potrebbe cambiare nelle versioni future.

Prerequisiti prerequisites

Per accedere ai controlli di integrità, è necessario disporre dell'autorizzazione View Health Checks di controllo di accesso. Contatta l’amministratore di sistema per assicurarti di disporre delle autorizzazioni appropriate.

Accedere ai controlli di integrità access-health-checks

Per accedere ai controlli di integrità dall'interfaccia utente Experience Platform:

  1. Selezionare Run and Operate dal menu di navigazione a sinistra.
  2. Seleziona Health Checks.

Nel dashboard dei controlli di integrità viene visualizzato un riepilogo dei risultati dell'analisi più recente.

Verifica stato dashboard che mostra gli oggetti valutati, i risultati della scansione e i problemi identificati

Informazioni sul dashboard understanding-dashboard

Il dashboard dei controlli di integrità fornisce tre aree di informazioni per aiutarti a valutare lo stato dell’implementazione.

Oggetti valutati objects-evaluated

La sezione Objects evaluated mostra il numero totale di schemi e spazi dei nomi di identità analizzati, insieme al numero di problemi rilevati per ogni categoria. Questo offre una visualizzazione rapida dell’ambito e della gravità dei problemi di configurazione nella sandbox.

Risultati dell’analisi scan-results

Nella sezione Scan results viene visualizzato il numero di controlli non riusciti. Un controllo non riuscito indica che uno o più controlli di integrità hanno rilevato problemi di configurazione che richiedono attenzione. L'ultima analisi dell'integrità giornaliera completata il timestamp indica quando è stata eseguita l'analisi più recente.

Problemi identificati identified-issues

La sezione Identified issues mostra una scheda per ogni controllo di integrità. Ogni scheda mostra:

  • Il nome del controllo di integrità e una breve descrizione del problema.
  • Il numero di problemi rilevati o una conferma dell’assenza di problemi.
  • Un indicatore di stato che indica se il controllo è stato superato o richiede attenzione.

Seleziona una scheda per esplorare i dettagli di quel controllo di integrità.

Controlli di integrità disponibili available-health-checks

I controlli di integrità valutano attualmente cinque aree fondamentali della configurazione dello schema e dell’identità. Questi controlli riguardano i problemi di modellazione dei dati più incisivi in tutta la piattaforma.

Convalida campo identità identity-field-validation

Esegue la scansione per garantire che i campi di identità abbiano vincoli di lunghezza minima e massima e regole di pattern regex per l’integrità dei dati.

Dettaglio
Descrizione
Problema
Nei campi contrassegnati come identità manca la lunghezza minima/massima o la convalida del pattern.
Impatto
Senza convalida, i valori di Garbage possono immettere Identity Service. Valori come "0", "Guest" o maiuscole/minuscole non corrispondenti (ad esempio, "xyz123" versus "XYZ123") compromettono l'integrità del profilo assemblato durante la segmentazione e l'attivazione.
Rimedio
Imposta la lunghezza minima/massima e i vincoli di pattern sui campi personalizzati contrassegnati come identità. Utilizza espressioni regolari per applicare regole quali solo cifre, lettere maiuscole o minuscole o combinazioni di caratteri specifiche.

Quando selezioni la scheda Identity Field Validation, a destra viene visualizzato un pannello dei dettagli. Il pannello mostra:

  • Description: esegue la scansione per verificare che i campi di identità abbiano lunghezza minima/massima e regole di pattern regex per l'integrità dei dati. Elenca gli schemi e i campi interessati.
  • Impact: se i campi di identità negli schemi non hanno lunghezza minima/massima e le convalide dei modelli impostate, si potrebbero verificare dati incoerenti che potrebbero compromettere l'integrità e la qualità dei dati.
  • General areas of impact: identificatori di bassa qualità in Identity Service; unione inaffidabile.
  • Experience League Documentation: collegamento alle best practice per la modellazione dei dati.
  • Affected Schemas: elenco degli schemi interessati, ciascuno con un modulo di espansione per visualizzare ulteriori dettagli e un collegamento per aprire lo schema.

Pannello dei dettagli Convalida campo identità con descrizione, impatto e schemi interessati

Per ulteriori informazioni, vedere i suggerimenti sull'integrità dei dati nella documentazione sulle best practice per gli schemi.

Regole di collegamento del grafo identità identity-graph-linking-rules

Verifica che le regole di collegamento del grafo delle identità siano configurate per una sandbox per impedire la compressione dei profili.

Dettaglio
Descrizione
Problema
Le regole di collegamento del grafo delle identità non sono configurate per questa sandbox.
Impatto
Senza regole di collegamento, più profili diversi possono unirsi in un unico profilo (compressione del grafico). Alcuni dati provenienti da dispositivi condivisi o da identità non univoche possono attivare unioni indesiderate, che portano a una personalizzazione imprecisa.
Rimedio
Passare al menu Identities, selezionare Settings e selezionare almeno un'identità univoca per ogni grafico. Questo abilita le regole di collegamento del grafo delle identità e impedisce la compressione del profilo.

Quando selezioni la scheda Identity Graph Linking Rules, a destra viene visualizzato un pannello dei dettagli. Il pannello mostra:

  • Description: verifica che le regole di collegamento corrette siano configurate per impedire la compressione dei profili. Mostra lo stato della regola corrente e identità univoche per grafico.
  • Impact: se le regole di collegamento del grafico delle identità non sono impostate, alcuni dati potrebbero tentare di unire più profili diversi in un unico profilo. Per evitare unioni indesiderate, è necessario utilizzare le configurazioni fornite tramite le regole di collegamento del grafico delle identità.
  • General areas of impact: profili compressi o uniti.
  • Experience League Documentation: collegamento alla panoramica delle regole di collegamento del grafico identità per ulteriori informazioni.
  • Configure linking rules: quando il controllo non riesce, viene visualizzato un pulsante che consente di configurare le regole di collegamento direttamente dal pannello.

Pannello dei dettagli Regole di collegamento del grafico delle identità con descrizione, impatto e pulsante Configura regole di collegamento

Per ulteriori informazioni, consulta la panoramica delle regole di collegamento del grafo delle identità e la guida all'implementazione.

Configurazione dell’identità di persone e non persone people-non-people-identity

Convalida l’uso corretto dei tipi di identità persone e non persone nelle classi dello schema.

Dettaglio
Descrizione
Problema
Gli identificatori non persone vengono utilizzati negli schemi di profilo individuale o di classe di Experience Event, oppure negli schemi di ricerca.
Impatto
Gli identificatori non persone negli schemi di profilo non partecipano al grafico delle identità, il che porta a una risoluzione incompleta delle identità. Gli identificatori delle persone negli schemi di ricerca aumentano il conteggio dei profili e rendono i dati non idonei per i casi di utilizzo della ricerca. Entrambi i casi rischiano di compromettere l’implementazione con miglioramenti futuri del prodotto.
Rimedio
Rivedi gli schemi con flag e correggi le assegnazioni del tipo di identità. Se possibile, rimuovi gli identificatori non relativi alle persone dagli schemi dei singoli profili. Per gli schemi già in uso dai set di dati, fai riferimento alle regole di evoluzione dello schema.

Quando selezioni la scheda People & Non-People Identity Config, a destra viene visualizzato un pannello dei dettagli. Il pannello mostra:

  • Description: convalida l'uso corretto dei tipi di identità tra le classi dello schema. Elenca gli schemi non configurati correttamente ed evidenzia le assegnazioni errate.
  • Impact: se a un'entità non-people viene assegnata un'identità di persona, il conteggio dei profili verrà gonfiato e questi dati non saranno idonei per la ricerca. Se a un’entità persona viene assegnata un’identità non-people, i dati non sono disponibili per lo streaming o la segmentazione Edge.
  • General areas of impact: grafici di identità incompleti; conteggi di profili gonfiati; utilizzo errato della ricerca.
  • Affected Schemas: elenco di schemi con problemi. Espandi una riga di schema per visualizzare il percorso, il nome dell’identità e il tipo di schema per ogni configurazione errata. Utilizza l’icona del collegamento per aprire lo schema.

Pannello di dettaglio Configurazione identità persone e non persone con descrizione, impatto e schemi interessati con righe espandibili

Per ulteriori informazioni, consulta la documentazione sul tipo di identità e le best practice per gli schemi.

Descrizione dello spazio dei nomi dell’identità personalizzata namespace-missing-description

Esegue la scansione per verificare che i metadati e le descrizioni dello spazio dei nomi delle identità personalizzate siano completi.

Dettaglio
Descrizione
Problema
Il campo di descrizione degli spazi dei nomi di identità personalizzati non è presente.
Impatto
Le descrizioni mancanti possono causare confusione durante l’utilizzo e il debug.
Rimedio
Documenta ogni spazio dei nomi personalizzato compilando il campo di descrizione. Includi criteri di convalida (lunghezza minima/massima, modello) e informazioni sul ciclo di vita che identificano il sistema di origine esterno che crea tali identità.

Quando selezioni la scheda Custom Identity Namespace Description, a destra viene visualizzato un pannello dei dettagli. Il pannello mostra:

  • Description: esegue la scansione per verificare che i metadati e le descrizioni dello spazio dei nomi siano completi. Visualizza spazi dei nomi e proprietari con campi di descrizione vuoti.
  • Impact: l'impostazione di una descrizione in uno spazio dei nomi di identità personalizzato migliora la chiarezza fornendo il contesto dello scopo di ogni spazio dei nomi. In questo modo i membri del team e le parti interessate possono comprendere rapidamente la funzione di ogni spazio dei nomi senza confusione.
  • General areas of impact: errore o confusione nell'utilizzo; intento di convalida non chiaro.
  • Experience League Documentation: collegamento per creare spazi dei nomi personalizzati per ulteriori informazioni.
  • Affected namespaces: elenco di spazi dei nomi di identità personalizzati per i quali mancano descrizioni. Utilizza l’icona del collegamento accanto a ogni spazio dei nomi per visualizzarlo o modificarlo.

Pannello dei dettagli Descrizione dello spazio dei nomi dellidentità personalizzato che mostra la descrizione, limpatto e lelenco degli spazi dei nomi interessati

Per ulteriori informazioni, consulta la documentazione su creazione di spazi dei nomi personalizzati.

Spazio dei nomi identità obsoleto deprecated-namespace

Rileva gli spazi dei nomi di identità obsoleti o non utilizzati che devono essere contrassegnati per la pulizia.

Dettaglio
Descrizione
Problema
Gli spazi dei nomi di identità obsoleti non sono contrassegnati come obsoleti.
Impatto
Gli spazi dei nomi inutilizzati o obsoleti creano confusione su ciò che è attivamente in uso e aumentano il rischio di etichettatura errata dei campi di identità.
Rimedio
Rinomina gli spazi dei nomi inutilizzati per includere un prefisso "Non utilizzare" (ad esempio, "Non utilizzare - [nome originale]"). Adobe Experience Platform al momento non supporta l’eliminazione dello spazio dei nomi, pertanto l’approccio consigliato è la ridenominazione.

Quando selezioni la scheda Deprecated Identity Namespace, a destra viene visualizzato un pannello dei dettagli. Il pannello mostra:

  • Description: rileva spazi dei nomi di identità obsoleti o inutilizzati per la pulizia. Elenca gli spazi dei nomi inutilizzati con la marca temporale dell’ultimo utilizzo o il riferimento dello schema.
  • Impact: gli spazi dei nomi di identità non utilizzati in alcuno schema devono essere contrassegnati per la rimozione aggiungendo un tag "DEPRECATED" o "DO NOT USE" ai relativi nomi. L’eliminazione degli spazi dei nomi delle identità non è attualmente supportata.
  • General areas of impact: rischio di confusione e di etichettatura errata.
  • Experience League Documentation: collegamento agli spazi dei nomi delle identità obsolete per ulteriore documentazione.
  • Affected namespaces: elenco di spazi dei nomi di identità obsoleti o inutilizzati. Utilizza l’icona del collegamento accanto a ogni spazio dei nomi per visualizzarlo o gestirlo.

Il pannello dei dettagli dello spazio dei nomi dellidentità è obsoleto e mostra la descrizione, limpatto e lelenco degli spazi dei nomi interessati

Per ulteriori informazioni, vedere l'articolo Experience Cloud knowledge base sugli spazi dei nomi obsoleti.

Passaggi successivi next-steps

Dopo aver esaminato i risultati del controllo di integrità, esplora le risorse seguenti per comprendere meglio:

recommendation-more-help
c1604072-25a3-433d-b636-9be6a295843e