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 Experience 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 Experience Platform de verdubbeling verschillend behandelen. Dubbele gebeurtenissen in de profielservice worden bijvoorbeeld verwijderd als de gebeurtenis met dezelfde
_id al bestaat in de profielopslag. Deze gebeurtenissen zullen echter nog steeds in het dataplak worden geregistreerd.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 identiteitsgebieden moeten worden beperkt die door compatibele gebiedsgroepen in plaats daarvan worden verstrekt.
eventMergeIdeventTypeStandaardwaarden 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 .producedBySommige 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.
identityMapzie de sectie over identiteitskaarten in de grondbeginselen van schemacompositie voor 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 Platform aan kaart, transformatie, en bevestigt gegevens aan en van XDM. Gebruikend de beschikbare kaartfuncties die 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 Experience Platform via UI opneemt, zie de gids op berekende gebieden voor specifieke stappen op hoe te om berekende gebieden tot stand te brengen.
Als u gegevens naar Experience Platform streamt via een bronverbinding, kunt u de bron zodanig configureren dat berekende velden worden gebruikt. Verwijs naar de documentatie voor uw bijzondere 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
- Adobe Advertising Cloud 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.clicksadvertising.completesadvertising.conversionsadvertising.federatedadvertising.firstQuartilesadvertising.impressionsadvertising.midpointsadvertising.startsadvertising.thirdQuartilesadvertising.timePlayedapplication.closeapplication.launchclickdecisioning.propositionInteract.commerce.backofficeCreditMemoIssuedcommerce.backofficeOrderCancelledcommerce.backofficeOrderItemsShippedcommerce.backofficeOrderPlacedcommerce.backofficeShipmentCompletedcommerce.checkoutscommerce.productListAddscommerce.productListOpenscommerce.productListRemovalscommerce.productListReopenscommerce.productListViewscommerce.productViewscommerce.purchasescommerce.saveForLatersdecisioning.propositionDisplaydecisioning.propositionDismissdecisioning.propositionFetchdecisioning.propositionInteractdecisioning.propositionSenddecisioning.propositionTriggerdelivery.feedbackdirectMarketing.emailBounceddirectMarketing.emailBouncedSoftdirectMarketing.emailClickeddirectMarketing.emailDelivereddirectMarketing.emailOpeneddirectMarketing.emailSentdirectMarketing.emailUnsubscribeddisplaydecisioning.propositionDisplay.inappmessageTracking.dismissinappmessageTracking.displayinappmessageTracking.interactleadOperation.callWebhookleadOperation.changeCampaignStreamleadOperation.changeEngagementCampaignCadenceleadOperation.convertLeadleadOperation.interestingMomentleadOperation.mergeLeadsleadOperation.newLeadleadOperation.scoreChangedleadOperation.statusInCampaignProgressionChangedlistOperation.addToListlistOperation.removeFromListmedia.adBreakCompletemedia.adBreakStartmedia.adCompletemedia.adSkipmedia.adStartmedia.bitrateChangemedia.bufferStartmedia.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.chapterCompletemedia.chapterSkipmedia.chapterStartmedia.downloadedmedia.errormedia.pauseStartpauseStart -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.pingmedia.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.playmedia.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.sessionCompletemedia.sessionEndmedia.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.sessionStartmedia.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.statesUpdatestatesUpdate -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.addToOpportunityopportunityEvent.opportunityUpdatedopportunityEvent.removeFromOpportunitypersonalization.requestdecisioning.propositionFetch.pushTracking.applicationOpenedpushTracking.customActionweb.formFilledOutweb.webinteraction.linkClicksweb.webpagedetails.pageViewslocation.entrylocation.exitVoorgestelde waarden voor producedBy producedBy
In de volgende tabel worden enkele toegestane waarden voor producedBy weergegeven:
selfsystemsalesRefcustomerRep