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
) sind 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
werden einzelne Ereignisse, die in Adobe Experience Platform erfasst werden, eindeutig identifiziert. 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 dem gleichen
_id
bereits im Profilspeicher vorhanden ist.In einigen Fällen kann
_id
eine Universally Unique Identifier (UUID) oder eine Globally Unique Identifier (GUID) sein.Wenn Sie Daten aus einer Quellverbindung oder direkt aus einer Parquet-Datei streamen, 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 findet jedoch ab 1970 statt. 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.
Verwenden Sie Adobe Experience Platform Data Prep, um Daten XDM zuzuordnen, umzuwandeln und zu validieren. 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
- MediaAnalytics-Interaktionsdetails
- Anforderungsdetails zitieren
- 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
click
decisioning.propositionInteract
.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.propositionFetch
decisioning.propositionInteract
decisioning.propositionSend
decisioning.propositionTrigger
delivery.feedback
directMarketing.emailBounced
directMarketing.emailBouncedSoft
directMarketing.emailClicked
directMarketing.emailDelivered
directMarketing.emailOpened
directMarketing.emailSent
directMarketing.emailUnsubscribed
display
decisioning.propositionDisplay
.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
media.adBreakStart
media.adComplete
media.adSkip
media.adStart
media.bitrateChange
media.bufferStart
media.bufferStart
wird gesendet, wenn die Pufferung beginnt. Es gibt keinen bestimmten bufferResume
-Ereignistyp. Die Pufferung gilt als wieder aufgenommen, wenn ein play
-Ereignis nach einem bufferStart
-Ereignis gesendet wird.media.chapterComplete
media.chapterSkip
media.chapterStart
media.downloaded
media.error
media.pauseStart
pauseStart
-Ereignis aufgetreten ist. Dieses Ereignis wird ausgelöst, wenn ein Benutzer eine Pause in der Medienwiedergabe initiiert. Es gibt keinen Ereignistyp Fortsetzen . Eine Wiederaufnahme wird erkannt, wenn Sie ein Wiedergabeereignis nach einem pauseStart
senden.media.ping
media.ping
gibt den Status der laufenden Wiedergabe an. Für den Hauptinhalt muss dieses Ereignis während der Wiedergabe alle 10 Sekunden gesendet werden, beginnend 10 Sekunden nach Beginn der Wiedergabe. Für Anzeigeninhalte müssen diese während des Anzeigen-Trackings jede Sekunde gesendet werden. Ping-Ereignisse sollten die params-Zuordnung nicht im Anfragetext enthalten.media.play
media.play
wird gesendet, wenn der Player von einem anderen Status wie buffering,
paused
(wenn er vom Benutzer fortgesetzt wird) in den Status playing
wechselt oder error
(wenn er wiederhergestellt wurde), einschließlich Szenarien wie die automatische Wiedergabe. Dieses Ereignis wird durch den Rückruf on('Playing')
des Players ausgelöst.media.sessionComplete
media.sessionEnd
media.sessionEnd
"benachrichtigt das Media Analytics-Backend, eine Sitzung sofort zu schließen, wenn ein Benutzer die Anzeige beendet und wahrscheinlich nicht zurückkehren wird. Wenn dieses Ereignis nicht gesendet wird, wird die Sitzung nach 10 Minuten Inaktivität oder nach 30 Minuten ohne Verschiebung der Abspielleiste beendet. Alle nachfolgenden Medienaufrufe mit dieser Sitzungs-ID werden ignoriert.media.sessionStart
media.sessionStart
wird mit dem Aufruf zur Sitzungsinitiierung gesendet. Nach Erhalt einer Antwort wird die Sitzungs-ID aus der Location-Kopfzeile extrahiert und für alle nachfolgenden Ereignisaufrufe an den Erfassungsserver verwendet.media.statesUpdate
statesUpdate
-Ereignis aufgetreten ist. Die Player-Status-Tracking-Funktionen können an einen Audio- oder Video-Stream angehängt werden. Die Standardstatus sind: fullscreen
, mute
, closedCaptioning
, pictureInPicture
und inFocus
.opportunityEvent.addToOpportunity
opportunityEvent.opportunityUpdated
opportunityEvent.removeFromOpportunity
personalization.request
decisioning.propositionFetch
.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