DocumentatieExperience PlatformHandleiding voor Web SDK

clickCollectionEnabled

Last update: Tue Jul 23 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

De eigenschap clickCollectionEnabled is een Booleaanse waarde die bepaalt of de SDK van het Web 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. Als u meer controle wilt hebben over het automatisch bijhouden van koppelingen, raadt Adobe u aan het object clickCollection te gebruiken.

Logica voor automatisch bijhouden van koppelingen

De SDK van het Web volgt alle klikken op <a> en <area> HTML elementen als het geen onClick attribuut 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 webSDK-tagextensie 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