Esta página describe el método Server SDK getIdentity. Para Web SDK, consulte getIdentity.
El método getIdentity devuelve el Experience Cloud ID (ECID) del visitante sin enviar datos de evento. Al llamar a sendEvent, Edge Network establece automáticamente la identidad del visitante, por lo que debe usar getIdentity solo cuando el servidor necesite el propio ECID. Por ejemplo, utilícelo para almacenar el ECID con sus propios registros o para pasarlo a otro sistema.
Llamar a getIdentity en el identificador forRequest del visitante:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const result = await visitor.getIdentity({
namespaces: ["ECID"]
});
console.log(result.identity.ECID);
SDK utiliza el siguiente flujo para devolver el ECID:
- SDK comprueba si el consentimiento le permite continuar. Si el visitante se ha excluido,
getIdentityse resuelve con un objeto vacío. - Si la cookie de identidad del visitante está disponible a través del servicio de cookies que pasó a
forRequest, SDK lee el ECID de él sin ponerse en contacto con Adobe. - De lo contrario, SDK solicita la identidad del visitante desde Edge Network, escribe la cookie de identidad a través de su servicio de cookies y devuelve el ECID.
La solicitud a Edge Network no está autenticada. Asegúrese de que la secuencia de datos acepte solicitudes no autenticadas. Consulte Establecer el tipo de acceso de secuencia de datos.
Si no pasa un servicio de cookies a forRequest, SDK no puede encontrar una identidad existente, por lo que cada identificador de forRequest obtiene un nuevo ECID. Ver Instancias y solicitudes.
Opciones options
El método getIdentity acepta un objeto opcional con las siguientes propiedades:
namespaces: una matriz de áreas de nombres de identidad que se van a devolver. Los valores admitidos son"ECID"y"CORE". El valor predeterminado es["ECID"]. Solo puede solicitar el área de nombres"CORE"cuandothirdPartyCookiesEnabledtengatrue. De lo contrario,getIdentitylo rechazará.edgeConfigOverrides: un objeto de anulación configuración de secuencia de datos para esta solicitud.
Objeto Result result
El método getIdentity devuelve una promesa. Cuando se resuelve, el objeto result contiene las siguientes propiedades:
identity.ECID: una cadena que contiene el ECID del visitante.identity.CORE: una cadena que contiene el CORE ID del visitante, si solicitó el área de nombresCORE.edge.regionId: un entero que identifica la región de Edge Network que gestionó la solicitud. Esta propiedad solo está presente cuando SDK contactó con Edge Network para obtener la identidad.
const { identity } = await visitor.getIdentity();
console.log(identity.ECID);