ID de cliente y estados de autenticación customer-ids-and-authentication-states

Junto con el ID de visitante de Experience Cloud, se pueden asociar ID de cliente adicionales y un estado de autenticación a cada visitante.

Estados de autenticación section-68ad4065dfaa437d9070832d6e2bf85c

El setCustomerIDs método acepta múltiples ID de cliente para el mismo visitante. Ayuda a identificar o dirigirse a un usuario individual entre distintos dispositivos. Por ejemplo, puede cargar estos ID como atributos de cliente a Experience Cloud y acceder a estos datos en las distintas soluciones.

A partir del servicio de identidad de Experience Cloud de la versión 1.5 (o posterior), setCustomerIDs incluye el objeto opcional AuthState. AuthState identifica a los visitantes en función de su estado de autenticación (por ejemplo, conectado, desconectado). El estado de autenticación se establece con un valor de estado indicado en la tabla. El estado de autenticación se arroja como un número entero.

Casos de uso para estados de autenticación section-fe9560cc490943b29dac2c4fb6efd72c

Puede asignar estados de autenticación a los usuarios, según las acciones que estén realizando en las propiedades web y si están autenticados. Consulte algunos ejemplos en la tabla siguiente:

Establecimiento de ID de cliente y estados autenticados section-ec4b367d16ad4ac1a1baca9b01f4ee98

Los ID de cliente pueden incluir combinaciones de ID y estados autenticados, como se muestra en los ejemplos siguientes.

// 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
    }
});

Devolución de ID de cliente y estados autenticados section-71a610546188478fa9a3185a01d6e83b

Utilice getCustomerIDs para devolver ID de cliente y estados autenticados relacionados. Este método arroja el estado autenticado de un visitante como un número entero.

Sintaxis

getCustomerIDs devuelve datos con la sintaxis siguiente.

{
    [customerIDType1]:{
        "id":[customerID1],
        "authState":[authState1]
    },
    [customerIDType2]:{
        "id":[customerID2],
        "authState":[authState2]
    }
    ...
}

Ejemplos

Los ID de cliente y los datos de estado de autenticación arrojados deben tener un aspecto similar a los siguientes ejemplos.

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
    }
 }

Compatibilidad con SDK section-861c6b3b1ba645dda133dccb22ec7bb0

El servicio de ID de Experience Cloud admite ID de clientes y estados de autenticación en nuestro código SDK para Android y para iOS. Consulte las bibliotecas de código siguientes:

Aviso para clientes de Analytics y Audience Manager section-3a8e9d51e71c4c6e865184b81ed9d99b

Si va a pasar ID declarados a Audience Manager, el objeto userid deberá coincidir con el código de integración asociado a la fuente de datos. Para obtener más información, consulte la sección Servicio de ID de visitante en la documentación Configurar código de normas de fusión.