XDM ExperienceEvent classe

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)
Un identificatore di stringa univoco per l’evento. 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. In alcuni casi, _id può essere un Identificatore univoco universale (UUID) o Identificatore univoco globale (GUID).

Se esegui lo streaming dei dati da una connessione di origine o l’acquisizione diretta da un file Parquet, è necessario generare questo valore concatenando una determinata combinazione di campi che rendono univoco l’evento, ad esempio un ID primario, una marca temporale, un 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 Experience 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 Azioni di clic su un annuncio pubblicitario.
advertising.completes 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 Azioni predefinite eseguite da un cliente che attivano un evento per la valutazione delle prestazioni.
advertising.federated Indica se un evento esperienza è stato creato tramite la federazione di dati (condivisione di dati tra clienti).
advertising.firstQuartiles Un annuncio video digitale è stato riprodotto a velocità normale per il 25% della sua durata.
advertising.impressions Impression di un annuncio pubblicitario rivolto a un cliente potenzialmente visualizzato.
advertising.midpoints Un annuncio video digitale è stato riprodotto a velocità normale per il 50% della sua durata.
advertising.starts È stata avviata la riproduzione di un annuncio video digitale.
advertising.thirdQuartiles Un annuncio video digitale è stato riprodotto a velocità normale per il 75% della sua durata.
advertising.timePlayed Descrive la quantità di tempo trascorso da un utente su una specifica risorsa multimediale a tempo.
application.close Un'applicazione è stata chiusa o inviata in background.
application.launch Applicazione avviata o messa in primo piano.
commerce.checkouts 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 Un prodotto è stato aggiunto all’elenco dei prodotti o al carrello.
commerce.productListOpens È stato inizializzato o creato un nuovo elenco di prodotti (carrello).
commerce.productListRemovals Una o più voci prodotto sono state rimosse da un elenco di prodotti o da un carrello.
commerce.productListReopens Un elenco di prodotti (carrello) non più accessibile (abbandonato) è stato riattivato da un cliente, ad esempio tramite un’attività di remarketing.
commerce.productListViews Un elenco di prodotti o un carrello ha ricevuto una o più visualizzazioni.
commerce.productViews Un prodotto ha ricevuto una o più visualizzazioni.
commerce.purchases 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 Un elenco di prodotti è stato salvato per un utilizzo futuro, ad esempio una lista di desideri del prodotto.
decisioning.propositionDisplay Una proposta decisionale è stata visualizzata a una persona.
decisioning.propositionInteract Una persona ha interagito con una proposta decisionale.
delivery.feedback Eventi di feedback per una consegna, ad esempio una consegna e-mail.
directMarketing.emailBounced Un’e-mail a una persona non recapitata.
directMarketing.emailBouncedSoft Un’e-mail a una persona non recapitata in modo permanente.
directMarketing.emailClicked Una persona ha fatto clic su un collegamento in un’e-mail di marketing.
directMarketing.emailDelivered Un messaggio e-mail è stato recapitato al servizio e-mail dell'utente
directMarketing.emailOpened Una persona ha aperto un’e-mail di marketing.
directMarketing.emailUnsubscribed Persona che ha annullato l’abbonamento a un’e-mail di marketing.
inappmessageTracking.dismiss Un messaggio in-app è stato ignorato.
inappmessageTracking.display È stato visualizzato un messaggio in-app.
inappmessageTracking.interact È stato interagito un messaggio in-app con.
leadOperation.callWebhook È stato chiamato un webhook in risposta a un lead.
leadOperation.convertLead Un lead è stato convertito.
leadOperation.interestingMoment È stato registrato un momento interessante per una persona.
leadOperation.newLead È stato creato un lead.
leadOperation.scoreChanged Il valore dell’attributo di punteggio del lead è stato modificato.
leadOperation.statusInCampaignProgressionChanged Lo stato di un lead in una campagna è cambiato.
listOperation.addToList Persona aggiunta a un elenco di marketing.
listOperation.removeFromList Una persona è stata rimossa da un elenco di marketing.
message.feedback Eventi di feedback come inviato/non recapitato/errore per messaggi inviati a un cliente.
message.tracking Tracciamento di eventi come azioni di apertura/clic/personalizzate sui messaggi inviati a un cliente.
opportunityEvent.addToOpportunity Una persona è stata aggiunta a un’opportunità.
opportunityEvent.opportunityUpdated Un’opportunità è stata aggiornata.
opportunityEvent.removeFromOpportunity Una persona è stata rimossa da un'opportunità.
pushTracking.applicationOpened Una persona ha aperto un’applicazione da una notifica push.
pushTracking.customAction Una persona ha fatto clic su un’azione personalizzata in una notifica push.
web.formFilledOut Una persona ha compilato un modulo su una pagina web.
web.webinteraction.linkClicks Un collegamento è stato selezionato una o più volte.
web.webpagedetails.pageViews Una pagina Web ha ricevuto una o più visualizzazioni.

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

In questa pagina