OneTrace.pro Centro de ayuda

Eventos y catálogo de eventos

Un evento es una acción del cliente o del sistema: ver una página, añadir un producto al carrito, hacer un pedido, abrir un correo. A partir de los eventos se construyen los perfiles, los segmentos, los disparadores de los recorridos y los informes. En Datos → Eventos se ve lo que llega al proyecto en este momento, y en Datos → Catálogo, qué eventos y atributos existen y cómo están etiquetados.

Ambas secciones están abiertas a todos los miembros del proyecto. Pueden cambiar etiquetas, tipos y marcas de PII en el catálogo «Propietario», «Administrador» y «Gestor».

De dónde llegan los eventos

Origen Qué envía
Rastreador en el sitio web vistas de páginas, acciones con productos, inicio de sesión; consulte Conexión del sitio web
API desde su servidor o aplicación pedidos, registros, cambios de estado; consulte Integración desde el servidor
Importación y fuentes de datos perfiles desde CSV, archivos, S3 y Google Sheets; consulte Importación de archivos y fuentes de datos
Migración desde otra plataforma historial de perfiles y eventos; consulte Migración desde otras plataformas
El propio OneTrace.pro entradas en segmentos, pasos de recorridos, envíos y aperturas de mensajes, suscripciones y bajas

Los eventos se procesan pocos segundos después del envío. Un evento repetido con el mismo messageId en un plazo de 24 horas se descarta. Si la hora de un evento está más de una hora en el futuro, se sustituye por la hora de recepción. El número de eventos al mes está limitado por el plan del proyecto; consulte Configuración del proyecto, plan y auditoría.

Flujo de eventos

La página Eventos muestra los eventos del proyecto en tiempo real. Al abrirla se cargan los últimos 50 eventos de los 7 últimos días, y los nuevos aparecen arriba automáticamente.

Flujo de eventos con un evento desplegado

Qué puede hacer:

  • Filtrar por nombre. En la lista de la izquierda, elija un evento, por ejemplo order_completed, y el flujo mostrará solo ese. «Todos los eventos» quita el filtro.
  • Pausar. El botón Pausar detiene el flujo para examinar los eventos con calma; Reanudar lo vuelve a activar.
  • Propiedades del evento. Haga clic en una fila para desplegar las propiedades en formato JSON.
  • Ir al perfil. El número #… junto al nombre lleva a la ficha del perfil.

A la derecha se muestra el estado de la conexión: «Conectado», «Conectando…» o «Sin conexión». Si el flujo es muy grande, parte de los eventos no se muestra en pantalla y aparece la línea «Omitidos por alto volumen: N». Los eventos se guardan igualmente: la omisión solo afecta a la pantalla.

Si no tiene permiso para ver datos personales, los correos electrónicos, los teléfonos y las propiedades PII de los eventos se enmascaran. Más información en el artículo Perfiles.

El flujo es útil para comprobar la instalación: abra el sitio web en otra pestaña, añada un producto al carrito y compruebe que el evento llega con las propiedades correctas.

Catálogo de datos

El catálogo se llena automáticamente: en cuanto llega al proyecto un evento, una propiedad o un atributo nuevos, aparece aquí con el tipo detectado. Puede abrir el catálogo desde el menú o con el botón Catálogo de datos de la página de eventos.

Pestaña «Eventos»

Tabla de eventos: Evento (nombre), Etiqueta, Volumen (cuántas veces ha llegado) y Último (fecha del último). La flecha de la izquierda despliega la lista de propiedades del evento con sus tipos, por ejemplo amount: number.

Catálogo de datos, pestaña «Eventos»

Pestaña «Atributos de perfil»

Los atributos son propiedades del cliente: correo electrónico, nombre, ciudad, plan, fecha de nacimiento. Columnas: Clave, Etiqueta, Tipo y PII.

Catálogo de datos, pestaña «Atributos de perfil»

  1. Introduzca una Etiqueta clara, por ejemplo «Realizó un pedido» para order_completed o «Ciudad» para city. El cambio se guarda al instante.
  2. Para un atributo, compruebe el Tipo: string (texto), number (número), boolean (sí/no), datetime (fecha y hora), list (lista), object (objeto).
  3. Marque PII si el atributo contiene datos personales: pasaporte, dirección, fecha de nacimiento.

Cómo se usa:

  • Las etiquetas se muestran en el editor de segmentos junto a la clave: «Ciudad (city)». El especialista en marketing no necesita recordar los nombres técnicos.
  • Las condiciones de los segmentos dependen del tipo: para números, «mayor que» y «menor que»; para fechas, «antes de», «después de» y «en los últimos». Si el tipo se detectó mal, por ejemplo una fecha llegó como texto, corríjalo.
  • Los atributos marcados como PII se enmascaran para quienes no tienen permiso para ver datos personales. El correo electrónico, el teléfono, los nombres y la dirección se marcan automáticamente.

Eventos reservados

Los nombres que empiezan por el signo $ están reservados para OneTrace.pro. No se puede enviar un evento propio con un nombre así: la solicitud devolverá un error.

Evento Cuándo aparece
$page, $identify, $alias llamadas a cdp.page(), cdp.identify() y fusión de identificadores
$segment_entered, $segment_exited el perfil entró en un segmento o salió de él
$journey_entered, $journey_completed, $journey_exited, $journey_failed pasos de la participación en un recorrido
$message_sent, $message_delivered, $message_failed, $message_skipped, $message_bounced, $message_complained, $message_opened, $message_clicked qué pasó con los mensajes enviados
$subscribed, $unsubscribed cambio del consentimiento para recibir envíos

Los eventos de sistema se ven en el flujo, en el catálogo y en el historial del perfil, y se pueden usar en las condiciones de los segmentos igual que los propios.

Consejos para nombrar eventos

  • Nombre los eventos con caracteres latinos en snake_case y en pasado: order_completed, product_viewed, trial_started.
  • No incluya datos variables en el nombre: no order_1001, sino order_completed con la propiedad order_id.
  • Envíe los importes como número, no como texto con la moneda: amount: 9980.
← Integración desde el servidor Importación de archivos y fuentes de datos →