XDM ExperienceEvent-Klasse:
XDM ExperienceEvent ist eine standardmäßige Experience-Datenmodell (XDM)-Klasse. Verwenden Sie diese Klasse, um eine Momentaufnahme des Systems mit Zeitstempel zu erstellen, wenn ein bestimmtes Ereignis auftritt oder bestimmte Bedingungen erreicht wurden.
Ein Erlebnisereignis ist eine Aufzeichnung des Geschehens in Form von Fakten, einschließlich des Zeitpunkts und der Identität der beteiligten Person. Ereignisse können entweder explizit (direkt beobachtbare menschliche Aktionen) oder implizit (ohne direkte menschliche Aktion ausgelöst) sein und werden ohne Aggregation oder Interpretation aufgezeichnet. Weitere wichtige Informationen zur Verwendung dieser Klasse im Platform-Ökosystem finden Sie im Abschnitt XDM-Übersicht.
Die XDM ExperienceEvent-Klasse selbst stellt mehrere zeitreihenbezogene Felder für ein Schema bereit. Zwei dieser Felder (_id
und timestamp
) erforderlich für alle Schemas, die auf dieser Klasse basieren, während der Rest optional ist. Die Werte einiger Felder werden bei der Datenerfassung automatisch ausgefüllt.
_id
(Erforderlich)
_id
identifiziert einzelne Ereignisse, die in Adobe Experience Platform erfasst werden. Dieses Feld wird verwendet, um die Eindeutigkeit eines einzelnen Ereignisses zu verfolgen, Datendoppelungen zu verhindern und dieses Ereignis in nachgelagerten Diensten nachzuschlagen.Wenn doppelte Ereignisse erkannt werden, können Platform-Anwendungen und -Dienste die Duplizierung unterschiedlich handhaben. Beispielsweise werden doppelte Ereignisse im Profildienst abgelegt, wenn das Ereignis mit demselben
_id
bereits im Profilspeicher vorhanden ist.In einigen Fällen
_id
kann ein Universally Unique Identifier (UUID) oder Globally Unique Identifier (GUID).Wenn Sie Daten aus einer Quellverbindung streamen oder direkt aus einer Parquet-Datei aufnehmen, sollten Sie diesen Wert generieren, indem Sie eine bestimmte Kombination von Feldern miteinander verknüpfen, die das Ereignis eindeutig machen. Beispiele für Ereignisse, die verkettet werden können, sind die primäre ID, der Zeitstempel, der Ereignistyp usw. Der verkettete Wert muss eine formatierte Zeichenfolge des Typs
uri-reference
sein, was bedeutet, dass alle Doppelpunkt-Zeichen entfernt werden müssen. Danach sollte der verkettete Wert mit SHA-256 oder einem anderen Algorithmus Ihrer Wahl gehasht werden.Es ist wichtig zu erkennen, dass dieses Feld keine Identität repräsentiert, die mit einer Person in Verbindung steht, sondern den Datensatz an sich. Identitätsdaten, die sich auf eine Person beziehen, sollten stattdessen auf Identitätsfelder relegiert werden, die von kompatiblen Feldergruppen bereitgestellt werden.
eventMergeId
eventType
Standardwerte für diese Eigenschaft sind im Anhang zusammen mit Beschreibungen des vorgesehenen Anwendungsfalls angegeben. Dieses Feld ist eine erweiterbare Aufzählung, d. h. Sie können auch eigene Ereignistyp-Zeichenfolgen verwenden, um die Ereignisse, die Sie nachverfolgen, zu kategorisieren.
eventType
beschränkt Sie auf die Verwendung nur eines einzigen Ereignisses pro Treffer in Ihrem Programm. Daher müssen Sie berechnete Felder verwenden, um dem System mitzuteilen, welches Ereignis am wichtigsten ist. Weitere Informationen finden Sie im Abschnitt zu Best Practices für berechnete Felder.producedBy
Einige empfohlene Werte für diese Eigenschaft sind im Anhang angegeben. Dieses Feld ist eine erweiterbare Aufzählung, d. h. Sie können auch eigene Zeichenfolgen verwenden, um verschiedene Ereignisverursacher darzustellen.
identityMap
Siehe Abschnitt zu Identitätszuordnungen in Grundlagen der Schemakomposition für weitere Informationen zu ihrem Anwendungsfall.
timestamp
(Erforderlich)
Best Practices für die Ereignismodellierung
In den folgenden Abschnitten finden Sie Best Practices zum Entwerfen Ihrer ereignisbasierten Experience-Datenmodell (XDM)-Schemata in Adobe Experience Platform.
Zeitstempel timestamps
Das timestamp
-Feld im Stamm eines Ereignisschemas kann nur die Beobachtung des Ereignisses an sich repräsentieren und muss in der Vergangenheit liegen. Das Ereignis must ab 1970 stattfinden. Wenn Ihre Segmentierungsanwendungsfälle die Verwendung von Zeitstempeln erfordern, die in Zukunft auftreten können, müssen diese Werte an einer anderen Stelle im Erlebnisereignis-Schema eingeschränkt werden.
Beispiel: Wenn ein Unternehmen des Reise- und Beherbergungsgewerbes ein Flugreservierungsereignis modelliert, gibt das timestamp
-Feld auf Klassenebene den Zeitpunkt an, zu dem das Reservierungsereignis beobachtet wurde. Andere Zeitstempel, die mit dem Ereignis in Verbindung stehen, wie z. B. das Startdatum der Reisereservierung, sollten in separaten Feldern erfasst werden, die von standardmäßigen oder benutzerdefinierten Feldergruppen bereitgestellt werden.
Indem Sie den Zeitstempel auf Klassenebene von anderen zugehörigen Datums-/Zeitwerten in Ihren Ereignisschemata trennen, können Sie flexible Anwendungsfälle für die Segmentierung implementieren und gleichzeitig ein Kundenkonto mit Zeitstempel in Ihrem Erlebnisprogramm beibehalten.
Verwenden berechneter Felder calculated
Bestimmte Interaktionen in Ihren Erlebnisprogrammen können zu mehreren verwandten Ereignissen führen, die technisch denselben Ereigniszeitstempel aufweisen und daher als ein Ereignisdatensatz dargestellt werden. Wenn ein Kunde beispielsweise ein Produkt auf Ihrer Website ansieht, kann dies zu einem Ereignisdatensatz führen, der zwei potenzielle eventType
-Werte hat: ein „Produktansicht“-Ereignis (commerce.productViews
) oder ein generisches „Seitenansicht“-Ereignis (web.webpagedetails.pageViews
). In diesen Fällen können Sie berechnete Felder verwenden, um die wichtigsten Attribute zu erfassen, wenn mehrere Ereignisse in einem Treffer erfasst werden.
Verwendung Adobe Experience Platform-Datenvorbereitung zum Zuordnen, Transformieren und Validieren von Daten zu und von XDM. Mithilfe der verfügbaren Zuordnungsfunktionen, die vom Service bereitgestellt werden, können Sie logische Operatoren aufrufen, um Daten aus Datensätzen mit mehreren Ereignissen zu priorisieren, umzuwandeln und/oder zu konsolidieren, wenn sie in Experience Platform aufgenommen werden. Im obigen Beispiel könnten Sie eventType
als berechnetes Feld festlegen, das eine „Produktansicht“ gegenüber einer „Seitenansicht“ priorisiert, wenn beide auftreten.
Wenn Sie Daten manuell über die UI in Platform erfassen, finden Sie das Handbuch unter berechnete Felder spezifische Schritte zur Erstellung berechneter Felder.
Wenn Sie Daten mithilfe einer Quellverbindung an Platform streamen, können Sie die Quelle so konfigurieren, dass stattdessen berechnete Felder verwendet werden. In der Dokumentation zu Ihrer jeweiligen Quelle finden Sie Anweisungen zur Implementierung berechneter Felder beim Konfigurieren der Verbindung.
Kompatible Schemafeldgruppen field-groups
Adobe bietet mehrere Standardfeldgruppen zur Verwendung mit der XDM ExperienceEvent-Klasse. Im Folgenden finden Sie eine Liste einiger häufig verwendeter Feldergruppen für die Klasse:
- Adobe Analytics ExperienceEvent Full Extension
- Bilanzübertragungen
- Kampagnen-Marketing-Details
- Kartenaktionen
- Kanaldetails
- Handelsdetails
- Einlagendetails
- Details zum Gerätehandel
- Restaurantreservierung
- Details zur Endbenutzer-ID
- Umgebungsdetails
- Flugreservierung
- IAB TCF 2.0-Einverständnis
- Unterkunftsreservierung
- Details zur MediaAnalytics-Interaktion
- Anführungsanfragedetails
- Reservierungsdetails
- Web-Details
Anhang
Im folgenden Abschnitt finden Sie weitere Informationen zur XDM ExperienceEvent-Klasse.
Akzeptierte Werte für eventType
eventType
In der folgenden Tabelle sind die akzeptierten Werte für eventType
zusammen mit ihren Definitionen aufgeführt:
advertising.clicks
advertising.completes
advertising.conversions
advertising.federated
advertising.firstQuartiles
advertising.impressions
advertising.midpoints
advertising.starts
advertising.thirdQuartiles
advertising.timePlayed
application.close
application.launch
commerce.backofficeCreditMemoIssued
commerce.backofficeOrderCancelled
commerce.backofficeOrderItemsShipped
commerce.backofficeOrderPlaced
commerce.backofficeShipmentCompleted
commerce.checkouts
commerce.productListAdds
commerce.productListOpens
commerce.productListRemovals
commerce.productListReopens
commerce.productListViews
commerce.productViews
commerce.purchases
commerce.saveForLaters
decisioning.propositionDisplay
decisioning.propositionDismiss
decisioning.propositionInteract
decisioning.propositionSend
decisioning.propositionTrigger
delivery.feedback
directMarketing.emailBounced
directMarketing.emailBouncedSoft
directMarketing.emailClicked
directMarketing.emailDelivered
directMarketing.emailOpened
directMarketing.emailSent
directMarketing.emailUnsubscribed
inappmessageTracking.dismiss
inappmessageTracking.display
inappmessageTracking.interact
leadOperation.callWebhook
leadOperation.changeCampaignStream
leadOperation.changeEngagementCampaignCadence
leadOperation.convertLead
leadOperation.interestingMoment
leadOperation.mergeLeads
leadOperation.newLead
leadOperation.scoreChanged
leadOperation.statusInCampaignProgressionChanged
listOperation.addToList
listOperation.removeFromList
media.adBreakComplete
adBreakComplete
-Ereignis aufgetreten ist. Dieses Ereignis wird zu Beginn einer Werbeunterbrechung ausgelöst.media.adBreakStart
adBreakStart
-Ereignis aufgetreten ist. Dieses Ereignis wird am Ende einer Werbeunterbrechung ausgelöst.media.adComplete
adComplete
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn eine Anzeige abgeschlossen ist.media.adSkip
adSkip
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn eine Anzeige übersprungen wurde.media.adStart
adStart
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn eine Anzeige begonnen hat.media.bitrateChange
bitrateChange
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn sich die Bitrate ändert.media.bufferStart
bufferStart
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn die Pufferung von Medien begonnen hat.media.chapterComplete
chapterComplete
-Ereignis aufgetreten ist. Dieses Ereignis wird nach Abschluss eines Medienkapitels ausgelöst.media.chapterSkip
chapterSkip
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn ein Benutzer einen vorwärts- oder rückwärts zu einem anderen Abschnitt oder Kapitel im Medieninhalt springt.media.chapterStart
chapterStart
-Ereignis aufgetreten ist. Dieses Ereignis wird zu Beginn eines bestimmten Abschnitts oder Kapitels im Medieninhalt ausgelöst.media.downloaded
media.error
error
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn während der Medienwiedergabe ein Fehler oder Problem auftritt.media.pauseStart
pauseStart
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn ein Benutzer eine Pause in der Medienwiedergabe initiiert.media.ping
ping
-Ereignis aufgetreten ist. Dadurch wird die Verfügbarkeit einer Medienressource überprüft.media.play
play
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn der Medieninhalt wiedergegeben wird, was auf die aktive Nutzung durch den Benutzer hinweist.media.sessionComplete
sessionComplete
-Ereignis aufgetreten ist. Dieses Ereignis markiert das Ende einer Medienwiedergabesitzung.media.sessionEnd
sessionEnd
-Ereignis aufgetreten ist. Dieses Ereignis gibt den Abschluss einer Mediensitzung an. Zu diesem Schluss kann das Schließen des Medienplayers oder das Beenden der Wiedergabe gehören.media.sessionStart
sessionStart
-Ereignis aufgetreten ist. Dieses Ereignis markiert den Anfang einer Medienwiedergabesitzung. Sie wird ausgelöst, wenn ein Benutzer mit der Wiedergabe einer Mediendatei beginnt.media.statesUpdate
statesUpdate
-Ereignis aufgetreten ist. Die Funktionen für das Player-Status-Tracking können an einen Audio- oder Videostream angehängt werden. Die Standardstatus sind: Vollbild, Stumm, Untertitel, BildinBild und InFokus.opportunityEvent.addToOpportunity
opportunityEvent.opportunityUpdated
opportunityEvent.removeFromOpportunity
pushTracking.applicationOpened
pushTracking.customAction
web.formFilledOut
web.webinteraction.linkClicks
web.webpagedetails.pageViews
location.entry
location.exit
Vorgeschlagene Werte für producedBy
producedBy
In der folgenden Tabelle sind einige akzeptierte Werte für producedBy
angegeben:
self
system
salesRef
customerRep