clickCollectionEnabled

De eigenschap clickCollectionEnabled is een Booleaanse waarde die bepaalt of de Web SDK automatisch koppelingsgegevens verzamelt. Als u deze variabele niet instelt, is de standaardwaarde true . Dit houdt in dat de gegevens voor het bijhouden van koppelingen standaard automatisch worden verzameld. Het instellen van deze eigenschap op false is nuttig wanneer u koppelingsgegevens handmatig wilt bijhouden.

Wanneer clickCollectionEnabled is ingeschakeld, vullen de volgende XDM-elementen automatisch met gegevens:

  • xdm.web.webInteraction.name
  • xdm.web.webInteraction.type
  • xdm.web.webInteraction.URL

Interne koppelingen, downloadkoppelingen en afsluitkoppelingen worden standaard automatisch bijgehouden wanneer deze Boolean is ingeschakeld. Adobe raadt u aan het clickCollection -object te gebruiken als u meer controle wilt hebben over het automatisch bijhouden van koppelingen.

Ondersteuning voor open Shadow DOM -elementen

SDK van het Web steunt automatische klik het volgen voor verbindingen binnen open DOM van de Schaduw elementen.

Vele moderne websites gebruiken {de Componenten van 0} Web 🔗 om herbruikbare en ingekapselde gebruikersinterfaceelementen te bouwen. Deze componenten gebruiken vaak een technologie genoemd DOM van de Schaduwom hun interne structuur en stijlen gescheiden van de rest van de pagina te houden.

Er zijn twee soorten schaduw-DOM:

  • Open DOM van de Schaduw: de interne structuur is toegankelijk voor JavaScript die op de pagina loopt. Dit betekent dat andere scripts de inhoud van de component kunnen beïnvloeden of inspecteren.
  • Gesloten DOM van de Schaduw: de interne structuur wordt verborgen van JavaScript buiten de component, die het ontoegankelijk maken voor het volgen of manipulatie.

Het Web SDK houdt automatisch kliks op <a> en <area> elementen binnen open DOMs van de Schaduw, enkel zoals het voor verbindingen in het belangrijkste document doet. Zo zorgt u ervoor dat koppelingsklikken binnen webcomponenten die open Shadow DOM gebruiken, worden opgenomen in de analysegegevens. De klikken binnen gesloten Schaduw DOMs worden niet gevolgd, aangezien hun interne structuur van de code van JavaScript die buiten de component werken verborgen is.

Logica voor automatisch bijhouden van koppelingen

De Web SDK houdt bij alle klikken op <a> en <area> HTML-elementen als het geen onClick -kenmerk heeft. De klikken worden gevangen met a vangtklik gebeurtenisluisteraar die aan het document in bijlage is. Wanneer op een geldige koppeling wordt geklikt, wordt de volgende logica in de juiste volgorde uitgevoerd:

  1. Als de koppeling overeenkomt met criteria op basis van waarden in downloadLinkQualifier of als de koppeling een download HTML-kenmerk bevat, wordt xdm.web.webInteraction.type ingesteld op "download" (als clickCollection.downloadLinkEnabled is ingeschakeld).
  2. Als het koppelingsdoeldomein verschilt van het huidige window.location.hostname , wordt xdm.web.webInteraction.type ingesteld op "exit" (als clickCollection.exitLinkEnabled is ingeschakeld).
  3. Als de koppeling niet in aanmerking komt voor "download" of "exit" , wordt xdm.web.webInteraction.type ingesteld op "other" .

In alle gevallen wordt xdm.web.webInteraction.name ingesteld op het label van de koppelingstekst en wordt xdm.web.webInteraction.URL ingesteld op de URL van het doel van de koppeling. Als u ook de naam van de koppeling wilt instellen op de URL, kunt u dit XDM-veld overschrijven met de callback filterClickDetails in het clickCollection -object.

Automatisch koppelingen bijhouden inschakelen met de webtagextensie SDK tag-extension

Deze variabele wordt automatisch beheerd door de tagextensie. U hoeft deze niet expliciet in te stellen. Als om het even welk van het volgende wordt geselecteerd wanneer het vormen van de markeringsuitbreiding, wordt de toepasselijke verbinding volgende gegevens verzameld:

  • Collect internal link clicks
  • Collect external link clicks
  • Collect download link clicks

Zie clickCollection voor meer informatie.

Automatisch koppelingen bijhouden inschakelen met de Web SDK JavaScript-bibliotheek library

Stel de Booleaanse waarde clickCollectionEnabled in wanneer u de opdracht configure uitvoert. Als u deze eigenschap weglaat bij het configureren van de Web SDK, wordt standaard true gebruikt. Stel deze waarde in op false als u xdm.web.webInteraction.type en xdm.web.webInteraction.value handmatig wilt instellen.

alloy(configure, {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: false
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636