DocumentatieExperience PlatformTags

Instellingen voor gegevensverzameling

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Deze configuratiesectie staat u toe om te bepalen hoe de gegevens over de uitbreiding worden verzameld.

  1. Login aan ​ experience.adobe.com ​ gebruikend uw geloofsbrieven van Adobe ID.
  2. Ga naar Data Collection > Tags.
  3. Selecteer de gewenste eigenschap tag.
  4. Ga naar Extensions en selecteer vervolgens Configure op de Adobe Experience Platform Web SDK -kaart.
  5. Schuif omlaag naar de sectie Data collection .

Beeld dat de montages van de gegevensinzameling van de de markeringsuitbreiding van SDK van het Web in de Markeringen UI toont.

De volgende opties zijn beschikbaar:

On before event send callback

Een callback functie om de lading te evalueren en te wijzigen die naar Adobe wordt verzonden. In de code-editor hebt u toegang tot de volgende variabelen:

  • content.xdm: De XDM-lading voor de gebeurtenis.
  • content.data: De payload van het gegevensobject voor de gebeurtenis.
  • return true: Sluit de callback onmiddellijk af en verzend gegevens naar Adobe met de huidige waarden in het content -object.
  • return false: Sluit de callback onmiddellijk af en abort het verzenden van gegevens naar Adobe af.

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

WARNING
Deze callback staat het gebruik van douanecode toe. Als een code die u in de callback opneemt, een niet-afgevangen uitzondering genereert, wordt de verwerking voor de gebeurtenis gestopt. Gegevens worden niet verzonden naar Adobe.
// Use nullish coalescing assignments to add objects if they don't yet exist
content.xdm.commerce ??= {};
content.xdm.commerce.order ??= {};

// Then add the purchase ID
content.xdm.commerce.order.purchaseID = "12345";

// Use optional chaining to prevent undefined errors when setting tracking code to lower case
if(content.xdm.marketing?.trackingCode) content.xdm.marketing.trackingCode = content.xdm.marketing.trackingCode.toLowerCase();

// Delete operating system version
if(content.xdm.environment) delete content.xdm.environment.operatingSystemVersion;

// Immediately end onBeforeEventSend logic and send the data to Adobe for this event type
if (content.xdm.eventType === "web.webInteraction.linkClicks") {
  return true;
}

// Cancel sending data if it is a known bot
if (myBotDetector.isABot()) {
  return false;
}
TIP
Retourneer false niet op de eerste gebeurtenis op een pagina. Het retourneren van false op de eerste gebeurtenis kan een negatieve invloed hebben op de personalisatie.

Deze callback is gelijk aan de tag onBeforeEventSend in de JavaScript-bibliotheek.

Een checkbox die de inzameling van verbinding het volgen gegevens intern aan uw plaats of bezit toelaat. Dit selectievakje is gelijk aan de tag clickCollection.internalLinkEnabled in de JavaScript-bibliotheek. Wanneer u dit selectievakje inschakelt, worden opties voor gebeurtenisgroepering weergegeven:

  • No event grouping: Gegevens voor het bijhouden van koppelingen worden in afzonderlijke gebeurtenissen naar Adobe verzonden. Koppelingsklikken die in afzonderlijke gebeurtenissen worden verzonden, kunnen het contractuele gebruik van gegevens die naar Adobe Experience Platform worden verzonden verhogen.
  • Event grouping using session storage: Sla koppelingsvolggegevens op in de sessieopslag tot de volgende "paginaweergave"-gebeurtenis. Bij de volgende gebeurtenis die als een "paginaweergave" wordt beschouwd, worden de opgeslagen gegevens voor het bijhouden van koppelingen samengevoegd met de payload van de gebeurtenis "paginaweergave". Adobe raadt u aan deze instelling in te schakelen bij het bijhouden van interne koppelingen.
  • Event grouping using local object: Sla koppelingsvolggegevens in een lokaal object op tot de volgende gebeurtenis "paginaweergave". Als een bezoeker naar een nieuwe browserpagina navigeert, gaan de gegevens voor het bijhouden van koppelingen verloren. Deze instelling is het meest geschikt voor toepassingen van één pagina.

De tagbibliotheek beschouwt een bepaalde gebeurtenis als een "paginaweergave" wanneer de volgende elementen in de payload zijn opgenomen:

  • xdm.web.webPageDetails.name bevat een tekenreekswaarde
  • xdm.web.webPageDetails.pageViews.value is groter dan 0

Een selectievakje waarmee externe koppelingen kunnen worden verzameld. Dit selectievakje is gelijk aan de tag clickCollection.externalLinkEnabled in de JavaScript-bibliotheek.

Een selectievakje waarmee downloadkoppelingen kunnen worden verzameld. Dit selectievakje is gelijk aan de tag clickCollection.downloadLinkEnabled in de JavaScript-bibliotheek.

Een reguliere expressie die een link-URL kwalificeert als een downloadkoppeling. Deze tekenreeks komt overeen met de tag downloadLinkQualifier in de JavaScript-bibliotheek.

Filter click properties

Een callback functie om op klik betrekking hebbende eigenschappen vóór inzameling te evalueren en te wijzigen. Deze functie wordt uitgevoerd vóór de On before event send callback en is gelijk aan de tag clickCollection.filterClickDetails in de JavaScript-bibliotheek. 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 Adobe wordt verzonden.
TIP
Het veld On before link click send is een afgekeurde callback die alleen zichtbaar is voor eigenschappen waarvoor deze al is geconfigureerd. De tag komt overeen met onBeforeLinkClickSend in de JavaScript-bibliotheek. Gebruik de callback van Filter click properties om klikgegevens te filteren of aan te passen, of On before event send callback te gebruiken om de algemene lading te filtreren of aan te passen die naar Adobe wordt verzonden. Wanneer zowel de callback als de callback Filter click properties zijn ingesteld, wordt alleen de callback On before link click send uitgevoerd.Filter click properties

Contextinstellingen

Verzamel automatisch bezoekersinformatie, die specifieke XDM gebieden voor u bevolkt. U kunt All default context information of Specific context information kiezen. De tag komt overeen met context in de JavaScript-bibliotheek.

  • Web: verzamelt informatie over de huidige pagina.
  • Device: verzamelt informatie over het apparaat van de gebruiker.
  • Environment: verzamelt informatie over de browser van de gebruiker.
  • Place context: verzamelt informatie over de locatie van de gebruiker.
  • High entropy user-agent hints: verzamelt meer gedetailleerde informatie over het apparaat van de gebruiker.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743