Esta página describe el método Server SDK appendIdentityToUrl. Para Web SDK, consulte appendIdentityToUrl.
El método appendIdentityToUrl agrega la identidad del visitante a una dirección URL como parámetro de cadena de consulta denominado adobe_mc. Cuando el visitante sigue la dirección URL a otro dominio de su propiedad, Web SDK o Server SDK de ese dominio lee el parámetro y mantiene el mismo Experience Cloud ID (ECID). Esto evita que el visitante se cuente dos veces en conjuntos de datos que incluyen ambos dominios.
En un servidor, un uso común es añadir la identidad del visitante a una redirección a otro dominio:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const { url } = await visitor.appendIdentityToUrl({
url: "https://shop.example.net/checkout"
});
res.writeHead(302, { Location: url });
res.end();
La URL resultante tiene un aspecto similar al siguiente:
https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg
Si el SDK aún no tiene el ECID del visitante, primero solicita uno al Edge Network. Esa solicitud no está autenticada. Consulte Establecer el tipo de acceso de secuencia de datos.
Si el visitante se ha excluido, o defaultConsent es "out" y el visitante no se ha incluido, el método devuelve la dirección URL sin cambios. También devuelve la dirección URL sin cambios, en lugar de rechazarla, si no puede obtener la identidad del visitante, por ejemplo, debido a un error de red. Cuando debugging está activado, SDK registra una advertencia que incluye Unable to append identity to url.
Opciones options
El método appendIdentityToUrl acepta un objeto con las siguientes propiedades:
url: obligatorio. Dirección URL donde se agrega la identidad del visitante.edgeConfigOverrides: un objeto de anulación configuración de secuencia de datos para esta solicitud.
Objeto Result result
El método appendIdentityToUrl devuelve una promesa. Cuando se resuelve, el objeto result contiene url, la dirección URL con el parámetro de cadena de consulta adobe_mc agregado.