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.

de structuur van XDM ExperienceEvent aangezien het in Platform UI verschijnt.

Eigenschap
Beschrijving
_id
(Required)
In het veld Experience Event Class _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
Als het gebruiken van SDK van het Web van Adobe Experience Platformom gegevens in te voeren, vertegenwoordigt dit identiteitskaart van de ingebedde partij die het te creëren verslag veroorzaakte. Dit veld wordt automatisch ingevuld door het systeem bij het invoeren van gegevens. Het gebruik van dit gebied buiten de context van een implementatie van SDK van het Web wordt niet gesteund.
eventType
Een tekenreeks die het type of de categorie voor de gebeurtenis aangeeft. Dit gebied kan worden gebruikt als u verschillende gebeurtenistypen binnen het zelfde schema en de dataset wilt onderscheiden, zoals het onderscheiden van een gebeurtenis van de productmening van toe:voegen-aan-winkelwagentje voor een detailhandelsbedrijf.

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
Een tekenreekswaarde die de producent of oorsprong van de gebeurtenis beschrijft. Dit veld kan worden gebruikt om bepaalde gebeurtenisproducenten uit te filteren als dat voor segmentatiedoeleinden nodig is.

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
Een toewijzingsveld dat een set naamloze identiteiten bevat voor het individu waarop de gebeurtenis van toepassing is. Dit veld wordt automatisch door het systeem bijgewerkt wanneer er identiteitsgegevens worden ingevoerd. Om dit gebied voor Real-Time Profiel van de Klantbehoorlijk te gebruiken, probeer niet manueel om de inhoud van het gebied in uw gegevensverrichtingen bij te werken.

zie de sectie over identiteitskaarten in de grondbeginselen van schemacompositievoor meer informatie over hun gebruiksgeval.
timestamp
(Required)
Een tijdstempel van ISO 8601 van toen de gebeurtenis voorkwam, die volgens RFC 3339 Sectie 5.6wordt geformatteerd. Dit timestamp moet in het verleden voorkomen, maar moet van 1970 en daarna plaatsvinden. Zie de sectie hieronder op timestampsvoor beste praktijken op het gebruik van dit gebied.

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.

het schema van de Gebeurtenis van de steekproefervaring van A met benadrukte Reserve van de Vlucht en Datum van het Begin.

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

NOTE
De namen van verschillende veldgroepen zijn gewijzigd. Zie het document op de naamupdates van de gebiedsgroepvoor meer informatie.

Adobe biedt verschillende standaardveldgroepen voor gebruik met de XDM ExperienceEvent -klasse. Hieronder volgt een lijst met enkele veelgebruikte veldgroepen voor de klasse:

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:

