XDM ExperienceEvent -klasse
XDM ExperienceEvent is een standaard XDM-klasse (Experience Data Model). Gebruik deze klasse om een momentopname met tijdstempels van het systeem te maken wanneer een specifieke gebeurtenis voorkomt of een bepaalde reeks voorwaarden is bereikt.
Een ervaringsgebeurtenis is een feitenverslag van wat voorkwam, met inbegrip van het tijdstip en de identiteit van de betrokken persoon. Gebeurtenissen kunnen expliciet (direct waarneembare menselijke acties) of impliciet (zonder directe menselijke actie) zijn en worden geregistreerd zonder aggregatie of interpretatie. Voor meer informatie op hoog niveau over het gebruik van deze klasse in het ecosysteem van het Platform, verwijs naar het XDM overzicht.
De XDM ExperienceEvent -klasse zelf biedt verschillende aan tijdreeksen gerelateerde velden voor een schema. Twee van deze gebieden (_id
en timestamp
) worden vereist voor alle schema's die op deze klasse worden gebaseerd, terwijl de rest facultatief is. De waarden van sommige velden worden automatisch ingevuld wanneer gegevens worden ingevoerd.
_id
(Required)
_id
worden afzonderlijke gebeurtenissen geïdentificeerd die in Adobe Experience Platform worden opgenomen. Dit veld wordt gebruikt om de unieke aard van een individuele gebeurtenis te volgen, om te voorkomen dat gegevens worden herhaald en om die gebeurtenis in downstreamdiensten op te zoeken.waar de dubbele gebeurtenissen worden ontdekt, kunnen de toepassingen en de diensten van het Platform de verdubbeling verschillend behandelen. Dubbele gebeurtenissen in de profielservice worden bijvoorbeeld verwijderd als de gebeurtenis met dezelfde
_id
al bestaat in de profielopslag.in sommige gevallen,
_id
kan a Universally Unique Identifier (UUID)of globally Unieke Identifier (GUID)zijn.als u gegevens van een bronverbinding stroomt of direct van een dossier van het Pakket inneemt, zou u deze waarde moeten produceren door een bepaalde combinatie gebieden aaneengeschakeld die de gebeurtenis uniek maken. Voorbeelden van gebeurtenissen die kunnen worden samengevoegd, zijn primaire id, tijdstempel, gebeurtenistype, enzovoort. De samengevoegde waarde moet een tekenreeks met
uri-reference
opmaak zijn. Dit houdt in dat alle dubbele tekens moeten worden verwijderd. Daarna, zou de samengevoegde waarde moeten worden gehakt gebruikend SHA-256 of een ander algoritme van uw keus.het is belangrijk om te onderscheiden dat dit gebied geen identiteit met betrekking tot een individuele persoon vertegenwoordigt, maar eerder het verslag van gegevens zelf. Identiteitsgegevens met betrekking tot een persoon zouden aan identiteitsgebiedenmoeten worden beperkt die door compatibele gebiedsgroepen in plaats daarvan worden verstrekt.
eventMergeId
eventType
Standaardwaarden voor dit bezit worden verstrekt in de appendix sectie, met inbegrip van beschrijvingen van hun voorgenomen gebruiksgeval. Dit veld is een uitbreidbare opsomming. Dit houdt in dat u ook uw eigen tekenreeksen voor gebeurtenistypen kunt gebruiken om de gebeurtenissen die u bijhoudt, te categoriseren.
eventType
beperkt u tot het gebruik van slechts één gebeurtenis per treffer voor uw toepassing. Daarom moet u berekende velden gebruiken om het systeem te laten weten welke gebeurtenis het belangrijkst is. Voor meer informatie, zie de sectie over beste praktijken voor berekende gebieden.producedBy
Sommige voorgestelde waarden voor dit bezit worden verstrekt in de appendix sectie. Dit veld is een uitbreidbare opsomming. Dit houdt in dat u ook uw eigen tekenreeksen kunt gebruiken om verschillende gebeurtenisproducenten te vertegenwoordigen.
identityMap
zie de sectie over identiteitskaarten in de grondbeginselen van schemacompositievoor meer informatie over hun gebruiksgeval.
timestamp
(Required)
Aanbevolen procedures voor het modelleren van gebeurtenissen
De volgende secties behandelen beste praktijken voor het ontwerpen van uw op gebeurtenis-gebaseerde schema's van de Gegevens van de Ervaring (XDM) in Adobe Experience Platform.
Tijdstempels timestamps
Het wortel timestamp
gebied van een gebeurtenisschema kan slechts de observatie van de gebeurtenis vertegenwoordigen zelf, en moet in het verleden voorkomen. Nochtans, moet de gebeurtenis vanaf 1970 plaatsvinden. Als voor uw segmentatiegebruik tijdstempels moeten worden gebruikt die in de toekomst kunnen voorkomen, moeten deze waarden elders in het schema van de Experience-gebeurtenis worden beperkt.
Als een bedrijf in de reis- en gastensector bijvoorbeeld een gebeurtenis voor reservering van vluchten modelleert, geeft het veld op klasseniveau timestamp
de tijd weer waarop de reserveringsgebeurtenis werd waargenomen. Andere tijdstempels die verband houden met de gebeurtenis, zoals de begindatum van de reisreservering, moeten worden vastgelegd in afzonderlijke velden die worden verschaft door standaard- of aangepaste veldgroepen.
Door de klasse-vlakke timestamp gescheiden van andere verwante datetime waarden in uw gebeurtenisschema's te houden, kunt u de flexibele gevallen van het segmentatiegebruik uitvoeren terwijl het bewaren van een timestamped rekening van klantenreizen in uw ervaringstoepassing.
Berekende velden gebruiken calculated
Bepaalde interacties in uw ervaringstoepassingen kunnen resulteren in meerdere gerelateerde gebeurtenissen die technisch dezelfde tijdstempel voor de gebeurtenis hebben en daarom kunnen worden weergegeven als één gebeurtenisrecord. Bijvoorbeeld, als een klant een product op uw website bekijkt, kan dit in een gebeurtenisverslag resulteren dat twee potentiële eventType
waarden heeft: een "product view"gebeurtenis (commerce.productViews
) of een generische "paginamening"gebeurtenis (web.webpagedetails.pageViews
). In deze gevallen kunt u berekende velden gebruiken om de belangrijkste kenmerken vast te leggen wanneer meerdere gebeurtenissen in één keer worden vastgelegd.
Het gebruik Prep van Gegevens van Adobe Experience Platformaan kaart, transformatie, en bevestigt gegevens aan en van XDM. Gebruikend de beschikbare kaartfunctiesdie door de dienst worden verstrekt kunt u logische exploitanten aanhalen om, gegevens van multi-gebeurtenisverslagen voorrang te geven te transformeren en/of te consolideren wanneer in Experience Platform worden opgenomen. In het bovenstaande voorbeeld kunt u eventType
aanwijzen als een berekend veld dat voorrang geeft aan een "productweergave" boven een "paginaweergave" wanneer beide voorkomen.
Als u manueel gegevens in Platform via UI opneemt, zie de gids op berekende gebiedenvoor specifieke stappen op hoe te om berekende gebieden tot stand te brengen.
Als u gegevens aan Platform stroomt gebruikend een bronverbinding, kunt u de bron vormen om berekende gebieden in plaats daarvan te gebruiken. Verwijs naar de documentatie voor uw bijzondere bronvoor instructies op hoe te om berekende gebieden uit te voeren wanneer het vormen van de verbinding.
Compatibele schemaveldgroepen field-groups
Adobe biedt verschillende standaardveldgroepen voor gebruik met de XDM ExperienceEvent -klasse. Hieronder volgt een lijst met enkele veelgebruikte veldgroepen voor de klasse:
- Adobe Analytics ExperienceEvent Full Extension
- Balance Transfers
- Campaign Marketing Details
- Card Actions
- Channel Details
- Commerce Details
- Deposit Details
- Device Trade-In Details
- Dining Reservation
- End User ID Details
- Environment Details
- Flight Reservation
- IAB TCF 2.0 Consent
- Lodging Reservation
- MediaAnalytics Interaction Details
- Quote Request Details
- Reservation Details
- Web Details
Bijlage
De volgende sectie bevat aanvullende informatie over de klasse XDM ExperienceEvent .
Geaccepteerde waarden voor eventType
eventType
In de volgende tabel worden de toegestane waarden voor eventType
weergegeven, samen met de bijbehorende definities:
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
wordt verzonden wanneer het bufferen begint. Er is geen specifiek gebeurtenistype bufferResume
. Het bufferen wordt verondersteld te zijn hervat wanneer een play
-gebeurtenis wordt verzonden na een bufferStart
-gebeurtenis.media.chapterComplete
media.chapterSkip
media.chapterStart
media.downloaded
media.error
media.pauseStart
pauseStart
-gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een gebruiker een pauze instelt in het afspelen van media. Er is geen type hervattingsgebeurtenis. Er wordt een resume gegenereerd wanneer u een afspeelgebeurtenis na een pauseStart
verzendt.media.ping
media.ping
wordt gebruikt om de doorlopende afspeelstatus aan te geven. Voor hoofdinhoud moet deze gebeurtenis om de 10 seconden tijdens het afspelen worden verzonden, te beginnen 10 seconden nadat het afspelen is gestart. Voor advertentie-inhoud moet deze elke seconde worden verzonden tijdens het bijhouden van de advertentie. Pingel gebeurtenissen zouden niet de paramentenkaart in het verzoeklichaam moeten omvatten.media.play
media.play
wordt verzonden wanneer de speler van een andere status naar de status playing
overschakelt, zoals buffering,
paused
(wanneer deze wordt hervat door de gebruiker) of error
(wanneer deze wordt hersteld), inclusief scenario's zoals automatisch afspelen. Deze gebeurtenis wordt geactiveerd door de callback van de speler on('Playing')
.media.sessionComplete
media.sessionEnd
media.sessionEnd
geeft een melding aan de achtergrond van Media Analytics om een sessie onmiddellijk te sluiten wanneer een gebruiker de weergave beëindigt en deze waarschijnlijk niet zal retourneren. Als deze gebeurtenis niet wordt verzonden, wordt de sessie beëindigd na 10 minuten inactiviteit of 30 minuten zonder beweging van de afspeelkop. Alle volgende mediaquery's met die sessie-id worden genegeerd.media.sessionStart
media.sessionStart
wordt verzonden met de vraag van de zittingsopening. Bij het ontvangen van een reactie, wordt identiteitskaart van de Zitting gehaald uit de kopbal van de Plaats en gebruikt voor alle verdere gebeurtenisvraag aan de server van de Inzameling.media.statesUpdate
statesUpdate
-gebeurtenis heeft plaatsgevonden. De mogelijkheden voor het bijhouden van de spelerstatus kunnen worden gekoppeld aan een audio- of videostream. De standaardstatussen zijn: fullscreen
, mute
, closedCaptioning
, pictureInPicture
en 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
Voorgestelde waarden voor producedBy
producedBy
In de volgende tabel worden enkele toegestane waarden voor producedBy
weergegeven:
self
system
salesRef
customerRep