clickCollectionEnabled
Egenskapen clickCollectionEnabled är en boolesk egenskap som avgör om Web SDK automatiskt samlar in länkdata. Om du inte anger den här variabeln är standardvärdet true, vilket innebär att länkspårningsdata samlas in automatiskt som standard. Det är värdefullt att ange den här egenskapen till false om du föredrar att spåra länkdata manuellt.
När clickCollectionEnabled är aktiverat fylls följande XDM-element automatiskt i med data:
xdm.web.webInteraction.namexdm.web.webInteraction.typexdm.web.webInteraction.URL
Interna länkar, nedladdningslänkar och avslutningslänkar spåras automatiskt som standard när det här booleska alternativet är aktiverat. Om du vill ha större kontroll över automatisk länkspårning rekommenderar Adobe att du använder objektet clickCollection.
Stöd för öppna Shadow DOM-element
Webb-SDK har stöd för automatisk klickspårning för länkar inuti öppna skugg-DOM -element.
Många moderna webbplatser använder webbkomponenter för att skapa återanvändbara och inkapslade gränssnittselement. De här komponenterna använder ofta en teknik som kallas Skugga-DOM för att hålla sin interna struktur och format åtskilda från resten av sidan.
Det finns två typer av skugga-DOM:
- Öppna skugga-DOM: Den interna strukturen är tillgänglig för JavaScript som körs på sidan. Det innebär att andra skript kan interagera med eller inspektera innehållet i komponenten.
- Stängd skugga-DOM: Den interna strukturen är dold från JavaScript utanför komponenten, vilket gör den otillgänglig för spårning eller redigering.
SDK spårar automatiskt klickningar på <a> och <area> element i öppna skugg-DOM, precis som för länkar i huvuddokumentet. Detta garanterar att länkklick i webbkomponenter med öppna Shadow DOM inkluderas i analysdata. Klickningar i stängda skugg-DOM:er spåras inte eftersom deras interna struktur är dold för JavaScript-kod som körs utanför komponenten.
Automatisk länkspårningslogik
SDK spårar alla klick på <a>- och <area> HTML-element om det inte har något onClick-attribut. Klickningar hämtas med en capture-klickhändelseavlyssnare som är kopplad till dokumentet. När användaren klickar på en giltig länk körs följande logik i rätt ordning:
- Om länken matchar villkor baserade på värden i
downloadLinkQualifier, eller om länken innehåller ettdownloadHTML-attribut, ställsxdm.web.webInteraction.typein på"download"(omclickCollection.downloadLinkEnabledär aktiverat). - Om måldomänen för länken skiljer sig från den aktuella
window.location.hostnameangesxdm.web.webInteraction.typetill"exit"(omclickCollection.exitLinkEnabledär aktiverat). - Om länken inte uppfyller kraven för antingen
"download"eller"exit"ställsxdm.web.webInteraction.typein på"other".
I samtliga fall är xdm.web.webInteraction.name inställd på länktextetiketten och xdm.web.webInteraction.URL är inställd på länkens mål-URL. Om du även vill ange länknamnet till URL:en kan du åsidosätta det här XDM-fältet med hjälp av filterClickDetails-återanropet i clickCollection-objektet.
Aktivera automatisk länkspårning med hjälp av taggtillägget Web SDK tag-extension
Den här variabeln hanteras automatiskt av taggtillägget. Du behöver inte ange den explicit. Om något av följande väljs när taggtillägget konfigureras, samlas relevanta länkspårningsdata in:
- Collect internal link clicks
- Collect external link clicks
- Collect download link clicks
Mer information finns i clickCollection.
Aktivera automatisk länkspårning med Web SDK JavaScript-biblioteket library
Ange det booleska värdet clickCollectionEnabled när du kör kommandot configure. Om du utelämnar den här egenskapen när du konfigurerar Web SDK blir standardvärdet true. Ange det här värdet till false om du föredrar att ställa in xdm.web.webInteraction.type och xdm.web.webInteraction.value manuellt.
alloy(configure, {
datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
clickCollectionEnabled: false
});