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.
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.
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
});
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. 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. Den här spårningen ser till att länkklick i webbkomponenter som använder 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.
Aktivera eller inaktivera klicksamling för Web SDK-taggtillägg
Mer information om hur du utför de här åtgärderna med hjälp av taggar finns i Konfigurationsinställningar för datainsamling i dokumentationen för Web SDK-tillägget.