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.

La estructura de ExperienceEvent de XDM tal como aparece en la IU de Platform.

Propiedad
Descripción
_id
(Obligatorio)
La clase Experience Event _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
Si se usa la variable SDK web de Adobe Experience Platform para introducir datos, representa el ID del lote introducido que provocó la creación del registro. El sistema rellena automáticamente este campo tras la ingesta de datos. No se admite el uso de este campo fuera del contexto de una implementación de SDK web.
eventType
Cadena que indica el tipo o la categoría del evento. Este campo se puede utilizar si desea distinguir distintos tipos de eventos dentro del mismo esquema y conjunto de datos, como distinguir un evento de vista de producto de un evento de complemento al carro de compras para una compañía minorista.

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
Valor de cadena que describe el productor o el origen del evento. Este campo se puede utilizar para filtrar ciertos productores de eventos si es necesario con fines de segmentación.

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
Campo de asignación que contiene un conjunto de identidades con espacio de nombres para el individuo al que se aplica el evento. El sistema actualiza automáticamente este campo a medida que se incorporan los datos de identidad. Para utilizar correctamente este campo para Perfil del cliente en tiempo real, no intente actualizar manualmente el contenido del campo en las operaciones de datos.

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)
Una marca de tiempo ISO 8601 de cuándo se produjo el evento, con el formato establecido por RFC 3339, sección 5.6. Esta marca de tiempo debe ocurren en el pasado, pero debe a partir de 1970. Consulte la sección siguiente sobre marcas de tiempo para conocer las prácticas recomendadas sobre el uso de este campo.

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.

Esquema de evento de experiencia de ejemplo con la reserva de vuelo y la fecha de inicio resaltadas.

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

NOTE
Los nombres de varios grupos de campos han cambiado. Consulte el documento sobre actualizaciones de nombre de grupo de campos para obtener más información.

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:

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:

