DocumentazioneExperience PlatformGuida di Experience Data Model (XDM)

XDM ExperienceEvent classe

Last update: Wed May 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer

XDM ExperienceEvent è una classe XDM (Experience Data Model) standard. Utilizzare questa classe per creare uno snapshot con marca temporale del sistema quando si verifica un evento specifico o viene raggiunto un determinato set di condizioni.

Un evento esperienza è una registrazione fattuale di ciò che si è verificato, incluso il momento e l’identità dell’individuo coinvolto. Gli eventi possono essere espliciti (azioni umane direttamente osservabili) o impliciti (generati senza un'azione umana diretta) e sono registrati senza aggregazione o interpretazione. Per ulteriori informazioni di alto livello sull’utilizzo di questa classe nell’ecosistema Platform, consulta Panoramica di XDM.

Il XDM ExperienceEvent La classe stessa fornisce a uno schema diversi campi relativi a serie temporali. Due campi (_id e timestamp) sono obbligatorio per tutti gli schemi basati su questa classe, mentre gli altri sono facoltativi. I valori di alcuni campi vengono compilati automaticamente al momento dell’acquisizione dei dati.

La struttura di ExperienceEvent XDM così come viene visualizzata nell’interfaccia utente di Platform.

Proprietà
Descrizione
_id
(Obbligatorio)
La classe dell’evento esperienza _id questo campo identifica in modo univoco i singoli eventi acquisiti in Adobe Experience Platform. Questo campo viene utilizzato per tenere traccia dell’univocità di un singolo evento, evitare la duplicazione di dati e cercare tale evento nei servizi a valle.

Se vengono rilevati eventi duplicati, le applicazioni e i servizi Platform possono gestire la duplicazione in modo diverso. Ad esempio, gli eventi duplicati nel servizio Profilo vengono eliminati se l’evento con lo stesso _id esiste già nell’archivio dei profili.

In alcuni casi, _id può essere un Identificatore univoco universale (UUID) o Identificatore univoco globale (GUID).

Se trasferisci dati da una connessione di origine o acquisisci direttamente da un file Parquet, devi generare questo valore concatenando una determinata combinazione di campi che rendono l’evento univoco. Esempi di eventi che possono essere concatenati includono ID primario, marca temporale, tipo di evento e così via. Il valore concatenato deve essere un uri-reference stringa formattata, ovvero è necessario rimuovere i due punti. Successivamente, il valore concatenato deve essere sottoposto a hashing utilizzando SHA-256 o un altro algoritmo a tua scelta.

È importante distinguere questo questo campo non rappresenta un’identità correlata a una singola persona, ma piuttosto la registrazione dei dati stessi. I dati di identità relativi a una persona dovrebbero essere relegati a campi di identità fornite da gruppi di campi compatibili.
eventMergeId
Se utilizzi il Adobe Experience Platform Web SDK per acquisire i dati, rappresenta l’ID del batch acquisito che ha causato la creazione del record. Questo campo viene compilato automaticamente dal sistema al momento dell’inserimento dei dati. L’utilizzo di questo campo al di fuori del contesto di un’implementazione Web SDK non è supportato.
eventType
Stringa che indica il tipo o la categoria dell'evento. Questo campo può essere utilizzato se desideri distinguere diversi tipi di evento all’interno dello stesso schema e set di dati, ad esempio per distinguere un evento di visualizzazione prodotto da un evento add-to-shopping-cart per una società di vendita al dettaglio.

I valori standard per questa proprietà sono forniti nel sezione dell'appendice, incluse le descrizioni del caso d’uso previsto. Questo campo è un enum estensibile, il che significa che puoi utilizzare anche stringhe di tipo evento personalizzate per categorizzare gli eventi che stai tracciando.

eventType limita l’utilizzo di un solo evento per hit nell’applicazione; pertanto, è necessario utilizzare campi calcolati per comunicare al sistema quale evento è più importante. Per ulteriori informazioni, consulta la sezione su best practice per i campi calcolati.
producedBy
Valore stringa che descrive il produttore o l’origine dell’evento. Questo campo può essere utilizzato per filtrare alcuni produttori di eventi, se necessario a scopo di segmentazione.

Alcuni valori suggeriti per questa proprietà sono forniti nel sezione dell'appendice. Questo campo è un enum estensibile, il che significa che puoi utilizzare anche stringhe personalizzate per rappresentare diversi produttori di eventi.
identityMap
Campo mappa che contiene un set di identità con spazio dei nomi per l’individuo a cui si applica l’evento. Questo campo viene aggiornato automaticamente dal sistema durante l’acquisizione dei dati di identità. Per utilizzare correttamente questo campo per Profilo cliente in tempo reale, non tentare di aggiornare manualmente il contenuto del campo nelle operazioni sui dati.

Consulta la sezione sulle mappe di identità in nozioni di base sulla composizione dello schema per ulteriori informazioni sul caso d’uso.
timestamp
(Obbligatorio)
Una marca temporale ISO 8601 del momento in cui si è verificato l’evento, formattata come da RFC 3339 Sezione 5.6. Questa marca temporale deve si verificano in passato, ma deve dal 1970 in poi. Vedi la sezione seguente su marche temporali per le best practice sull’utilizzo di questo campo.

Best practice per la modellazione degli eventi

Le sezioni seguenti descrivono le best practice per la progettazione di schemi Experience Data Model (XDM) basati su eventi in Adobe Experience Platform.

Marca temporale timestamps

La radice timestamp campo di uno schema evento può solo rappresenta l’osservazione dell’evento stesso e deve verificarsi nel passato. Tuttavia, l’evento deve dal 1970 in poi. Se i casi di utilizzo della segmentazione richiedono l’uso di marche temporali che possono verificarsi in futuro, questi valori devono essere vincolati altrove nello schema Evento esperienza.

Ad esempio, se un’azienda nel settore dei viaggi e dell’ospitalità sta modellando un evento di prenotazione di un volo, il timestamp rappresenta il momento in cui è stato osservato l’evento di prenotazione. Altre marche temporali correlate all’evento, come la data di inizio della prenotazione del viaggio, devono essere acquisite in campi separati forniti da gruppi di campi standard o personalizzati.

Un esempio di schema di evento esperienza con prenotazione del volo e data di inizio evidenziati.

Mantenendo la marca temporale a livello di classe separata da altri valori di data e ora correlati negli schemi evento, puoi implementare casi di utilizzo di segmentazione flessibili, mantenendo al contempo un account con marca temporale dei percorsi di clienti nell’applicazione Experience.

Utilizzo dei campi calcolati calculated

Alcune interazioni nelle applicazioni di esperienza possono causare più eventi correlati che tecnicamente condividono la stessa marca temporale dell’evento e possono quindi essere rappresentati come un singolo record di evento. Ad esempio, se un cliente visualizza un prodotto sul sito web, questo può causare un record di evento con due potenziali eventType valori: un evento "product view" (commerce.productViews) o un evento generico di "visualizzazione pagina" (web.webpagedetails.pageViews). In questi casi, puoi utilizzare i campi calcolati per acquisire gli attributi più importanti quando più eventi vengono acquisiti in un singolo hit.

Utilizzare Preparazione dati di Adobe Experience Platform mappare, trasformare e convalidare i dati da e verso XDM. Utilizzo del funzioni di mappatura fornito dal servizio, è possibile richiamare operatori logici per assegnare priorità, trasformare e/o consolidare dati da record con più eventi al momento dell’acquisizione in Experienci Platform. Nell’esempio precedente, puoi designare eventType come campo calcolato che dà priorità a una "visualizzazione prodotto" rispetto a una "visualizzazione pagina" ogni volta che si verificano entrambe.

Se acquisisci manualmente i dati in Platform tramite l’interfaccia utente, consulta la guida su campi calcolati per passaggi specifici su come creare campi calcolati.

Se trasferisci dati a Platform utilizzando una connessione di origine, puoi configurare l’origine per utilizzare i campi calcolati. Consulta la sezione documentazione per la fonte specifica per istruzioni su come implementare i campi calcolati durante la configurazione della connessione.

Gruppi di campi di schema compatibili field-groups

NOTE
I nomi di diversi gruppi di campi sono stati modificati. Vedi il documento su aggiornamenti nome gruppo di campi per ulteriori informazioni.

L'Adobe fornisce diversi gruppi di campi standard da utilizzare con XDM ExperienceEvent classe. Di seguito è riportato un elenco di alcuni gruppi di campi comunemente utilizzati per la classe:

Appendice

La sezione seguente contiene informazioni aggiuntive sulle XDM ExperienceEvent classe.

Valori accettati per eventType eventType

La tabella seguente illustra i valori accettati per eventType, insieme alle relative definizioni:

Valore
Definizione
advertising.clicks
Questo evento tiene traccia di quando si verifica un'azione per selezionare un annuncio pubblicitario.
advertising.completes
Questo evento tiene traccia di quando una risorsa multimediale a tempo è stata guardata fino al completamento. Questo non significa necessariamente che lo spettatore abbia guardato l'intero video, poiché potrebbe aver saltato delle parti per andare avanti.
advertising.conversions
Questo evento tiene traccia di un’azione predefinita eseguita da un cliente che attiva un evento per la valutazione delle prestazioni.
advertising.federated
Questo evento tiene traccia di se un evento esperienza è stato creato tramite la federazione di dati (condivisione di dati tra clienti).
advertising.firstQuartiles
Questo evento tiene traccia di quando un annuncio video digitale è stato riprodotto a velocità normale per il 25% della sua durata.
advertising.impressions
Questo evento tiene traccia delle impression di un annuncio pubblicitario rivolto a un cliente potenzialmente visualizzato.
advertising.midpoints
Questo evento tiene traccia di quando un annuncio video digitale è stato riprodotto a velocità normale per il 50% della sua durata.
advertising.starts
Questo evento tiene traccia di quando un annuncio video digitale ha iniziato la riproduzione.
advertising.thirdQuartiles
Questo evento tiene traccia di quando un annuncio video digitale è stato riprodotto a velocità normale per il 75% della sua durata.
advertising.timePlayed
Questo evento tiene traccia della quantità di tempo trascorso da un utente su una specifica risorsa multimediale a tempo.
application.close
Questo evento tiene traccia di quando un’applicazione è stata chiusa o inviata in background.
application.launch
Questo evento tiene traccia di quando un’applicazione è stata avviata o portata in primo piano.
commerce.backofficeCreditMemoIssued
Questo evento tiene traccia di quando un avviso di credito è stato emesso a un cliente.
commerce.backofficeOrderCancelled
Questo evento tiene traccia di quando un processo di acquisto avviato in precedenza è stato terminato prima del completamento.
commerce.backofficeOrderItemsShipped
Questo evento tiene traccia di quando gli articoli acquistati sono stati fisicamente spediti al cliente.
commerce.backofficeOrderPlaced
Questo evento tiene traccia del posizionamento di un ordine.
commerce.backofficeShipmentCompleted
Questo evento tiene traccia del completamento dell'intero processo di spedizione.
commerce.checkouts
Questo evento tiene traccia di quando si è verificato un evento di pagamento per un elenco di prodotti. Ci può essere più di un evento di pagamento se ci sono più passaggi in un processo di pagamento. Se sono presenti più passaggi, la marca temporale e la pagina/esperienza di riferimento per ciascun evento vengono utilizzate per identificare ogni singolo evento (passaggio), rappresentato in ordine.
commerce.productListAdds
Questo evento tiene traccia di quando un prodotto è stato aggiunto all’elenco dei prodotti o al carrello.
commerce.productListOpens
Questo evento tiene traccia di quando un nuovo elenco di prodotti (carrello) è stato inizializzato o creato.
commerce.productListRemovals
Questo evento tiene traccia di quando una voce di prodotto è stata rimossa da un elenco di prodotti o da un carrello.
commerce.productListReopens
Questo evento tiene traccia di quando un elenco di prodotti (carrello) non più accessibile (abbandonato) è stato riattivato da un cliente, ad esempio tramite un’attività di remarketing.
commerce.productListViews
Questo evento tiene traccia di quando un elenco di prodotti o un carrello ha ricevuto una visualizzazione.
commerce.productViews
Questo evento tiene traccia di quando un prodotto ha ricevuto una o più visualizzazioni.
commerce.purchases
Questo evento tiene traccia di quando un ordine è stato accettato. Questa è l’unica azione richiesta in una conversione commerce. Un evento di acquisto deve fare riferimento a un elenco di prodotti.
commerce.saveForLaters
Questo evento tiene traccia di quando un elenco di prodotti è stato salvato per un utilizzo futuro, ad esempio una lista di desideri di prodotto.
decisioning.propositionDisplay
Questo evento tiene traccia di quando una proposta decisionale è stata visualizzata a una persona.
decisioning.propositionDismiss
Questo evento tiene traccia di quando è stata presa la decisione di non partecipare all’offerta presentata.
decisioning.propositionInteract
Questo evento tiene traccia di quando una persona ha interagito con una proposta decisionale.
decisioning.propositionSend
Questo evento tiene traccia di quando è stato deciso di inviare a un potenziale cliente un consiglio o un'offerta da prendere in considerazione.
decisioning.propositionTrigger
Questo evento tiene traccia dell’attivazione di un processo di proposta. Si è verificata una determinata condizione o azione per richiedere la presentazione di un’offerta.
delivery.feedback
Questo evento tiene traccia degli eventi di feedback per una consegna, ad esempio una consegna e-mail.
directMarketing.emailBounced
Questo evento tiene traccia di quando un’e-mail inviata a una persona non viene recapitata.
directMarketing.emailBouncedSoft
Questo evento tiene traccia dei mancati recapiti non permanenti di un’e-mail a una persona.
directMarketing.emailClicked
Questo evento tiene traccia di quando una persona ha fatto clic su un collegamento in un’e-mail di marketing.
directMarketing.emailDelivered
Questo evento tiene traccia di quando un’e-mail è stata consegnata correttamente al servizio e-mail di un utente.
directMarketing.emailOpened
Questo evento tiene traccia di quando una persona ha aperto un’e-mail di marketing.
directMarketing.emailSent
Questo evento tiene traccia di quando un’e-mail di marketing è stata inviata a una persona.
directMarketing.emailUnsubscribed
Questo evento tiene traccia di quando una persona ha annullato l’abbonamento a un’e-mail di marketing.
inappmessageTracking.dismiss
Questo evento tiene traccia di quando un messaggio in-app è stato chiuso.
inappmessageTracking.display
Questo evento traccia la visualizzazione di un messaggio in-app.
inappmessageTracking.interact
Questo evento tiene traccia di quando è stato interagito un messaggio in-app con.
leadOperation.callWebhook
Questo evento tiene traccia di quando un webhook è stato chiamato in risposta a un lead.
leadOperation.changeCampaignStream
Questo evento indica un cambiamento nella strategia di marketing o di coinvolgimento per un determinato lead di business.
leadOperation.changeEngagementCampaignCadence
Questo evento tiene traccia di quando si è verificato un cambiamento nella frequenza con cui un lead viene coinvolto in una campagna.
leadOperation.convertLead
Questo evento tiene traccia della conversione di un lead.
leadOperation.interestingMoment
Questo evento tiene traccia di quando è stato registrato un momento interessante per una persona.
leadOperation.mergeLeads
Questo evento tiene traccia di quando sono state consolidate informazioni provenienti da più lead che fanno riferimento alla stessa entità.
leadOperation.newLead
Questo evento tiene traccia di quando è stato creato un lead.
leadOperation.scoreChanged
Questo evento tiene traccia di quando il valore dell’attributo di punteggio del lead è stato modificato.
leadOperation.statusInCampaignProgressionChanged
Questo evento tiene traccia di quando lo stato di un lead in una campagna è cambiato.
listOperation.addToList
Questo evento tiene traccia di quando una persona è stata aggiunta a un elenco di marketing.
listOperation.removeFromList
Questo evento tiene traccia di quando una persona è stata rimossa da un elenco di marketing.
media.adBreakComplete
Questo evento tiene traccia di quando adBreakComplete si è verificato un evento. Questo evento viene attivato all’inizio di un’interruzione pubblicitaria.
media.adBreakStart
Questo evento tiene traccia di quando adBreakStart si è verificato un evento. Questo evento viene attivato al termine di un’interruzione pubblicitaria.
media.adComplete
Questo evento tiene traccia di quando adComplete si è verificato un evento. Questo evento viene attivato quando un annuncio è stato completato.
media.adSkip
Questo evento tiene traccia di quando adSkip si è verificato un evento. Questo evento viene attivato quando un annuncio viene saltato.
media.adStart
Questo evento tiene traccia di quando adStart si è verificato un evento. Questo evento viene attivato all'avvio di un annuncio.
media.bitrateChange
Questo evento tiene traccia di quando bitrateChange si è verificato un evento. Questo evento viene attivato quando si verifica una modifica nella velocità bit.
media.bufferStart
Questo evento tiene traccia di quando bufferStart si è verificato un evento. Questo evento viene attivato quando il contenuto multimediale inizia a memorizzare in un buffer.
media.chapterComplete
Questo evento tiene traccia di quando chapterComplete si è verificato un evento. Questo evento viene attivato al completamento di un capitolo nel file multimediale.
media.chapterSkip
Questo evento tiene traccia di quando chapterSkip si è verificato un evento. Questo evento viene attivato quando un utente passa avanti o indietro a un’altra sezione o capitolo all’interno del contenuto multimediale.
media.chapterStart
Questo evento tiene traccia di quando chapterStart si è verificato un evento. Questo evento viene attivato all’inizio di una sezione o di un capitolo specifico all’interno del contenuto multimediale.
media.downloaded
Questo evento tiene traccia di quando si sono verificati contenuti multimediali scaricati.
media.error
Questo evento tiene traccia di quando error si è verificato un evento. Questo evento viene attivato quando si verifica un errore o un problema durante la riproduzione di contenuti multimediali.
media.pauseStart
Questo evento tiene traccia di quando pauseStart si è verificato un evento. Questo evento viene attivato quando un utente avvia una pausa nella riproduzione di contenuti multimediali.
media.ping
Questo evento tiene traccia di quando ping si è verificato un evento. In questo modo viene verificata la disponibilità di una risorsa multimediale.
media.play
Questo evento tiene traccia di quando play si è verificato un evento. Questo evento viene attivato durante la riproduzione del contenuto multimediale, indicando il consumo attivo da parte dell’utente.
media.sessionComplete
Questo evento tiene traccia di quando sessionComplete si è verificato un evento. Questo evento segna la fine di una sessione di riproduzione multimediale.
media.sessionEnd
Questo evento tiene traccia di quando sessionEnd si è verificato un evento. Questo evento indica la conclusione di una sessione multimediale. Questa conclusione può comportare la chiusura del lettore multimediale o l’interruzione della riproduzione.
media.sessionStart
Questo evento tiene traccia di quando sessionStart si è verificato un evento. Questo evento segna l’inizio di una sessione di riproduzione multimediale. Viene attivato quando un utente avvia la riproduzione di un file multimediale.
media.statesUpdate
Questo evento tiene traccia di quando statesUpdate si è verificato un evento. Le funzionalità di tracciamento dello stato del lettore possono essere collegate a un flusso audio o video. Gli stati standard sono: fullscreen, mute, closedCaptioning, pictureInPicture e inFocus.
opportunityEvent.addToOpportunity
Questo evento tiene traccia di quando una persona è stata aggiunta a un’opportunità.
opportunityEvent.opportunityUpdated
Questo evento tiene traccia di quando un’opportunità è stata aggiornata.
opportunityEvent.removeFromOpportunity
Questo evento tiene traccia di quando una persona è stata rimossa da un’opportunità.
pushTracking.applicationOpened
Questo evento tiene traccia di quando una persona ha aperto un’applicazione da una notifica push.
pushTracking.customAction
Questo evento tiene traccia di quando una persona ha selezionato un’azione personalizzata in una notifica push.
web.formFilledOut
Questo evento tiene traccia di quando una persona ha compilato un modulo su una pagina web.
web.webinteraction.linkClicks
Questo evento tiene traccia di quando un collegamento è stato selezionato una o più volte.
web.webpagedetails.pageViews
Questo evento tiene traccia di quando una pagina Web ha ricevuto una o più visualizzazioni.
location.entry
Questo evento tiene traccia dell’ingresso di una persona o di un dispositivo in una posizione specifica.
location.exit
Questo evento tiene traccia dell’uscita di una persona o di un dispositivo da una posizione specifica.

Valori consigliati per producedBy producedBy

Nella tabella seguente sono illustrati alcuni valori accettati per producedBy:

Valore
Definizione
self
Autonomo
system
Sistema
salesRef
Rappresentante commerciale
customerRep
Rappresentante del cliente
recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07