Qual è il vantaggio di etichettare i campi di dati come identità?

Etichettare alcuni campi di dati come identità nei dati di record e serie temporali consente di mappare le relazioni di identità all’interno della struttura naturale dei dati e riconciliare i dati duplicati tra canali diversi. Per ulteriori informazioni, consulta Panoramica del servizio Identity.

Cosa sono le identità note e anonime?

Un’identità nota si riferisce a un valore di identità che può essere utilizzato da solo o con altre informazioni per identificare, contattare o individuare una singola persona. Esempi di identità note possono includere indirizzi e-mail, numeri di telefono e CRMID.

Un’identità anonima si riferisce a un valore di identità che non può essere utilizzato da solo o con altre informazioni per identificare, contattare o individuare una singola persona (ad esempio un ID cookie).

Cos’è un grafico dell’identità privata?

Un grafo di identità privata è una mappa privata delle relazioni tra identità collegate e unite, visibile solo all’organizzazione.

Quando più identità sono incluse in qualsiasi dato acquisito da un endpoint di streaming o inviato a un set di dati abilitato per Identity Service, tali identità sono collegate nel grafo delle identità private. Identity Service sfrutta questo grafico per ottenere le identità per un determinato consumatore o entità, consentendo l'unione di identità e profili.

Come si creano più campi di identità in uno schema XDM?

Gli schemi Experience Data Model (XDM) supportano più campi di identità. Qualsiasi campo dati di tipo string all'interno di uno schema che implementa la classe XDM Individual Profile o XDM ExperienceEvent può essere etichettato come campo di identità. Una volta etichettati, tutti i dati contenuti in questi campi vengono aggiunti alla mappa di identità del profilo.

Per i passaggi su come etichettare un campo XDM come campo di identità tramite l'interfaccia utente, vedi la sezione Identità nell'esercitazione dell'Editor di schema. Se utilizzi l'API, consulta la sezione del descrittore di identità nell'esercitazione sull'API del registro degli schemi.

Esistono contesti in cui alcuni campi non devono essere etichettati come identità?

I campi di identità devono essere riservati a valori univoci per ogni singolo utente. Ad esempio, considera un set di dati per un programma fedeltà dei clienti. Il campo "livello di fedeltà" (oro, argento, bronzo) non sarebbe un campo di identità utile, mentre l’ID di fedeltà (un valore univoco) sarebbe.

Campi come i codici postali e gli indirizzi IP non devono essere etichettati come identità per singoli utenti, in quanto questi valori possono essere applicati a più di una singola persona. Questi tipi di campi dovrebbero essere etichettati solo come identità per le strategie di marketing a livello familiare.

Perché i campi di identità non collegano come previsto?

Utilizzando l'endpoint /cluster/members nell'API del servizio Identity, è possibile visualizzare le identità associate per uno o più campi di identità. Se la risposta non restituisce le identità collegate previste, assicurati di fornire le informazioni di identità appropriate nei dati XDM. Per ulteriori informazioni, consulta la sezione relativa alla fornitura di dati XDM al servizio Identity nella panoramica del servizio Identity.

Che cos’è uno spazio dei nomi delle identità?

Uno spazio dei nomi delle identità fornisce contesto per il modo in cui i campi di identità si relazionano all’identità di un cliente. Ad esempio, i campi di identità nello spazio dei nomi "E-mail" devono essere conformi a un formato e-mail standard (nome@emailprovider.com), mentre i campi che utilizzano lo spazio dei nomi "Telefono" devono essere conformi a un numero di telefono standard (ad esempio 987-555-1234 in Nord America).

Gli spazi dei nomi distinguono valori di identità simili tra sistemi di gestione delle relazioni con i clienti diversi. Ad esempio, considera un profilo che contiene un ID fedeltà numerico associato al programma di premi della tua azienda. Uno spazio dei nomi di "Fedeltà" separerebbe questo valore da un ID numerico simile per il sistema di eCommerce che appare anche nello stesso profilo.

Per ulteriori informazioni, consulta la panoramica dello spazio dei nomi delle identità.

Come si associa un’identità a uno spazio dei nomi delle identità?

I campi di identità devono essere associati a uno spazio dei nomi di identità esistente al momento della creazione. Qualsiasi nuovo spazio dei nomi deve essere creato utilizzando l'API prima di associarlo ai campi di identità.

