ID de cliente y estados de autenticación

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

El método setCustomerIDs 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.

Importante: Los atributos de clientes y la funcionalidad de los servicios principales requieren el uso de setCustomerIDs (sincronización de ID de clientes). La sincronización de los ID de cliente es un método de identificación opcional para Analytics. Target exige el uso de Visitor.AuthState.AUTHENTICATED para que funcionen los atributos de cliente. Consulte Servicios principales - Cómo activar sus soluciones para ver ejemplos.

Empezando por el servicio Experience Cloud ID v1.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). Usted establece el estado de autenticación con un valor de estado que aparece en la tabla. El estado de autenticación se devuelve como un número entero.

Estado de autenticación Número entero de estado Estado de usuario

Visitor.AuthState.UNKNOWN

0

Desconocido o nunca autenticado.

El valor de desconocido se aplica de manera predeterminada cuando no se usa AuthState con un ID de visitante o no se establece explícitamente en cada página o contexto de la aplicación.

Visitor.AuthState.AUTHENTICATED

1

Autenticado para una instancia, página o aplicación particulares.

Atención: Para poder funcionar correctamente, los atributos de cliente para Target deben tener este estado.

Visitor.AuthState.LOGGED_OUT

2

Desconectado.

Casos de uso para estados de autenticación

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

Estado de autenticación Caso de uso

Visitor.AuthState.UNKNOWN

Este estado podría utilizarse para situaciones tales como:

  • Leer un correo electrónico (esta acción probablemente signifique que el lector es el destinatario previsto, aunque también puede tratarse de un mensaje reenviado).
  • Hacer clic en un vínculo en un mensaje de correo electrónico y llegar a una página de aterrizaje.

Visitor.AuthState.AUTHENTICATED

El usuario está autenticado con una sesión activa en su sitio web o aplicación.

Visitor.AuthState.LOGGED_OUT

El usuario estaba autenticado pero ha cerrado sesión activamente. El usuario quería desconectarse del estado autenticado. El usuario ya no quiere que se le trate como autenticado.

Establecimiento de ID de cliente y estados autenticados

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

Importante:
  • En los ID se distingue entre mayúsculas y minúsculas.
  • Emplee únicamente valores descodificados para sus ID.
  • Los ID de cliente y los estados de autenticación no se almacenan en la cookie de ID de visitante. Deben establecerse para cada página o contexto de aplicación.
  • En los ID de cliente no se debe incluir información de identificación personal. Si actualmente utiliza información de este tipo para identificar a algún visitante (como una dirección de correo electrónico), le recomendamos que almacene una versión con hash o cifrada de la información.
// 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
    },
    "puuid":"550e8400-e29b-41d4-a716-446655440000"
});

// Multiple IDs with identical authentication states
visitor.setCustomerIDs({
    "userid":{
        "id":"67312378756723456",
        "authState":Visitor.AuthState.AUTHENTICATED
    },
    "puuid":{
        "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
    },
    "puuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":Visitor.AuthState.LOGGED_OUT
    }
});

Devolución de ID de cliente y estados autenticados

Utilice getCustomerIDs para devolver ID de cliente y estados autenticados relacionados. Este método devuelve un estado autenticado de 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 datos de ID de cliente y de estado de autenticación devueltos deben tener un aspecto similar al de los ejemplos siguientes.
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},"puuid":{"id":"550e8400-e29b-41d4-a716-446655440000"}}
{
    "userid":{
        "authState":2
    },
    "puuid":{
        "id":"550e8400-e29b-41d4-a716-446655440000",
        "authState":0
    }
 }

Compatibilidad con SDK

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 siguientes bibliotecas de código:

Aviso para clientes de Analytics y Audience Manager

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.