clickCollection

Het clickCollection -object bevat verschillende variabelen die u helpen de automatisch verzamelde koppelingsgegevens te beheren. Gebruik deze variabelen als u typen koppelingen wilt opnemen in of uitsluiten van gegevensverzameling.

Hiervoor moet clickCollectionEnabled zijn ingeschakeld.

Deze functie wordt ondersteund op Web SDK 2.25.0 of hoger.

De volgende variabelen zijn beschikbaar in het object clickCollection :

  • clickCollection.internalLinkEnabled: Een Booleaanse waarde die bepaalt of koppelingen binnen het huidige domein automatisch worden bijgehouden. Bijvoorbeeld https://example.com/index.html tot https://example.com/product.html .

  • clickCollection.downloadLinkEnabled: Een Booleaanse waarde die bepaalt of de bibliotheek koppelingen bijhoudt die op basis van de eigenschap downloadLinkQualifier als downloads worden gekwalificeerd.

  • clickCollection.externalLinkEnabled: Een Booleaanse waarde die bepaalt of koppelingen naar externe domeinen automatisch worden bijgehouden. Bijvoorbeeld https://example.com tot https://example.net .

  • clickCollection.eventGroupingEnabled: Een Booleaanse waarde die bepaalt of de bibliotheek tot de volgende pagina wacht om gegevens voor het bijhouden van koppelingen te verzenden. Wanneer de volgende pagina wordt geladen, combineert u de gegevens voor het bijhouden van koppelingen met de gebeurtenis page load. Als u deze optie inschakelt, verkleint u het aantal gebeurtenissen dat u naar de Adobe verzendt. Als internalLinkEnabled is uitgeschakeld, heeft deze variabele geen effect.

  • clickCollection.sessionStorageEnabled: Een Booleaanse waarde die bepaalt of de gegevens voor het bijhouden van koppelingen worden opgeslagen in de sessieopslag in plaats van in lokale variabelen. Als internalLinkEnabled of eventGroupingEnabled zijn uitgeschakeld, heeft deze variabele geen effect.

    Adobe raadt ten zeerste aan deze variabele in te schakelen wanneer u eventGroupingEnabled buiten toepassingen van één pagina gebruikt. Als eventGroupingEnabled is ingeschakeld terwijl sessionStorageEnabled is uitgeschakeld, leidt het klikken op een nieuwe pagina tot het verlies van gegevens voor het bijhouden van koppelingen, omdat deze gegevens niet behouden blijven in de sessieopslag. Aangezien toepassingen van één pagina typisch niet aan een nieuwe pagina navigeren, wordt de zittingsopslag niet vereist voor SPA pagina's.

  • filterClickDetails: Een callback-functie die volledige besturingselementen biedt voor koppelingsgegevens die u verzamelt. U kunt deze callback functie gebruiken om het verzenden van verbinding het volgen gegevens te veranderen, te verduisteren of te breken. Deze callback is nuttig wanneer u specifieke informatie, zoals persoonlijk identificeerbare informatie binnen verbindingen wilt weglaten.

Klik inzamelingsmontages gebruikend de de markeringsuitbreiding van SDK van het Web

Selecteer om het even welke volgende opties wanneer het vormen van de markeringsuitbreiding:

  • Collect internal links

    • Event grouping options:

      • No event grouping
      • Event grouping using session storage
      • Event grouping using local object
  • Collect external links

  • Collect download links

  • Filter click properties

  1. Login aan experience.adobe.comgebruikend uw geloofsbrieven van Adobe ID.
  2. Ga naar Data Collection > Tags.
  3. Selecteer de gewenste eigenschap tag.
  4. Navigeer naar Extensions en klik vervolgens op Configure op de Adobe Experience Platform Web SDK -kaart.
  5. Blader omlaag naar de sectie Data Collection en selecteer vervolgens de gewenste instellingen voor de klikverzameling.
  6. Klik op Save en publiceer de wijzigingen.

Met de callback van Filter click properties wordt een aangepaste code-editor geopend waarmee u de gewenste code kunt invoegen. In de code-editor hebt u toegang tot de volgende variabelen:

  • content.clickedElement: Het DOM-element waarop is geklikt.
  • content.pageName: De paginanaam wanneer de klik voorkwam.
  • content.linkName: De naam van de aangeklikte koppeling.
  • content.linkRegion: Het gebied van de aangeklikte koppeling.
  • content.linkType: Het type koppeling (afsluiten, downloaden of andere).
  • content.linkURL: De doel-URL van de aangeklikte koppeling.
  • return true: Sluit de callback onmiddellijk af met de huidige variabelewaarden.
  • return false: Sluit de callback onmiddellijk af en sluit het verzamelen van gegevens af.

Variabelen die buiten content worden gedefinieerd, kunnen worden gebruikt, maar worden niet opgenomen in de lading die naar de Adobe wordt verzonden.

Klik inzamelingsmontages gebruikend de bibliotheek van SDK van het Web JavaScript

Stel de gewenste variabelen in het object clickCollection in wanneer u de opdracht configure uitvoert. Als deze optie niet is ingesteld, zijn de standaardinstellingen voor dit object afhankelijk van de waarde van clickCollectionEnabled .

  • internalLinkEnabled: Overeenkomsten clickCollectionEnabled
  • downloadLinkEnabled: Overeenkomsten clickCollectionEnabled
  • externalLinkEnabled: Overeenkomsten clickCollectionEnabled
  • eventGroupingEnabled: is standaard ingesteld op false ; moet expliciet zijn ingeschakeld
  • sessionStorageEnabled: is standaard ingesteld op false ; moet expliciet zijn ingeschakeld
  • filterClickDetails: bevat geen functie; moet expliciet worden geregistreerd
TIP
Adobe raadt aan eventGroupingEnabled in te schakelen wanneer internalLinkEnabled is ingeschakeld, aangezien dit het aantal gebeurtenissen vermindert dat telt voor gebruik in een overeenkomst.
alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: true,
  clickCollection: {
    internalLinkEnabled: true,
    downloadLinkEnabled: true,
    externalLinkEnabled: true,
    eventGroupingEnabled: true,
    sessionStorageEnabled: true,
    filterClickDetails: function(content) {
      // If the link is a clickable telephone number, anonymize it
      if(content.linkUrl?.includes("tel:")) {
        content.linkName = content.linkUrl = "Phone number";
      }
      // If the link is an email address, anonymize it
      if(content.linkUrl?.includes("mailto:")) {
        content.linkName = content.linkUrl = "Email address";
      }
    }
  }
});
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636