appendIdentityToUrl
El comando appendIdentityToUrl le permite agregar un identificador de usuario a la dirección URL como una cadena de consulta. Esta acción le permite transferir la identidad de un visitante entre dominios, lo que evita recuentos de visitantes duplicados para conjuntos de datos que incluyen dominios o canales. Está disponible en las versiones 2.11.0 o posteriores del SDK web.
La cadena de consulta generada y anexada a la dirección URL es adobe_mc. Si el SDK web no encuentra un ECID, llama al extremo /acquire para generar uno.
Anexar identidad a una URL mediante la extensión del SDK web extension
La adición de una identidad a una dirección URL se realiza como una acción dentro de una regla de la interfaz de etiquetas de recopilación de datos de Adobe Experience Platform.
- Inicie sesión en experience.adobe.com con sus credenciales de Adobe ID.
- Vaya a Recopilación de datos > Etiquetas.
- Seleccione la propiedad de etiquetas que desee.
- Vaya a Reglas y luego seleccione la regla que desee.
- En Acciones, seleccione una acción existente o cree una acción.
- Establezca el campo desplegable Extension en SDK web de Adobe Experience Platform y establezca Action Type en Redirect with identity.
- Haga clic en Conservar cambios y, a continuación, ejecute el flujo de trabajo de publicación.
Este comando suele utilizarse con una regla específica que escucha clics y comprueba los dominios deseados.
Déclencheur cuando se hace clic en una etiqueta delimitadora con una propiedad href.
- Extensión: Principal
- Tipo de evento: haga clic en
- Cuando el usuario hace clic en: Elementos específicos
- Elementos que coinciden con el selector de CSS:
a[href]
Déclencheur solo en los dominios deseados.
- Tipo de lógica: Normal
- Extensión: Principal
- Tipo de condición: Comparación de valor
- Operando Izquierdo:
%this.hostname% - Operador: coincide con la expresión regular
- Operando derecho: Una expresión regular que coincide con los dominios deseados. Por ejemplo,
adobe.com$|behance.com$
Anexe la identidad a la dirección URL.
- Extensión: SDK web de Adobe Experience Platform
- Tipo de acción: redireccionar con identidad
Anexar la identidad a una URL mediante la biblioteca JavaScript del SDK web
Ejecute el comando appendIdentityToUrl con una dirección URL como parámetro. El método devuelve una dirección URL con el identificador anexado como cadena de consulta.
alloy("appendIdentityToUrl",document.location);
Puede agregar un detector de eventos para todos los clics recibidos en la página y comprobar si la dirección URL coincide con algún dominio deseado. En caso afirmativo, anexe la identidad a la dirección URL y redirija al usuario.
document.addEventListener("click", event => {
// Check if the click was a link
const anchor = event.target.closest("a");
if (!anchor || !anchor.href) return;
// Check if the link points to the desired domain
const url = new URL(anchor.href);
if (!url.hostname.endsWith(".adobe.com") && !url.hostname.endsWith(".behance.com")) return;
// Append the identity to the URL, then direct the user to the URL
event.preventDefault();
alloy("appendIdentityToUrl", {url: anchor.href}).then(result => {document.location = result.url;});
});
Objeto Response
Si decide controlar las respuestas con este comando, el objeto response contiene url, la nueva dirección URL con información de identidad agregada como parámetro de cadena de consulta.