DokumentationExperience PlatformTags

Konfigurationseinstellungen für die Datenerfassung data-collection

Letzte Aktualisierung: 11. Juni 2026

Erstellt für:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

In diesem Konfigurationsabschnitt können Sie festlegen, wie Daten in der gesamten Erweiterung erfasst werden.

  1. Melden Sie sich mit Ihren Adobe IDAnmeldeinformationen bei ​CX Enterprise) an.
  2. Navigieren Sie Datenerfassung > Tags.
  3. Wählen Sie die gewünschte Tag-Eigenschaft aus.
  4. Navigieren Sie zu Erweiterungen und wählen Sie dann Konfigurieren auf der Karte Adobe Experience Platform Web SDK aus.
  5. Scrollen Sie nach unten zum Abschnitt Datenerfassung .

Bild mit den Datenerfassungseinstellungen der Web-SDK-Tag-Erweiterung in der Tags-Benutzeroberfläche.

Die folgenden Optionen sind verfügbar:

Ein vor Ereignisversand-Rückruf

Eine Rückruffunktion zur Auswertung und Änderung der an Adobe gesendeten Payload. Innerhalb des Code-Editors haben Sie Zugriff auf die folgenden Variablen:

  • content.xdm: Die XDM-Payload für das Ereignis.
  • content.data: Die Payload des Datenobjekts für das Ereignis.
  • return true: Sofort den Callback beenden und Daten mit den aktuellen Werten im content Objekt an Adobe senden.
  • return false: Sofort den Callback beenden und das Senden von Daten an Adobe abbrechen.

Alle Variablen, die außerhalb von content definiert wurden, können verwendet werden, sind jedoch nicht in der Payload enthalten, die an Adobe gesendet wird.

WARNING
Dieser Callback ermöglicht die Verwendung von benutzerdefiniertem Code. Wenn ein Code, den Sie in den Callback einbeziehen, eine nicht abgefangene Ausnahme auslöst, wird die Verarbeitung für das Ereignis angehalten. Daten werden nicht an Adobe gesendet.
// 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
Vermeiden Sie die Rückgabe von false beim ersten Ereignis auf einer Seite. Eine Rückkehr der false beim ersten Ereignis kann sich negativ auf die Personalisierung auswirken.

Dieser Callback ist das Tag, das der onBeforeEventSend in der JavaScript-Bibliothek entspricht.

Ein Kontrollkästchen, das die Erfassung von Linktracking-Daten innerhalb Ihrer Site oder Eigenschaft ermöglicht. Dieses Kontrollkästchen entspricht dem Tag-clickCollection.internalLinkEnabled in der JavaScript-Bibliothek. Wenn Sie dieses Kontrollkästchen aktivieren, werden Optionen für die Ereignisgruppierung angezeigt:

  • Keine Ereignisgruppierung: Linktracking-Daten werden in separaten Ereignissen an Adobe gesendet. Link-Klicks, die in separaten Ereignissen gesendet werden, können die vertragliche Nutzung der an Adobe Experience Platform gesendeten Daten erhöhen.
  • Ereignisgruppierung mit Sitzungsspeicher: Speichern von Linktracking-Daten im Sitzungsspeicher bis zum nächsten Ereignis „Seitenansicht“. Beim nächsten Ereignis, das als „Seitenansicht“ gilt, werden die gespeicherten Linktracking-Daten mit der Ereignis-Payload „Seitenansicht“ zusammengeführt. Adobe empfiehlt, diese Einstellung beim Tracking interner Links zu aktivieren.
  • Ereignisgruppierung mit lokalem Objekt: Speichern von Linktracking-Daten in einem lokalen Objekt bis zum nächsten Ereignis „Seitenansicht“. Wenn ein Besucher zu einer neuen Browser-Seite navigiert, gehen Linktracking-Daten verloren. Diese Einstellung ist besonders im Kontext von Einzelseitenanwendungen von Vorteil.