Valor
Definición
advertising.clicks
Este evento rastrea cuándo se produce una acción para seleccionar un anuncio.
advertising.completes
Este evento rastrea cuándo se ha visto un recurso de medios cronometrados hasta su finalización. Esto no significa necesariamente que el usuario haya visto todo el vídeo, ya que podría haberse saltado algunas partes.
advertising.conversions
Este evento rastrea una acción predefinida realizada por un cliente que almacena en déclencheur un evento para la evaluación del rendimiento.
advertising.federated
Este evento rastrea si se creó un Evento de experiencia mediante federación de datos (uso compartido de datos entre clientes).
advertising.firstQuartiles
Este evento rastrea cuándo se ha reproducido un anuncio de vídeo digital a velocidad normal durante el 25 % de su duración.
advertising.impressions
Este evento rastrea las impresiones de un anuncio para un cliente con el potencial de ser visto.
advertising.midpoints
Este evento rastrea cuándo se ha reproducido un anuncio de vídeo digital a lo largo del 50 % de su duración a velocidad normal.
advertising.starts
Este evento rastrea cuándo ha comenzado a reproducirse un anuncio de vídeo digital.
advertising.thirdQuartiles
Este evento rastrea cuándo se ha reproducido un anuncio de vídeo digital a velocidad normal durante el 75 % de su duración.
advertising.timePlayed
Este evento rastrea la cantidad de tiempo que un usuario dedica a un recurso de medios cronometrados específico.
application.close
Este evento rastrea cuándo se cerró una aplicación o se envió a segundo plano.
application.launch
Este evento rastrea cuándo se inició o se puso en primer plano una aplicación.
commerce.backofficeCreditMemoIssued
Este evento rastrea cuándo se ha emitido un aviso de crédito a un cliente.
commerce.backofficeOrderCancelled
Este evento rastrea cuándo se ha finalizado un proceso de compra iniciado anteriormente antes de completarse.
commerce.backofficeOrderItemsShipped
Este evento registra cuándo se han enviado físicamente los artículos comprados al cliente.
commerce.backofficeOrderPlaced
Este evento rastrea la colocación de un pedido.
commerce.backofficeShipmentCompleted
Este evento rastrea la finalización correcta de todo el proceso de envío.
commerce.checkouts
Este evento rastrea cuándo se ha producido un evento de cierre de compra para una lista de productos. Puede haber más de un evento de cierre de compra si hay varios pasos en el proceso. Si hay varios pasos, la marca de tiempo y la página/experiencia de referencia para cada evento se utilizan para identificar cada evento individual (paso), representado en orden.
commerce.productListAdds
Este evento rastrea cuándo se ha agregado un producto a la lista de productos o al carro de compras.
commerce.productListOpens
Este evento rastrea cuándo se ha inicializado o creado una nueva lista de productos (carro de compras).
commerce.productListRemovals
Este evento rastrea cuándo se ha eliminado una entrada de producto de una lista de productos o un carro de compras.
commerce.productListReopens
Este evento rastrea cuándo un cliente ha reactivado una lista de productos (carro de compras) que ya no era accesible (abandonada), como, por ejemplo, mediante una actividad de remarketing.
commerce.productListViews
Este evento rastrea cuándo una lista de productos o un carro de compras ha recibido una vista.
commerce.productViews
Este evento rastrea cuándo un producto ha recibido una o más vistas.
commerce.purchases
Este evento rastrea cuándo se ha aceptado un pedido. Esta es la única acción necesaria en una conversión comercial. Un evento de compra debe tener una lista de productos a la que se haga referencia.
commerce.saveForLaters
Este evento rastrea cuándo se ha guardado una lista de productos para uso futuro, como una lista de deseos de productos.
decisioning.propositionDisplay
Este evento rastrea cuándo se ha mostrado una propuesta de toma de decisiones a una persona.
decisioning.propositionDismiss
Este evento registra cuándo se ha tomado la decisión de no interactuar con la oferta presentada.
decisioning.propositionInteract
Este evento rastrea cuándo una persona interactuó con una propuesta de toma de decisiones.
decisioning.propositionSend
Este evento registra cuándo se ha decidido enviar a un cliente potencial una recomendación u oferta para su consideración.
decisioning.propositionTrigger
Este evento rastrea la activación de un proceso de propuesta. Se ha producido una condición o acción determinada para solicitar la presentación de una oferta.
delivery.feedback
Este evento realiza un seguimiento de los eventos de comentarios de un envío, como un envío por correo electrónico.
directMarketing.emailBounced
Este evento rastrea cuándo rebotó un correo electrónico a una persona.
directMarketing.emailBouncedSoft
Este evento rastrea cuándo ha rebotado suavemente un correo electrónico a una persona.
directMarketing.emailClicked
Este evento rastrea cuándo una persona hizo clic en un vínculo en un correo electrónico de marketing.
directMarketing.emailDelivered
Este evento rastrea cuándo se entregó correctamente un correo electrónico al servicio de correo electrónico de una persona.
directMarketing.emailOpened
Este evento rastrea cuándo una persona ha abierto un correo electrónico de marketing.
directMarketing.emailSent
Este evento rastrea cuándo se ha enviado un correo electrónico de marketing a una persona.
directMarketing.emailUnsubscribed
Este evento rastrea cuándo una persona canceló la suscripción a un correo electrónico de marketing.
inappmessageTracking.dismiss
Este evento rastrea cuándo se descartó un mensaje en la aplicación.
inappmessageTracking.display
Este evento rastrea cuándo se ha mostrado un mensaje en la aplicación.
inappmessageTracking.interact
Este evento rastrea cuándo se ha interactuado con un mensaje en la aplicación.
leadOperation.callWebhook
Este evento rastrea cuándo se llamó a un webhook en respuesta a un posible cliente.
leadOperation.changeCampaignStream
Este evento significa un cambio en la estrategia de marketing o participación de un posible cliente empresarial en particular.
leadOperation.changeEngagementCampaignCadence
Este evento rastrea cuándo se ha producido un cambio en la frecuencia con la que un posible cliente se involucra como parte de una campaña.
leadOperation.convertLead
Este evento rastrea cuándo se convirtió un posible cliente.
leadOperation.interestingMoment
Este evento rastrea cuándo se grabó un momento interesante para una persona.
leadOperation.mergeLeads
Este evento rastrea cuándo se consolidó la información de varios posibles clientes que hacen referencia a la misma entidad.
leadOperation.newLead
Este evento rastrea cuándo se creó un posible cliente.
leadOperation.scoreChanged
Este evento rastrea cuándo se cambió el valor del atributo de puntuación del posible cliente.
leadOperation.statusInCampaignProgressionChanged
Este evento rastrea cuándo ha cambiado el estado de un posible cliente en una campaña.
listOperation.addToList
Este evento rastrea cuándo se añadió una persona a una lista de marketing.
listOperation.removeFromList
Este evento rastrea cuándo se eliminó una persona de una lista de marketing.
media.adBreakComplete
Este evento rastrea cuándo una adBreakComplete se ha producido un evento. Este evento se activa al principio de una pausa publicitaria.
media.adBreakStart
Este evento rastrea cuándo una adBreakStart se ha producido un evento. Este evento se activa al final de una pausa publicitaria.
media.adComplete
Este evento rastrea cuándo una adComplete se ha producido un evento. Este evento se activa cuando se completa un anuncio.
media.adSkip
Este evento rastrea cuándo una adSkip se ha producido un evento. Este evento se activa cuando se omite un anuncio.
media.adStart
Este evento rastrea cuándo una adStart se ha producido un evento. Este evento se activa cuando se inicia un anuncio.
media.bitrateChange
Este evento rastrea cuándo se produce una bitrateChange se ha producido un evento. Este evento se activa cuando hay un cambio en la velocidad de bits.
media.bufferStart
Este evento rastrea cuándo se produce una bufferStart se ha producido un evento. Este evento se activa cuando el medio ha comenzado a almacenarse en el búfer.
media.chapterComplete
Este evento rastrea cuándo se produce una chapterComplete se ha producido un evento. Este evento se activa al finalizar un capítulo en el contenido.
media.chapterSkip
Este evento rastrea cuándo se produce una 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
Este evento rastrea cuándo se produce una 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
Este evento rastrea cuándo se ha producido el contenido descargado del medio.
media.error
Este evento rastrea cuándo una 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
Este evento rastrea cuándo se produce una pauseStart se ha producido un evento. Este evento se activa cuando un usuario inicia una pausa en la reproducción de contenido.
media.ping
Este evento rastrea cuándo una ping se ha producido un evento. Esto verifica la disponibilidad de un recurso de medios.
media.play
Este evento rastrea cuándo se produce una 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
Este evento rastrea cuándo se produce una sessionComplete se ha producido un evento. Este evento marca el final de una sesión de reproducción de contenido.
media.sessionEnd
Este evento rastrea cuándo se produce una 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
Este evento rastrea cuándo se produce una 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
Este evento rastrea cuándo se produce una 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
Este evento registra cuándo se añadió una persona a una oportunidad.
opportunityEvent.opportunityUpdated
Este evento rastrea cuándo se actualizó una oportunidad.
opportunityEvent.removeFromOpportunity
Este evento rastrea cuándo se eliminó una persona de una oportunidad.
pushTracking.applicationOpened
Este evento rastrea cuándo una persona abrió una aplicación desde una notificación push.
pushTracking.customAction
Este evento rastrea cuándo una persona seleccionó una acción personalizada en una notificación push.
web.formFilledOut
Este evento rastrea cuándo una persona ha rellenado un formulario en una página web.
web.webinteraction.linkClicks
Este evento rastrea cuándo se ha seleccionado un vínculo una o más veces.
web.webpagedetails.pageViews
Este evento rastrea cuándo una página web ha recibido una o más vistas.
location.entry
Este evento rastrea la entrada de una persona o dispositivo en una ubicación específica.
location.exit
Este evento rastrea la salida de una persona o dispositivo desde una ubicación específica.

Valores sugeridos para producedBy producedBy

En la tabla siguiente se describen algunos valores aceptados para producedBy:

Valor
Definición
self
Self
system
Sistema
salesRef
Representante de ventas
customerRep
Representante del cliente
recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07