clickCollectionEnabled

Die clickCollectionEnabled-Eigenschaft ist ein boolescher Wert, der bestimmt, ob die Web-SDK automatisch Linkdaten erfasst. Wenn Sie diese Variable nicht festlegen, lautet ihr Standardwert true , was bedeutet, dass Linktracking-Daten standardmäßig automatisch erfasst werden. Das Festlegen dieser Eigenschaft auf false ist nützlich, wenn Sie Linkdaten lieber manuell verfolgen möchten.

Wenn clickCollectionEnabled aktiviert ist, werden die folgenden XDM-Elemente automatisch mit Daten befüllt:

Interne Links, Downloadlinks und Exitlinks werden standardmäßig alle automatisch verfolgt, wenn dieser boolesche Wert aktiviert ist. Wenn Sie mehr Kontrolle über die automatische Linkverfolgung erhalten möchten, empfiehlt Adobe die Verwendung des clickCollection.

Unterstützung für offene Shadow DOM

Web SDK unterstützt das automatische Klick-Tracking für Links in Open Shadow-DOM-Elementen.

Viele moderne Websites verwenden Web-Komponenten um wiederverwendbare und verkapselte Benutzeroberflächenelemente zu erstellen. Diese Komponenten verwenden häufig eine Technologie namens Shadow-DOM, um ihre interne Struktur und ihre Stile vom Rest der Seite getrennt zu halten.

Es gibt zwei Arten von Shadow-DOM:

Web SDK verfolgt Klicks auf <a> und <area> automatisch in Open Shadow-DOMs, genau wie bei Links im Hauptdokument. Dadurch wird sichergestellt, dass Link-Klicks innerhalb von Web-Komponenten, die offene Shadow DOM verwenden, in Ihren Analytics-Daten enthalten sind. Klicks in geschlossenen Shadow-DOMs werden nicht verfolgt, da ihre interne Struktur vor JavaScript-Code verborgen ist, der außerhalb der Komponente ausgeführt wird.

Automatische Linktracking-Logik

Web SDK verfolgt alle Klicks auf <a> und <area> HTML-Elemente, wenn es kein onClick hat. Klicks werden mit einem --Listener erfasst, der an das Dokument angehängt ist. Wenn auf einen gültigen Link geklickt wird, wird die folgende Logik der Reihe nach ausgeführt:

In allen Fällen ist xdm.web.webInteraction.name auf die Link-Textbeschriftung und xdm.web.webInteraction.URL auf die Link-Ziel-URL festgelegt. Wenn Sie den Link-Namen auch für die URL festlegen möchten, können Sie dieses XDM-Feld mit dem filterClickDetails-Callback im clickCollection-Objekt überschreiben.

Aktivieren der automatischen Linkverfolgung mit der Tag-Erweiterung „Web SDK" tag-extension

Diese Variable wird automatisch von der Tag-Erweiterung verwaltet; Sie müssen sie nicht explizit festlegen. Wenn beim Konfigurieren Tag-Erweiterung eine der folgenden Optionen ausgewählt, werden die entsprechenden Linktracking-Daten erfasst:

Weitere Informationen finden Sie unter clickCollection .

Aktivieren der automatischen Linkverfolgung mithilfe der Web SDK JavaScript-Bibliothek library

Legen Sie beim Ausführen des configure-Befehls den booleschen Wert clickCollectionEnabled fest. Wenn Sie diese Eigenschaft beim Konfigurieren der Web-SDK auslassen, wird sie standardmäßig auf true gesetzt. Legen Sie diesen Wert auf false fest, wenn Sie xdm.web.webInteraction.type und xdm.web.webInteraction.value manuell festlegen möchten.

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