clickCollectionEnabled

La propiedad clickCollectionEnabled es un booleano que determina si Web SDK recopila automáticamente los datos del vínculo. Si no establece esta variable, su valor predeterminado es true, lo que significa que los datos de seguimiento de vínculos se recopilan automáticamente de manera predeterminada. Es útil establecer esta propiedad en false en los casos en que prefiera rastrear los datos de vínculos manualmente.

Cuando clickCollectionEnabled está habilitado, los siguientes elementos XDM se rellenan automáticamente con datos:

Los vínculos internos, de descarga y de salida se rastrean automáticamente de forma predeterminada cuando este booleano está habilitado. Si desea tener más control sobre el seguimiento automático de vínculos, Adobe recomienda usar el objeto clickCollection.

Compatibilidad con elementos Shadow DOM abiertos

Web SDK admite el rastreo automático de clics para los vínculos dentro de elementos DOM en la sombra abiertos.

Muchos sitios web modernos utilizan componentes web para generar elementos de interfaz de usuario encapsulados y reutilizables. Estos componentes suelen utilizar una tecnología denominada Shadow DOM para mantener su estructura y estilos internos separados del resto de la página.

Existen dos tipos de DOM en la sombra:

Web SDK realiza automáticamente un seguimiento de los clics en <a> y <area> elementos dentro de DOM sombreados abiertos, tal como lo hace para los vínculos del documento principal. Esto garantiza que los clics en vínculos dentro de los componentes web que usan open Shadow DOM se incluyan en los datos de análisis. No se rastrearán los clics dentro de DOM en la sombra cerrados, ya que su estructura interna está oculta del código de JavaScript que funciona fuera del componente.

Lógica de seguimiento de vínculos automática

Web SDK realiza un seguimiento de todos los clics en <a> y <area> elementos de HTML si no tiene un atributo onClick. Los clics se capturan con un detector de eventos de clic capture que está adjunto al documento. Cuando se hace clic en un vínculo válido, se ejecuta la siguiente lógica en orden:

En todos los casos, xdm.web.webInteraction.name se establece en la etiqueta de texto del vínculo y xdm.web.webInteraction.URL se establece en la dirección URL de destino del vínculo. Si también desea establecer el nombre del vínculo en la dirección URL, puede anular este campo XDM con la llamada de retorno filterClickDetails en el objeto clickCollection.

Habilitar el seguimiento automático de vínculos mediante la extensión de etiquetas Web SDK tag-extension

La extensión de etiqueta administra automáticamente esta variable; no es necesario configurarla explícitamente. Si se selecciona alguna de las siguientes opciones al configurar la extensión de etiqueta, se recopilarán los datos de seguimiento de vínculos aplicables:

Consulte clickCollection para obtener más información.

Habilitar el seguimiento automático de vínculos mediante la biblioteca JavaScript de Web SDK library

Establezca el booleano clickCollectionEnabled al ejecutar el comando configure. Si omite esta propiedad al configurar Web SDK, el valor predeterminado es true. Establezca este valor en false si prefiere establecer xdm.web.webInteraction.type y xdm.web.webInteraction.value manualmente.

alloy(configure, {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: false
});