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:
xdm.web.webInteraction.namexdm.web.webInteraction.typexdm.web.webInteraction.URL
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.
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:
- Si el vínculo coincide con criterios basados en valores de
downloadLinkQualifier, o si el vínculo contiene un atributo HTMLdownload,xdm.web.webInteraction.typese establece en"download"(siclickCollection.downloadLinkEnabledestá habilitado). - Si el dominio de destino del vínculo difiere del actual
window.location.hostname,xdm.web.webInteraction.typese establece en"exit"(siclickCollection.exitLinkEnabledestá habilitado). - Si el vínculo no cumple los requisitos para
"download"o"exit",xdm.web.webInteraction.typese establece en"other".
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.
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
});
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:
- Abrir DOM en la sombra: JavaScript que se ejecuta en la página tiene acceso a la estructura interna. Otros scripts pueden interactuar con el contenido del componente o inspeccionarlo.
- DOM de sombra cerrada: La estructura interna está oculta a JavaScript fuera del componente, por lo que no es accesible para su seguimiento o manipulación.
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. Este seguimiento 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.
Habilite o deshabilite la recopilación de clics para la extensión de etiquetas de Web SDK
Consulte Configuración de la recopilación de datos en la documentación de la extensión de Web SDK para obtener información sobre cómo realizar estas acciones mediante etiquetas.