Die Tag-Bibliothek betrachtet ein bestimmtes Ereignis als „Seitenansicht“, wenn die folgenden Elemente in der Payload enthalten sind:

  • xdm.web.webPageDetails.name enthält einen Zeichenfolgenwert
  • xdm.web.webPageDetails.pageViews.value ist größer als 0

Ein Kontrollkästchen, das die Sammlung externer Links aktiviert. Dieses Kontrollkästchen entspricht dem Tag-clickCollection.externalLinkEnabled in der JavaScript-Bibliothek.

Ein Kontrollkästchen, das die Sammlung von Download-Links aktiviert. Dieses Kontrollkästchen entspricht dem Tag-clickCollection.downloadLinkEnabled in der JavaScript-Bibliothek.

Ein regulärer Ausdruck, der eine Link-URL als Download-Link kennzeichnet. Diese Zeichenfolge ist das Tag, das der downloadLinkQualifier in der JavaScript-Bibliothek entspricht.

Filter - Klickeigenschaften

Eine Rückruffunktion, mit der klickbezogene Eigenschaften vor der Sammlung ausgewertet und geändert werden können. Diese Funktion wird vor dem Ein vor Rückruf senden ausgeführt und ist das Tag, das clickCollection.filterClickDetails in der JavaScript-Bibliothek entspricht. Innerhalb des Code-Editors haben Sie Zugriff auf die folgenden Variablen:

  • content.clickedElement: Das angeklickte DOM-Element.
  • content.pageName: Der Seitenname zum Zeitpunkt des Klicks.
  • content.linkName: Der Name des angeklickten Links.
  • content.linkRegion: Die Region des angeklickten Links.
  • content.linkType: Der Link-Typ (Beenden, Herunterladen oder sonstiges).
  • content.linkURL: Die Ziel-URL des angeklickten Links.
  • return true: Sofort den Callback mit den aktuellen Variablenwerten beenden.
  • return false: Sofort den Callback beenden und die Datenerfassung abbrechen.
  • Alle Variablen, die außerhalb von content definiert wurden, können verwendet werden, sind jedoch nicht in der Payload enthalten, die an Adobe gesendet wird.
TIP
Das Feld Ein Link vor Klick auf Senden ist ein veralteter Callback, der nur für Eigenschaften sichtbar ist, für die er bereits konfiguriert wurde. Es handelt sich dabei um das Tag-Äquivalent zu onBeforeLinkClickSend in der JavaScript-Bibliothek. Verwenden Sie den Filter-Klick Eigenschaften-Callback, um Klickdaten zu filtern oder anzupassen, oder verwenden Sie das Ein vor Ereignis senden des Callbacks, um die gesamte an Adobe gesendete Payload zu filtern oder anzupassen. Wenn sowohl der Callback Eigenschaften filtern als auch der Callback Ein vor Link klicken senden“ festgelegt sind, wird nur der Callback Eigenschaften filtern klicken ausgeführt.

Kontexteinstellungen

Sammelt automatisch Besucherinformationen, mit denen bestimmte XDM-Felder für Sie ausgefüllt werden. Sie können zwischen Alle standardmäßigen Kontextinformationen oder Spezifische Kontextinformationen wählen. Es handelt sich dabei um das Tag-Äquivalent zu context in der JavaScript-Bibliothek.

  • Web: Sammelt Informationen über die aktuelle Seite.
  • Gerät: Sammelt Informationen zum Gerät des Benutzers.
  • Umgebung: Sammelt Informationen zum Browser des Benutzers.
  • Ortskontext: Sammelt Informationen zum Standort des Benutzers.
  • Benutzeragenten-Hinweise mit hoher Entropie: Erfasst detailliertere Informationen über das Gerät des Benutzers.
  • Verweise nur einmal pro Seitenansicht an Adobe Analytics senden: Verhindern Sie, dass doppelte Verweisdaten an Adobe Analytics gesendet werden.
recommendation-more-help
experience-platform-help-tags