appendIdentityToUrl

El appendIdentityToUrl El comando 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 a la variable /acquire extremo para generar uno.

NOTE
Si no se ha proporcionado el consentimiento, la dirección URL de este método se devuelve sin cambios. Este comando se ejecuta inmediatamente; no espera una actualización de consentimiento.

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.

  1. Iniciar sesión en experience.adobe.com usando sus credenciales de Adobe ID.
  2. Vaya a Recopilación de datos > Etiquetas.
  3. Seleccione la propiedad de etiquetas que desee.
  4. Vaya a Reglas, luego seleccione la regla que desee.
  5. En Acciones, seleccione una acción existente o cree una acción.
  6. Configure las variables Extensión campo desplegable a SDK web de Adobe Experience Platform y configure el Tipo de acción hasta Redirigir con identidad.
  7. Clic Conservar cambios, luego 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.

Criterios de evento de regla

Déclencheur cuando una etiqueta de anclaje con un href se hace clic en la propiedad.

  • Extensión: Core
  • 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]

Evento de regla

Condición de regla

Déclencheur solo en los dominios deseados.

  • Tipo de lógica: Normal
  • Extensión: Core
  • Tipo de condición: comparación de valores
  • Operando izquierdo: %this.hostname%
  • Operador: coincide con Regex
  • Operando derecho: una expresión regular que coincide con los dominios deseados. Por ejemplo, adobe.com$|behance.com$

Condición de regla

Acción de regla

Anexe la identidad a la dirección URL.

  • Extensión: SDK web de Adobe Experience Platform
  • Tipo de acción: Redirigir con identidad

Acción de regla

Anexar identidad a una URL mediante la biblioteca JavaScript del SDK web

Ejecute el appendIdentityToUrl con una 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 hacerlo gestionar 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.

recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636