XDM ExperienceEvent classe

Ultimo aggiornamento: 2023-11-01

Argomenti:
Schemas
Visualizza ulteriori informazioni su questo argomento

Creato per:
Developer

User

Admin

Leader

XDM ExperienceEvent è una classe XDM (Experience Data Model) standard che consente di creare un’istantanea 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 sulla classe, mentre gli altri sono facoltativi. I valori di alcuni campi vengono compilati automaticamente al momento dell’acquisizione dei dati.

Struttura di XDM ExperienceEvent 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 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 essere nel passato. 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

La radice timestamp campo di uno schema evento può solo rappresenta l’osservazione dell’evento stesso e deve verificarsi nel passato. 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

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.

Preparazione dati di Adobe Experience Platform consente di 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

NOTA

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`

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, closeCaption, 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`

Nella tabella seguente sono illustrati alcuni valori accettati per producedBy:

Valore	Definizione
`self`	Autonomo
`system`	Sistema
`salesRef`	Rappresentante commerciale
`customerRep`	Rappresentante del cliente

Pagina precedente

XDM ExperienceEvent classe