XDM ExperienceEvent clase
XDM ExperienceEvent es una clase estándar de modelo de datos de experiencia (XDM). Utilice esta clase para crear una instantánea con marca de tiempo del sistema cuando se produzca un evento específico o cuando se haya alcanzado un conjunto determinado de condiciones.
Un Evento de experiencia es un registro de hechos de lo que ocurrió, incluido el momento y la identidad de la persona involucrada. Los eventos pueden ser explícitos (acciones humanas directamente observables) o implícitos (planteados sin una acción humana directa) y se registran sin agregación ni interpretación. Para obtener más información de alto nivel sobre el uso de esta clase en el ecosistema de Platform, consulte la Información general de XDM.
El XDM ExperienceEvent proporciona varios campos relacionados con series temporales a un esquema. Dos de estos campos (_id
y timestamp
) son obligatorio para todos los esquemas basados en esta clase, mientras que el resto son opcionales. Los valores de algunos de los campos se rellenan automáticamente cuando se incorporan datos.
_id
(Obligatorio)
_id
identifica de forma exclusiva los eventos individuales que se incorporan a Adobe Experience Platform. Este campo se utiliza para realizar un seguimiento de la exclusividad de un evento individual, evitar la duplicación de datos y buscar ese evento en los servicios descendentes.Cuando se detectan eventos duplicados, las aplicaciones y los servicios de Platform pueden gestionar la duplicación de forma diferente. Por ejemplo, los eventos duplicados en el servicio de perfil se pierden si el evento con el mismo
_id
ya existe en el almacén de perfiles.En algunos casos,
_id
puede ser un Identificador único universal (UUID) o Identificador único global (GUID).Si está transmitiendo datos desde una conexión de origen o ingiriendo directamente desde un archivo de Parquet, debe generar este valor concatenando una determinada combinación de campos que hagan que el evento sea único. Algunos ejemplos de eventos que se pueden concatenar son el ID principal, la marca de tiempo, el tipo de evento, etc. El valor concatenado debe ser un
uri-reference
formatted string, lo que significa que se debe eliminar cualquier carácter de dos puntos. Después, el valor concatenado debe tener un cifrado hash con SHA-256 u otro algoritmo de su elección.Es importante distinguir que este campo no representa una identidad relacionada con una persona individual, sino más bien el propio registro de datos. Los datos de identidad relativos a una persona deben quedar relegados a campos de identidad proporcionadas por grupos de campos compatibles.
eventMergeId
eventType
Los valores estándar para esta propiedad se proporcionan en sección del apéndice, incluidas las descripciones de su caso de uso previsto. Este campo es una enumeración ampliable, lo que significa que también puede utilizar sus propias cadenas de tipo de evento para categorizar los eventos que está rastreando.
eventType
limita el uso de un solo evento por visita en la aplicación y, por lo tanto, debe utilizar campos calculados para que el sistema sepa qué evento es el más importante. Para obtener más información, consulte la sección sobre prácticas recomendadas para campos calculados.producedBy
Algunos valores sugeridos para esta propiedad se proporcionan en la variable sección del apéndice. Este campo es una enumeración extensible, lo que significa que también puede utilizar sus propias cadenas para representar a diferentes productores de eventos.
identityMap
Consulte la sección sobre mapas de identidad en la conceptos básicos de composición de esquemas para obtener más información sobre su caso de uso.
timestamp
(Obligatorio)
Prácticas recomendadas para el modelado de eventos
Las siguientes secciones tratan sobre las prácticas recomendadas para diseñar esquemas XDM (Experience Data Model) basados en eventos en Adobe Experience Platform.
Marcas de hora timestamps
La raíz timestamp
de un esquema de evento puede solamente representan la observación del evento mismo, y deben ocurrir en el pasado. Sin embargo, el evento debe a partir de 1970. Si los casos de uso de la segmentación requieren el uso de marcas de tiempo que puedan producirse en el futuro, estos valores deben restringirse en cualquier parte del esquema de Experience Event.
Por ejemplo, si un negocio del sector de los viajes y la hostelería está modelando un evento de reserva de vuelo, el nivel de clase timestamp
representa el momento en el que se observó el evento de reserva. Otras marcas de tiempo relacionadas con el evento, como la fecha de inicio de la reserva de viaje, deben capturarse en campos independientes proporcionados por grupos de campos estándar o personalizados.
Al mantener la marca de tiempo en el nivel de clase separada de otros valores de fecha y hora relacionados en los esquemas de evento, puede implementar casos de uso de segmentación flexible, al tiempo que conserva una cuenta con marca de tiempo de los recorridos del cliente en la aplicación de experiencia.
Uso de campos calculados calculated
Ciertas interacciones en las aplicaciones de experiencia pueden dar como resultado varios eventos relacionados que técnicamente comparten la misma marca de tiempo de evento y, por lo tanto, se pueden representar como un único registro de evento. Por ejemplo, si un cliente ve un producto en su sitio web, esto puede dar como resultado un registro de evento que tenga dos posibilidades eventType
values: un evento de "vista de producto" (commerce.productViews
) o un evento genérico de "vista de página" (web.webpagedetails.pageViews
). En estos casos, puede utilizar campos calculados para capturar los atributos más importantes cuando se capturan varios eventos en una sola visita.
Uso Preparación de datos de Adobe Experience Platform para asignar, transformar y validar datos desde y hacia XDM. Uso de los disponibles funciones de asignación proporcionado por el servicio puede invocar operadores lógicos para priorizar, transformar o consolidar datos de registros de varios eventos cuando se incorporan en Experience Platform. En el ejemplo anterior, puede designar eventType
como un campo calculado que priorizaría una "vista de producto" sobre una "vista de página" siempre que se produzcan ambos.
Si está introduciendo manualmente datos en Platform a través de la interfaz de usuario de, consulte la guía sobre campos calculados para ver los pasos específicos sobre cómo crear campos calculados.
Si está transmitiendo datos a Platform mediante una conexión de origen, puede configurar el origen para que utilice campos calculados en su lugar. Consulte la documentación de su origen particular para obtener instrucciones sobre cómo implementar campos calculados al configurar la conexión.
Grupos de campos de esquema compatibles field-groups
El Adobe proporciona varios grupos de campos estándar para su uso con el XDM ExperienceEvent clase. A continuación se muestra una lista de algunos grupos de campos utilizados comúnmente para la clase:
- Extensión completa de Adobe Analytics ExperienceEvent
- Transferencias de saldo
- Detalles de marketing de campaña
- Acciones de tarjeta
- Detalles del canal
- Detalles de Commerce
- Detalles de depósito
- Detalles de intercambio de dispositivos
- Reserva de restaurante
- Detalles del ID del usuario final
- Detalles del entorno
- Reserva de vuelo
- Consentimiento de IAB TCF 2.0
- Reserva de alojamiento
- Detalles de interacción de Media Analytics
- Detalles de solicitud de presupuesto
- Detalles de reserva
- Detalles web
Apéndice
La siguiente sección contiene información adicional sobre ExperienceEvent de XDM clase.
Valores aceptados para eventType
eventType
En la tabla siguiente se describen los valores aceptados para eventType
, junto con sus definiciones:
advertising.clicks
advertising.completes
advertising.conversions
advertising.federated
advertising.firstQuartiles
advertising.impressions
advertising.midpoints
advertising.starts
advertising.thirdQuartiles
advertising.timePlayed
application.close
application.launch
commerce.backofficeCreditMemoIssued
commerce.backofficeOrderCancelled
commerce.backofficeOrderItemsShipped
commerce.backofficeOrderPlaced
commerce.backofficeShipmentCompleted
commerce.checkouts
commerce.productListAdds
commerce.productListOpens
commerce.productListRemovals
commerce.productListReopens
commerce.productListViews
commerce.productViews
commerce.purchases
commerce.saveForLaters
decisioning.propositionDisplay
decisioning.propositionDismiss
decisioning.propositionInteract
decisioning.propositionSend
decisioning.propositionTrigger
delivery.feedback
directMarketing.emailBounced
directMarketing.emailBouncedSoft
directMarketing.emailClicked
directMarketing.emailDelivered
directMarketing.emailOpened
directMarketing.emailSent
directMarketing.emailUnsubscribed
inappmessageTracking.dismiss
inappmessageTracking.display
inappmessageTracking.interact
leadOperation.callWebhook
leadOperation.changeCampaignStream
leadOperation.changeEngagementCampaignCadence
leadOperation.convertLead
leadOperation.interestingMoment
leadOperation.mergeLeads
leadOperation.newLead
leadOperation.scoreChanged
leadOperation.statusInCampaignProgressionChanged
listOperation.addToList
listOperation.removeFromList
media.adBreakComplete
adBreakComplete
se ha producido un evento. Este evento se activa al principio de una pausa publicitaria.media.adBreakStart
adBreakStart
se ha producido un evento. Este evento se activa al final de una pausa publicitaria.media.adComplete
adComplete
se ha producido un evento. Este evento se activa cuando se completa un anuncio.media.adSkip
adSkip
se ha producido un evento. Este evento se activa cuando se omite un anuncio.media.adStart
adStart
se ha producido un evento. Este evento se activa cuando se inicia un anuncio.media.bitrateChange
bitrateChange
se ha producido un evento. Este evento se activa cuando hay un cambio en la velocidad de bits.media.bufferStart
bufferStart
se ha producido un evento. Este evento se activa cuando el medio ha comenzado a almacenarse en el búfer.media.chapterComplete
chapterComplete
se ha producido un evento. Este evento se activa al finalizar un capítulo en el contenido.media.chapterSkip
chapterSkip
se ha producido un evento. Este evento se activa cuando un usuario salta hacia delante o hacia atrás a otra sección o capítulo dentro del contenido multimedia.media.chapterStart
chapterStart
se ha producido un evento. Este evento se activa al principio de una sección o capítulo específico dentro del contenido multimedia.media.downloaded
media.error
error
se ha producido un evento. Este evento se activa cuando se produce un error o un problema durante la reproducción del contenido.media.pauseStart
pauseStart
se ha producido un evento. Este evento se activa cuando un usuario inicia una pausa en la reproducción de contenido.media.ping
ping
se ha producido un evento. Esto verifica la disponibilidad de un recurso de medios.media.play
play
se ha producido un evento. Este evento se activa cuando se reproduce el contenido del contenido multimedia, lo que indica el consumo activo por parte del usuario.media.sessionComplete
sessionComplete
se ha producido un evento. Este evento marca el final de una sesión de reproducción de contenido.media.sessionEnd
sessionEnd
se ha producido un evento. Este evento indica la finalización de una sesión de medios. Esta conclusión podría implicar el cierre del reproductor de contenidos o la detención de la reproducción.media.sessionStart
sessionStart
se ha producido un evento. Este evento marca el comienzo de una sesión de reproducción de contenido. Se activa cuando un usuario comienza a reproducir un archivo multimedia.media.statesUpdate
statesUpdate
se ha producido un evento. Las funcionalidades de seguimiento de estado del reproductor se pueden adjuntar a un flujo de audio o vídeo. Los estados estándar son: pantalla completa, silenciar, closedCaptioning, pictureInPicture e inFocus.opportunityEvent.addToOpportunity
opportunityEvent.opportunityUpdated
opportunityEvent.removeFromOpportunity
pushTracking.applicationOpened
pushTracking.customAction
web.formFilledOut
web.webinteraction.linkClicks
web.webpagedetails.pageViews
location.entry
location.exit
Valores sugeridos para producedBy
producedBy
En la tabla siguiente se describen algunos valores aceptados para producedBy
:
self
system
salesRef
customerRep