XDM ExperienceEvent class
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. Raadpleeg voor meer informatie op hoog niveau over het gebruik van deze klasse in het ecosysteem van het platform de XDM-overzicht.
De XDM ExperienceEvent De klasse zelf verstrekt verscheidene op tijd-reeksen betrekking hebbende gebieden aan een schema. Twee van deze velden (_id
en timestamp
) zijn 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
(Vereist)
_id
in het veld worden afzonderlijke gebeurtenissen die in Adobe Experience Platform worden ingevoerd, afzonderlijk geïdentificeerd. 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.Wanneer dubbele gebeurtenissen worden ontdekt, kunnen de toepassingen en de diensten van het Platform de duplicatie verschillend behandelen. Bijvoorbeeld, dubbele gebeurtenissen in de Dienst van het Profiel worden gelaten vallen als de gebeurtenis met het zelfde
_id
bestaat al in het archief met profielen.In sommige gevallen
_id
kan een Universally Unique Identifier (UUID) of Globally Unique Identifier (GUID).Als u gegevens streamt via een bronverbinding of rechtstreeks vanuit een Parquet-bestand opgeeft, moet u deze waarde genereren door een bepaalde combinatie van velden samen te voegen die de gebeurtenis uniek maken. Voorbeelden van gebeurtenissen die kunnen worden samengevoegd, zijn primaire id, tijdstempel, gebeurtenistype, enzovoort. De samengevoegde waarde moet een
uri-reference
geformatteerde tekenreeks: eventuele 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 van belang te onderscheiden dat dit veld vertegenwoordigt geen identiteit die betrekking heeft op een individuele persoon, maar eerder de gegevensregistratie zelf. Identiteitsgegevens betreffende een persoon moeten worden beperkt tot identiteitsvelden in plaats daarvan worden verstrekt door compatibele veldgroepen.
eventMergeId
eventType
Standaardwaarden voor deze eigenschap worden gegeven in het gedeelte aanhangsel, met een beschrijving van het beoogde gebruik. 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 hit op uw toepassing en daarom moet u berekende velden gebruiken om het systeem te laten weten welke gebeurtenis het belangrijkst is. Zie de sectie over aanbevolen procedures voor berekende velden.producedBy
Sommige voorgestelde waarden voor deze eigenschap zijn opgenomen in het dialoogvenster aanhangsel. 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 het dialoogvenster grondbeginselen van de schemacompositie voor meer informatie over het gebruik ervan .
timestamp
(Vereist)
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
De basis timestamp
veld van een gebeurtenisschema kan alleen de waarneming van het evenement zelf vertegenwoordigen en in het verleden moeten plaatsvinden. De gebeurtenis moet vanaf 1970. 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 gastsector bijvoorbeeld een vluchtreserveringsevenement modelleert, moet de klasse timestamp
wordt het tijdstip weergegeven waarop de reserveringsgebeurtenis is 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. Als een klant bijvoorbeeld een product op uw website weergeeft, kan dit resulteren in een gebeurtenisrecord met twee mogelijke eventType
waarden: een "product view"-gebeurtenis (commerce.productViews
) of een algemene gebeurtenis "paginaweergave" (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.
Gebruiken Adobe Experience Platform Data Prep om gegevens toe te wijzen, om te zetten en te bevestigen aan en van XDM. De beschikbare toewijzingsfuncties Wordt geleverd door de service. U kunt logische operatoren aanroepen om gegevens uit records met meerdere gebeurtenissen bij het opnemen in het Experience Platform prioriteit te geven, te transformeren en/of te consolideren. In het bovenstaande voorbeeld kunt u eventType
als een berekend veld dat voorrang geeft aan een "productweergave" boven een "paginaweergave" wanneer deze beide voorkomen.
Als u gegevens handmatig via de gebruikersinterface in Platform opneemt, raadpleegt u de handleiding berekende velden voor specifieke stappen voor het maken van berekende velden.
Als u gegevens aan Platform stroomt gebruikend een bronverbinding, kunt u de bron vormen om berekende gebieden in plaats daarvan te gebruiken. Zie de documentatie voor uw specifieke bron voor 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 XDM ExperienceEvent klasse.
Geaccepteerde waarden voor eventType
eventType
In de volgende tabel worden de toegestane waarden voor eventType
, alsmede de definities ervan:
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
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd aan het begin van een advertentie-einde.media.adBreakStart
adBreakStart
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd aan het einde van een advertentie-einde.media.adComplete
adComplete
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een advertentie is voltooid.media.adSkip
adSkip
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een advertentie is overgeslagen.media.adStart
adStart
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een advertentie is gestart.media.bitrateChange
bitrateChange
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer de bitsnelheid wordt gewijzigd.media.bufferStart
bufferStart
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer media beginnen te bufferen.media.chapterComplete
chapterComplete
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een hoofdstuk in de media is voltooid.media.chapterSkip
chapterSkip
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een gebruiker een ander gedeelte of hoofdstuk binnen de media-inhoud naar voren of achteren overslaat.media.chapterStart
chapterStart
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd aan het begin van een specifieke sectie of een specifiek hoofdstuk in de media-inhoud.media.downloaded
media.error
error
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een fout of probleem optreedt tijdens het afspelen van media.media.pauseStart
pauseStart
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een gebruiker een pauze instelt in het afspelen van media.media.ping
ping
heeft plaatsgevonden. Dit verifieert de beschikbaarheid van een media middel.media.play
play
heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer de media-inhoud wordt afgespeeld, wat een actief verbruik door de gebruiker aangeeft.media.sessionComplete
sessionComplete
heeft plaatsgevonden. Deze gebeurtenis markeert het einde van een mediaflaysessie.media.sessionEnd
sessionEnd
heeft plaatsgevonden. Deze gebeurtenis geeft het einde van een mediasessie aan. Deze conclusie kan inhouden dat de mediaspeler wordt gesloten of dat het afspelen wordt gestopt.media.sessionStart
sessionStart
heeft plaatsgevonden. Deze gebeurtenis markeert het begin van een mediaflaysessie. Deze wordt geactiveerd wanneer een gebruiker een mediabestand begint af te spelen.media.statesUpdate
statesUpdate
heeft plaatsgevonden. De mogelijkheden voor het bijhouden van de spelerstatus kunnen worden gekoppeld aan een audio- of videostream. De standaardstatussen zijn: volledig scherm, dempen, closedCaptioning, pictureInPicture, en inFocus.opportunityEvent.addToOpportunity
opportunityEvent.opportunityUpdated
opportunityEvent.removeFromOpportunity
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
:
self
system
salesRef
customerRep