Waarde
Definitie
advertising.clicks
Deze gebeurtenis wordt bijgehouden wanneer een actie om een advertentie te selecteren plaatsvindt.
advertising.completes
Deze gebeurtenis volgt wanneer een getimed media-element is gecontroleerd op voltooiing. Dit betekent niet noodzakelijkerwijs dat de viewer de hele video heeft bekeken, omdat de viewer vooruit had kunnen slaan.
advertising.conversions
Deze gebeurtenis volgt een vooraf bepaalde actie die door een klant wordt uitgevoerd die een gebeurtenis voor prestatiesevaluatie teweegbrengt.
advertising.federated
Deze gebeurtenis controleert of een Gebeurtenis van de Ervaring door gegevensfederatie (gegevens het delen tussen klanten) werd gecreeerd.
advertising.firstQuartiles
Deze gebeurtenis houdt bij wanneer een digitale video 25% van de duur bij normale snelheid heeft afgespeeld.
advertising.impressions
Deze gebeurtenis volgt de indrukken van een advertentie voor een klant die het potentieel heeft om te worden bekeken.
advertising.midpoints
Deze gebeurtenis houdt bij wanneer een digitale video 50% van de duur bij normale snelheid heeft afgespeeld.
advertising.starts
Deze gebeurtenis volgt wanneer een digitale video is afgespeeld.
advertising.thirdQuartiles
Deze gebeurtenis houdt bij wanneer een digitale video 75% van de duur bij normale snelheid heeft afgespeeld.
advertising.timePlayed
Deze gebeurtenis houdt de hoeveelheid tijd bij die een gebruiker aan een specifiek getimed media middel doorbrengt.
application.close
Deze gebeurtenis volgt wanneer een toepassing werd gesloten of op de achtergrond werd verzonden.
application.launch
Deze gebeurtenis wordt bijgehouden wanneer een toepassing werd gestart of op de voorgrond werd geplaatst.
commerce.backofficeCreditMemoIssued
Deze gebeurtenis volgt wanneer een kredietkennisgeving aan een klant is uitgegeven.
commerce.backofficeOrderCancelled
Deze gebeurtenis volgt wanneer een eerder geïnitieerd aankoopproces vóór voltooiing is geëindigd.
commerce.backofficeOrderItemsShipped
Deze gebeurtenis volgt wanneer de aangeschafte items fysiek naar de klant zijn verzonden.
commerce.backofficeOrderPlaced
Deze gebeurtenis volgt de plaatsing van een bestelling.
commerce.backofficeShipmentCompleted
Deze gebeurtenis houdt de succesvolle voltooiing van het volledige verzendproces bij.
commerce.checkouts
Deze gebeurtenis wordt bijgehouden wanneer een uitcheckgebeurtenis voor een productlijst is opgetreden. Er kunnen meer dan één uitcheckgebeurtenis zijn als er meerdere stappen in een uitcheckproces zijn. Als er meerdere stappen zijn, worden de tijdstempel en de pagina/ervaring waarnaar wordt verwezen voor elke gebeurtenis gebruikt om elke afzonderlijke gebeurtenis (stap) in volgorde weer te geven.
commerce.productListAdds
Deze gebeurtenis wordt bijgehouden wanneer een product aan de productlijst of winkelwagentje is toegevoegd.
commerce.productListOpens
Deze gebeurtenis wordt bijgehouden wanneer een nieuwe productlijst (winkelwagentje) is geïnitialiseerd of gemaakt.
commerce.productListRemovals
Deze gebeurtenis wordt bijgehouden wanneer een product-item uit een productlijst of winkelwagentje is verwijderd.
commerce.productListReopens
Deze gebeurtenis volgt wanneer een productlijst (winkelwagentje) die niet meer toegankelijk (verlaten) was opnieuw door een klant, zoals via een hermarketing activiteit is geactiveerd.
commerce.productListViews
Deze gebeurtenis wordt bijgehouden wanneer een productlijst of winkelwagentje een weergave heeft ontvangen.
commerce.productViews
Deze gebeurtenis wordt bijgehouden wanneer een product een of meer weergaven heeft ontvangen.
commerce.purchases
Deze gebeurtenis volgt wanneer een bestelling is geaccepteerd. Dit is de enige vereiste actie in een commerciële omschakeling. Er moet naar een aankoopgebeurtenis worden verwezen in een productlijst.
commerce.saveForLaters
Deze gebeurtenis wordt bijgehouden wanneer een productlijst voor toekomstig gebruik is opgeslagen, zoals een verlanglijst van het product.
decisioning.propositionDisplay
Deze gebeurtenis volgt wanneer een beslissingsvoorstel aan een persoon werd getoond.
decisioning.propositionDismiss
Deze gebeurtenis volgt wanneer is besloten om zich niet aan de voorgestelde aanbieding te houden.
decisioning.propositionInteract
Deze gebeurtenis volgt wanneer een persoon met een beslissingsvoorstel interactie heeft gehad.
decisioning.propositionSend
Deze gebeurtenis volgt wanneer is besloten om een aanbeveling of een aanbieding onder bezwarende titel naar een potentiële klant te sturen.
decisioning.propositionTrigger
Deze gebeurtenis houdt de activering van een propositieproces bij. Er is een bepaalde voorwaarde of handeling opgetreden om de presentatie van een aanbieding te vragen.
delivery.feedback
Deze gebeurtenis houdt feedbackgebeurtenissen bij voor een levering, zoals een e-maillevering.
directMarketing.emailBounced
Deze gebeurtenis wordt bijgehouden wanneer een e-mail naar een persoon wordt teruggestuurd.
directMarketing.emailBouncedSoft
Deze gebeurtenis wordt bijgehouden wanneer een e-mail naar een persoon met een elektronische vorm wordt verzonden.
directMarketing.emailClicked
Deze gebeurtenis wordt bijgehouden wanneer iemand op een koppeling in een marketingmail heeft geklikt.
directMarketing.emailDelivered
Deze gebeurtenis wordt bijgehouden wanneer een e-mailbericht naar de e-mailservice van een persoon is verzonden.
directMarketing.emailOpened
Deze gebeurtenis wordt bijgehouden wanneer een persoon een marketingbericht heeft geopend.
directMarketing.emailSent
Deze gebeurtenis wordt bijgehouden wanneer een marketingbericht naar een persoon is verzonden.
directMarketing.emailUnsubscribed
Deze gebeurtenis wordt bijgehouden wanneer een persoon zich niet meer heeft geabonneerd op een marketingmail.
inappmessageTracking.dismiss
Deze gebeurtenis wordt bijgehouden wanneer een bericht in de app is gesloten.
inappmessageTracking.display
Deze gebeurtenis wordt bijgehouden wanneer een bericht in de app werd weergegeven.
inappmessageTracking.interact
Deze gebeurtenis wordt bijgehouden wanneer er interactie plaatsvindt tussen een bericht in de app.
leadOperation.callWebhook
Deze gebeurtenis houdt bij wanneer een webhaak wordt aangeroepen als reactie op een lead.
leadOperation.changeCampaignStream
Deze gebeurtenis betekent een verschuiving in de marketing- of betrokkenheidsstrategie voor een bepaalde lead in het bedrijf.
leadOperation.changeEngagementCampaignCadence
Deze gebeurtenis volgt wanneer er een wijziging is opgetreden in hoe vaak een lead wordt gebruikt als onderdeel van een campagne.
leadOperation.convertLead
Deze gebeurtenis volgt wanneer een lead werd geconverteerd.
leadOperation.interestingMoment
Deze gebeurtenis volgt wanneer een interessant moment voor een persoon werd opgenomen.
leadOperation.mergeLeads
Deze gebeurtenis volgt wanneer informatie van meerdere leads die naar dezelfde entiteit verwijzen, zijn geconsolideerd.
leadOperation.newLead
Deze gebeurtenis volgt wanneer een lead is gemaakt.
leadOperation.scoreChanged
Deze gebeurtenis volgt wanneer de waarde van het score-kenmerk van de lead is gewijzigd.
leadOperation.statusInCampaignProgressionChanged
Deze gebeurtenis wordt bijgehouden wanneer de status van een lead in een campagne is gewijzigd.
listOperation.addToList
Deze gebeurtenis volgt wanneer een persoon aan een marketing lijst werd toegevoegd.
listOperation.removeFromList
Deze gebeurtenis volgt wanneer een persoon uit een marketinglijst werd verwijderd.
media.adBreakComplete
Deze gebeurtenis volgt wanneer een adBreakComplete -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd aan het begin van een advertentie-einde.
media.adBreakStart
Deze gebeurtenis volgt wanneer een adBreakStart -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd aan het einde van een advertentie-einde.
media.adComplete
Deze gebeurtenis volgt wanneer een adComplete -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een advertentie is voltooid.
media.adSkip
Deze gebeurtenis volgt wanneer een adSkip -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een advertentie is overgeslagen.
media.adStart
Deze gebeurtenis volgt wanneer een adStart -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een advertentie is gestart.
media.bitrateChange
Deze gebeurtenis volgt wanneer een bitrateChange -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer de bitsnelheid wordt gewijzigd.
media.bufferStart
Deze gebeurtenis volgt wanneer een bufferStart -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer media beginnen te bufferen.
media.chapterComplete
Deze gebeurtenis volgt wanneer een chapterComplete -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een hoofdstuk in de media is voltooid.
media.chapterSkip
Deze gebeurtenis volgt wanneer een chapterSkip -gebeurtenis 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
Deze gebeurtenis volgt wanneer een chapterStart -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd aan het begin van een specifieke sectie of een specifiek hoofdstuk in de media-inhoud.
media.downloaded
Deze gebeurtenis houdt bij wanneer media gedownloade inhoud heeft plaatsgevonden.
media.error
Deze gebeurtenis volgt wanneer een error -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een fout of probleem optreedt tijdens het afspelen van media.
media.pauseStart
Deze gebeurtenis volgt wanneer een pauseStart -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer een gebruiker een pauze instelt in het afspelen van media.
media.ping
Deze gebeurtenis volgt wanneer een ping -gebeurtenis heeft plaatsgevonden. Dit verifieert de beschikbaarheid van een media middel.
media.play
Deze gebeurtenis volgt wanneer een play -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis wordt geactiveerd wanneer de media-inhoud wordt afgespeeld, wat een actief verbruik door de gebruiker aangeeft.
media.sessionComplete
Deze gebeurtenis volgt wanneer een sessionComplete -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis markeert het einde van een mediaflaysessie.
media.sessionEnd
Deze gebeurtenis volgt wanneer een sessionEnd -gebeurtenis 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
Deze gebeurtenis volgt wanneer een sessionStart -gebeurtenis heeft plaatsgevonden. Deze gebeurtenis markeert het begin van een mediaflaysessie. Deze wordt geactiveerd wanneer een gebruiker een mediabestand begint af te spelen.
media.statesUpdate
Deze gebeurtenis volgt wanneer een statesUpdate -gebeurtenis 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
Deze gebeurtenis volgt wanneer een persoon aan een kans werd toegevoegd.
opportunityEvent.opportunityUpdated
Deze gebeurtenis wordt bijgehouden wanneer een opportuniteit is bijgewerkt.
opportunityEvent.removeFromOpportunity
Deze gebeurtenis wordt bijgehouden wanneer een persoon uit een opportuniteit is verwijderd.
pushTracking.applicationOpened
Deze gebeurtenis wordt bijgehouden wanneer een persoon een toepassing heeft geopend via een pushmelding.
pushTracking.customAction
Deze gebeurtenis wordt bijgehouden wanneer een persoon een aangepaste actie in een pushmelding heeft geselecteerd.
web.formFilledOut
Deze gebeurtenis volgt wanneer een persoon een formulier op een webpagina heeft ingevuld.
web.webinteraction.linkClicks
Deze gebeurtenis houdt bij wanneer een koppeling een of meer keren is geselecteerd.
web.webpagedetails.pageViews
Deze gebeurtenis wordt bijgehouden wanneer een webpagina een of meer weergaven heeft ontvangen.
location.entry
Deze gebeurtenis houdt de ingang van een persoon of een apparaat op een specifieke plaats bij.
location.exit
Deze gebeurtenis houdt het afsluiten van een persoon of apparaat vanaf een specifieke locatie bij.

Voorgestelde waarden voor producedBy producedBy

In de volgende tabel worden enkele toegestane waarden voor producedBy weergegeven:

Waarde
Definitie
self
Zelf
system
Systeem
salesRef
Verkoopvertegenwoordiger
customerRep
Vertegenwoordiger van klant
recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07