ID cliente e stati di autenticazione customer-ids-and-authentication-states

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

Stati di autenticazione section-68ad4065dfaa437d9070832d6e2bf85c

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.

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 si imposta con uno dei valori di stato elencati nella tabella. Lo stato di autenticazione viene restituito come numero intero.

Casi d’uso per gli stati di autenticazione section-fe9560cc490943b29dac2c4fb6efd72c

È 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. La tabella seguente riporta alcuni esempi:

Impostazione degli ID cliente e degli stati di autenticazione section-ec4b367d16ad4ac1a1baca9b01f4ee98

Gli ID cliente possono includere combinazioni di ID e stati di identificazione, come indicato nei seguenti esempi.

// 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 section-71a610546188478fa9a3185a01d6e83b

Per restituire gli ID cliente e i relativi stati di autenticazione, utilizza getCustomerIDs. Questo metodo restituisce lo stato di autenticazione di un 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 saranno simili agli esempi seguenti.

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 section-861c6b3b1ba645dda133dccb22ec7bb0

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

Avviso per i clienti Analytics e Audience Manager section-3a8e9d51e71c4c6e865184b81ed9d99b

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.