Per istruzioni dettagliate sulla definizione di uno spazio dei nomi durante la creazione di un descrittore di identità tramite l'API, consulta la sezione creazione di un descrittore nella guida per gli sviluppatori del registro dello schema. Per contrassegnare un campo schema come identità nell'interfaccia utente, seguire i passaggi descritti nell'esercitazione Editor schema.

Quali sono gli spazi dei nomi di identità standard forniti da Experience Platform?

Gli spazi dei nomi di identità standard sono spazi dei nomi disponibili per tutte le organizzazioni. Per un elenco completo degli spazi dei nomi standard disponibili, consulta la Panoramica sugli spazi dei nomi delle identità.

Dove posso trovare l’elenco degli spazi dei nomi di identità disponibili per la mia organizzazione?

Utilizzando l'API del servizio Identity, puoi elencare tutti gli spazi dei nomi di identità disponibili per la tua organizzazione effettuando una richiesta GET all'endpoint /idnamespace/identities. Per ulteriori informazioni, consulta la sezione su elenco degli spazi dei nomi disponibili nella panoramica dell'API del servizio Identity.

Come si crea uno spazio dei nomi personalizzato per l’organizzazione?

Utilizzando l'API Identity Service, puoi creare uno spazio dei nomi di identità personalizzato per la tua organizzazione effettuando una richiesta POST all'endpoint /idnamespace/identities. Per ulteriori informazioni, consulta la sezione sulla creazione di uno spazio dei nomi personalizzato nella panoramica dell'API del servizio Identity.

Cosa sono le identità composite e gli XID?

Nelle chiamate API viene fatto riferimento alle identità tramite l’identità composita o XID. Un’identità composita è una rappresentazione di un’identità che contiene un valore ID e uno spazio dei nomi. Un XID è un identificatore a valore singolo che rappresenta lo stesso costrutto di un’identità composita (un ID e uno spazio dei nomi) e viene assegnato automaticamente alle nuove identità quando viene mantenuto da Identity Service. Per ulteriori informazioni, consulta la Panoramica API del servizio Identity.

In che modo il servizio Identity gestisce le informazioni personali (PII, personally identifiable information)?

Identity Service dispone di spazi dei nomi standard per supportare l’acquisizione di valori di identità con hash per numeri di telefono e e-mail. Tuttavia, sei responsabile dell’hashing dei valori. Per ulteriori informazioni sull'hashing dei dati acquisiti in Experience Platform, consulta la Data Prep guida alle funzioni di mappatura.

Ci sono considerazioni quando si esegue l’hashing di identità basate su PII?

Se invii valori PII con hash a Identity Service, devi utilizzare lo stesso metodo di crittografia nei set di dati. In questo modo lo stesso valore di identità in tutti i set di dati genera gli stessi valori con hash e può essere correttamente associato e collegato nel grafico delle identità.

Perché non posso accedere alla pagina o alle API del grafo delle identità?

L'amministratore di Experience Platform deve richiedere l'autorizzazione view-identity-graph per poter visualizzare i dati del grafico delle identità. Senza questa autorizzazione, riceverai un messaggio di autorizzazione negata nella pagina del visualizzatore del grafico delle identità e quando chiami le API di Experience Platform. Per ulteriori informazioni sulle autorizzazioni, vedere la panoramica sul controllo degli accessi.

Risoluzione dei problemi

Nella sezione seguente vengono forniti suggerimenti per la risoluzione dei problemi relativi a codici di errore specifici e a possibili comportamenti imprevisti durante l'utilizzo dell'API Identity Service.

Identity Service messaggi di errore

Di seguito è riportato un elenco di messaggi di errore che è possibile visualizzare quando si utilizza l'API Identity Service.

Parametro di query richiesto mancante

{
    "title": "InvalidInput",
    "status": 400,
    "detail": "Missing required query parameter - namespace"
}

Questo errore viene visualizzato quando un parametro di query richiesto non è stato incluso nel percorso della richiesta. Il detail del messaggio di errore fornisce il nome del parametro mancante. Le varianti di questo messaggio di errore includono:

  • Parametro query richiesto mancante - nsId
  • Parametro query richiesto mancante - ID
  • Parametro query richiesto mancante: xid o (nsid,id)
  • Parametro query richiesto mancante - targetNs
  • Parametro query richiesto mancante: xids o compositeXids

Prima di riprovare, verifica di includere correttamente il parametro indicato nel percorso della richiesta.