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.
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. |
Le sezioni seguenti descrivono le best practice per la progettazione di schemi Experience Data Model (XDM) basati su eventi in Adobe Experience Platform.
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.
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.
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.
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:
La sezione seguente contiene informazioni aggiuntive sulle XDM ExperienceEvent classe.
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. |
producedBy
Nella tabella seguente sono illustrati alcuni valori accettati per producedBy
:
Valore | Definizione |
---|---|
self |
Autonomo |
system |
Sistema |
salesRef |
Rappresentante commerciale |
customerRep |
Rappresentante del cliente |