XDM ExperienceEvent class
XDM ExperienceEvent är en XDM-klass (Experience Data Model). Använd den här klassen för att skapa en tidsstämplad ögonblicksbild av systemet när en viss händelse inträffar eller när en viss uppsättning villkor har nåtts.
En Experience Event är ett faktaregister över vad som inträffat, inklusive tidpunkten och identiteten för den berörda personen. Händelser kan antingen vara explicita (direkt observerbara mänskliga åtgärder) eller implicita (upphöjda utan en direkt mänsklig åtgärd) och registreras utan aggregering eller tolkning. Mer högnivåinformation om användning av den här klassen i plattformens ekosystem finns i XDM - översikt.
The XDM ExperienceEvent klassen innehåller flera tidsserierelaterade fält till ett schema. Två av dessa fält (_id
och timestamp
) är obligatoriskt för alla scheman baserade på den här klassen, medan resten är valfria. Värdena för vissa av fälten fylls i automatiskt när data hämtas.
_id
(Obligatoriskt)
_id
är ett unikt fält som identifierar enskilda händelser som hämtas till Adobe Experience Platform. Det här fältet används för att spåra en enskild händelses unika karaktär, för att förhindra datadubblering och för att slå upp händelsen i underordnade tjänster.Om dubbletthändelser upptäcks kan plattformsprogram och -tjänster hantera dubbleringen på olika sätt. Duplicerade händelser i profiltjänsten tas till exempel bort om händelsen med samma
_id
finns redan i profilarkivet.I vissa fall
_id
kan vara Universally Unique Identifier (UUID) eller GUID (Global Unique Identifier).Om du direktuppspelar data från en källanslutning eller direkt hämtar data från en Parquet-fil, bör du generera det här värdet genom att sammanfoga en viss kombination av fält som gör händelsen unik. Exempel på händelser som kan sammanfogas är primärt ID, tidsstämpel, händelsetyp och så vidare. Det sammanfogade värdet måste vara ett
uri-reference
formaterad sträng, vilket innebär att alla kolontecken måste tas bort. Efteråt bör det sammanfogade värdet hashas med SHA-256 eller någon annan algoritm som du väljer.Det är viktigt att särskilja det här fältet representerar inte en identitet som relateras till en enskild person, utan själva dataposten. Identitetsuppgifter som rör en person bör begränsas till identitetsfält tillhandahålls av kompatibla fältgrupper i stället.
eventMergeId
eventType
Standardvärden för den här egenskapen finns i appendix-avsnitt, inklusive beskrivningar av deras avsedda användningsfall. Det här fältet är en utökningsbar uppräkning, vilket innebär att du även kan använda egna händelsetypsträngar för att kategorisera de händelser som du spårar.
eventType
begränsar dig till att endast använda en enda händelse per träff i programmet, och därför måste du använda beräkningsfält för att tala om för systemet vilken händelse som är viktigast. Mer information finns i avsnittet om bästa praxis för beräknade fält.producedBy
Vissa föreslagna värden för den här egenskapen finns i appendix-avsnitt. Det här fältet är en utökningsbar uppräkning, vilket innebär att du kan använda dina egna strängar för att representera olika händelseproducenter.
identityMap
Se avsnittet om identitetskartor i grunderna för schemakomposition om du vill ha mer information om deras användningsfall.
timestamp
(Obligatoriskt)
Bästa tillvägagångssätt för händelsemodellering
I följande avsnitt beskrivs de effektivaste strategierna för att utforma händelsebaserade XDM-scheman (Experience Data Model) i Adobe Experience Platform.
Tidsstämplar timestamps
Roten timestamp
fältet för ett händelseschema kan endast representerar själva evenemangets observation och måste inträffa tidigare. Händelsen måste äger rum från och med 1970. Om dina användningsfall för segmentering kräver användning av tidsstämplar som kan inträffa i framtiden, måste dessa värden begränsas någon annanstans i Experience Event-schemat.
Om ett företag inom rese- och turismbranschen till exempel utformar en flygbokningshändelse, ska klassnivån timestamp
-fältet representerar tiden då reservationshändelsen observerades. Andra tidsstämplar som är relaterade till händelsen, t.ex. startdatumet för resereservationen, ska hämtas i separata fält som tillhandahålls av standardfältgrupper eller anpassade fältgrupper.
Genom att hålla tidsstämpeln på klassnivå åtskild från andra relaterade datetime-värden i dina händelsescheman kan du implementera flexibla användningsfall för segmentering samtidigt som du bevarar en tidsstämplad redovisning av kundresor i ditt upplevelseprogram.
Använda beräknade fält calculated
Vissa interaktioner i dina upplevelseprogram kan leda till flera relaterade händelser som tekniskt sett delar samma händelsetidsstämpel och därför kan representeras som en enda händelsepost. Om en kund t.ex. tittar på en produkt på webbplatsen kan detta resultera i en händelsepost som har två möjliga eventType
värden: en produktvy (commerce.productViews
) eller en generisk sidvy (web.webpagedetails.pageViews
). I dessa fall kan du använda beräkningsfält för att hämta de viktigaste attributen när flera händelser fångas in i en enda träff.
Använd Adobe Experience Platform Data Prep att mappa, omvandla och validera data till och från XDM. Använda tillgängliga mappningsfunktioner som tillhandahålls av tjänsten kan du anropa logiska operatorer för att prioritera, omvandla och/eller konsolidera data från poster med flera händelser när de hämtas till Experience Platform. I exemplet ovan kan du ange eventType
som ett beräkningsfält som prioriterar en"produktvy" framför en"sidvy" när båda finns.
Om du hämtar data manuellt till plattformen via användargränssnittet läser du i handboken beräknade fält för specifika steg om hur du skapar beräkningsfält.
Om du direktuppspelar data till plattformen med en källanslutning kan du konfigurera källan så att beräkningsfält används i stället. Se dokumentation för just din källa för instruktioner om hur beräknade fält implementeras när anslutningen konfigureras.
Kompatibla schemafältgrupper field-groups
Adobe har flera standardfältgrupper som kan användas med XDM ExperienceEvent klassen. Nedan följer en lista över några vanliga fältgrupper för klassen:
- 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
Bilaga
Följande avsnitt innehåller ytterligare information om XDM ExperienceEvent klassen.
Godkända värden för eventType
eventType
I följande tabell visas godkända värden för eventType
och deras definitioner:
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
-händelsen har inträffat. Den här händelsen utlöses i början av en annonsbrytning.media.adBreakStart
adBreakStart
-händelsen har inträffat. Den här händelsen utlöses i slutet av en annonsbrytning.media.adComplete
adComplete
-händelsen har inträffat. Den här händelsen utlöses när en annons har slutförts.media.adSkip
adSkip
-händelsen har inträffat. Den här händelsen utlöses när en annons har hoppats över.media.adStart
adStart
-händelsen har inträffat. Den här händelsen utlöses när en annons har startats.media.bitrateChange
bitrateChange
-händelsen har inträffat. Den här händelsen utlöses när bithastigheten ändras.media.bufferStart
bufferStart
-händelsen har inträffat. Den här händelsen utlöses när media har börjat buffras.media.chapterComplete
chapterComplete
-händelsen har inträffat. Den här händelsen utlöses när ett kapitel i mediet har slutförts.media.chapterSkip
chapterSkip
-händelsen har inträffat. Den här händelsen utlöses när en användare går framåt eller bakåt till ett annat avsnitt eller kapitel i medieinnehållet.media.chapterStart
chapterStart
-händelsen har inträffat. Den här händelsen utlöses i början av ett visst avsnitt eller kapitel i medieinnehållet.media.downloaded
media.error
error
-händelsen har inträffat. Den här händelsen utlöses när ett fel eller problem inträffar under medieuppspelningen.media.pauseStart
pauseStart
-händelsen har inträffat. Den här händelsen utlöses när en användare initierar en paus i medieuppspelningen.media.ping
ping
-händelsen har inträffat. Detta verifierar tillgängligheten för en medieresurs.media.play
play
-händelsen har inträffat. Den här händelsen utlöses när medieinnehållet spelas upp, vilket indikerar användarens aktiva förbrukning.media.sessionComplete
sessionComplete
-händelsen har inträffat. Den här händelsen markerar slutet på en mediauppspelningssession.media.sessionEnd
sessionEnd
-händelsen har inträffat. Den här händelsen anger att en mediesession har avslutats. Den här slutsatsen kan innebära att mediespelaren stängs eller att uppspelningen stoppas.media.sessionStart
sessionStart
-händelsen har inträffat. Den här händelsen markerar början på en mediouppspelningssession. Den aktiveras när en användare börjar spela upp en mediefil.media.statesUpdate
statesUpdate
-händelsen har inträffat. Spårningsfunktionerna för spelartillstånd kan kopplas till ett ljud- eller videoflöde. Standardlägena är: helskärm, stängd, bildtext, bildInPicture och inFocus.opportunityEvent.addToOpportunity
opportunityEvent.opportunityUpdated
opportunityEvent.removeFromOpportunity
pushTracking.applicationOpened
pushTracking.customAction
web.formFilledOut
web.webinteraction.linkClicks
web.webpagedetails.pageViews
location.entry
location.exit
Föreslagna värden för producedBy
producedBy
I följande tabell beskrivs några godkända värden för producedBy
:
self
system
salesRef
customerRep