Show Menu
TOPICS×

ID cliente e stati di autenticazione

Oltre all’ID visitatore di Experience Cloud, puoi associare altri ID cliente e uno stato di autenticazione a ciascun visitatore.

Stati di autenticazione

Il
setCustomerIDs
metodo accetta più ID cliente per lo stesso visitatore. In questo modo puoi identificare o indirizzare un singolo utente in più dispositivi. Ad esempio, puoi caricare gli ID come attributi del cliente in Experience Cloud e accedere ai dati dalle diverse soluzioni.
setCustomerIDs
(sincronizzazione ID cliente) è richiesto per gli attributi dei clienti e le funzionalità dei servizi principali. La sincronizzazione degli ID cliente è un metodo di identificazione facoltativo per Analytics. Target richiede
Visitor.AuthState.AUTHENTICATED
per il funzionamento degli attributi cliente. Alcuni esempi sono disponibili in Servizi principali - Come attivare le proprie soluzioni .
A partire dalla versione 1.5 del servizio Experience Cloud Identity,
setCustomerIDs
include l’oggetto facoltativo
AuthState
.
AuthState
identifica i visitatori in base al loro stato di autenticazione (ad es. connessi o disconnessi). Lo stato di autenticazione deve essere impostato con uno stato indicato nella tabella. Lo stato di autenticazione viene restituito come numero intero.
Stato di autenticazione
Numero intero di stato
Stato dell’utente
Visitor.AuthState.UNKNOWN
0
Utente sconosciuto o mai autenticato.
Lo stato Sconosciuto viene applicato per impostazione predefinita quando
AuthState
non viene usato con un ID visitatore o non è impostato in modo esplicito su ciascuna pagina o contesto dell’applicazione.
Visitor.AuthState.AUTHENTICATED
1
Utente autenticato per un’istanza, pagina o applicazione specifica.
Attenzione: per funzionare correttamente, gli attributi cliente per
Target
devono avere questo stato.
Visitor.AuthState.LOGGED_OUT
2
Utente disconnesso.

Casi d’uso per gli stati di autenticazione

È possibile assegnare gli stati di autenticazione agli utenti, a seconda delle azioni che questi eseguono sulle proprietà Web e del fatto che siano autenticati o meno. Nella tabella di seguito sono illustrati alcuni esempi:
Stato di autenticazione
Caso d’uso
Visitor.AuthState.UNKNOWN
Questo stato potrebbe essere usato quando:
  • si legge un’e-mail (questa azione probabilmente indica che il lettore è il destinatario desiderato, ma l’e-mail potrebbe anche essere stata inoltrata)
  • si fa clic su un elemento dell’e-mail che conduce a una pagina di destinazione.
Visitor.AuthState.AUTHENTICATED
Al momento l’utente è autenticato con una sessione attiva sul sito Web o sull’app.
Visitor.AuthState.LOGGED_OUT
L’utente si è autenticato ma si è disconnesso in modo attivo. L’utente desiderava disconnettersi dallo stato autenticato. L’utente non desidera più essere trattato come utente autenticato.

Impostazione degli ID cliente e degli stati di autenticazione

Gli ID cliente possono includere combinazioni di ID e stati di identificazione, come indicato nei seguenti esempi.
  • Gli ID sono sensibili all’uso di maiuscole e minuscole.
  • Per gli ID, usa solo valori non codificati.
  • Gli ID dei clienti e gli stati di autenticazione non vengono memorizzati nel cookie ID visitatore. Devono essere impostati per ciascuna pagina o contesto dell’applicazione.
  • Negli ID cliente non devono essere incluse informazioni identificative della persona (Personally Identifiable Information, PII). Invece di utilizzare informazioni PII per identificare un visitatore (ad esempio l’indirizzo e-mail), consigliamo di memorizzare una versione con hashing o codificata di queste informazioni. La libreria ECID supporta l’hashing degli identificatori utente. Consulta Supporto di hashing SHA-256 per setCustomerIDs .
// Single ID with a single authentication state visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED } }); /* Multiple IDs with only the first ID explicitly assigned an authentication state. The second ID is not explicitly assigned an authentication state and is implicitly assigned Visitor.AuthState.Unknown by default. */ visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED }, "dpuuid":"550e8400-e29b-41d4-a716-446655440000" }); // Multiple IDs with identical authentication states visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED }, "dpuuid":{ "id":"550e8400-e29b-41d4-a716-446655440000", "authState":Visitor.AuthState.AUTHENTICATED } }); // Multiple IDs with different authentication states visitor.setCustomerIDs({ "userid":{ "id":"67312378756723456", "authState":Visitor.AuthState.AUTHENTICATED }, "dpuuid":{ "id":"550e8400-e29b-41d4-a716-446655440000", "authState":Visitor.AuthState.LOGGED_OUT } });

Restituzione degli ID cliente e degli stati di autenticazione

Per restituire gli ID cliente e i relativi stati di autenticazione, utilizza
getCustomerIDs
. Questo metodo restituisce lo stato di autenticazione del visitatore sotto forma di numero intero.
Sintassi
getCustomerIDs
restituisce i dati con la seguente sintassi.
{ [customerIDType1]:{ "id":[customerID1], "authState":[authState1] }, [customerIDType2]:{ "id":[customerID2], "authState":[authState2] } ... }
Esempi
Gli ID cliente e i dati sullo stato di autenticazione restituiti devono essere simili ai seguenti esempi.
Object customerIDs = visitor.getCustomerIDs(); // No setCustomerIDs call on this instance {} // setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456"}} { "userid":{ "id":"67312378756723456", "authState":0 } } // setCustomerIDs call on this instance with {"userid":{"id":"67312378756723456","authState":Visitor.AuthState.AUTHENTICATED}} { "userid":{ "id":"67312378756723456", "authState":1 } } // setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT}} { "userid":{ "authState":2 } } // setCustomerIDs call on this instance with {"userid":{"authState":Visitor.AuthState.LOGGED_OUT},"dpuuid":{"id":"550e8400-e29b-41d4-a716-446655440000"}} { "userid":{ "authState":2 }, "dpuuid":{ "id":"550e8400-e29b-41d4-a716-446655440000", "authState":0 } }

Supporto per l’SDK

Il servizio Experience Cloud ID supporta gli ID dei clienti e gli stati di autenticazione nel nostro codice SDK per Android e iOS. Vedi le seguenti librerie di codice:

Avviso per i clienti Analytics e Audience Manager

Se trasferisci ID dichiarati ad Audience Manager, l’oggetto
userid
deve corrispondere al codice di integrazione associato a un’origine dati. Per ulteriori informazioni, consulta la sezione Servizio ID visitatore nel documento Configurazione codice delle regole di unione .