Esquema de eventos
El esquema de eventos describe qué eventos deben llegar al proyecto y con qué propiedades: order_completed, con un importe obligatorio de tipo número; currency, solo EUR o USD. OneTrace.pro compara cada evento con el esquema y muestra las infracciones: una errata en el nombre del evento, un importe enviado como texto, una propiedad que falta. Los errores de etiquetado del sitio web o de una integración se detectan enseguida, y no cuando un segmento o un informe ya se han calculado mal.
Un evento que incumple el esquema se acepta igualmente y llega al perfil: los datos no se pierden aunque el error esté en el propio esquema. El esquema de eventos está disponible a partir del plan «Crecimiento».
Cómo describir los eventos
Abra el Catálogo de datos y la pestaña Esquema de eventos. Pueden modificar el esquema los roles con el permiso «Gestionar el catálogo de eventos», es decir, «Gestor» y superiores; los demás ven el esquema y las infracciones.
- Pulse Añadir eventos actuales: se añadirán al esquema todos los eventos del catálogo con sus propiedades y los tipos detectados. O añada los eventos uno a uno con el botón Añadir evento.
- Revise las propiedades de cada evento:
| Columna | Qué define |
|---|---|
| Propiedad | La clave de la propiedad tal como la envía el sitio web o el servidor, por ejemplo, amount |
| Tipo | Texto, número, sí/no, fecha y hora, lista u objeto. Un valor de fecha y hora también es válido para una propiedad de tipo texto |
| Obligatoria | Un evento sin esta propiedad o con el valor vacío es una infracción |
| Valores permitidos | Separados por comas, solo para texto y números. Un valor fuera de la lista es una infracción; se distinguen mayúsculas y minúsculas: eur y EUR son valores distintos |
| Descripción | Para los desarrolladores: qué significa la propiedad |
- Quite los eventos y las propiedades que ya no deben llegar: si llegan, se registrará la infracción «Evento no descrito» o «Propiedad no descrita».
- Pulse Guardar esquema y active Validar eventos con el esquema.
Los cambios se acumulan en pantalla y se guardan juntos. Después de guardar, los contadores de infracciones empiezan de cero: los anteriores corresponden al esquema antiguo. En la pestaña Eventos, un evento del esquema que todavía no ha llegado nunca aparece como «Aún no recibido», y los eventos del esquema llevan la marca «En el esquema».

Los eventos de sistema de la plataforma ($identify, $page, $message_sent y otros), así como identify y las vistas de páginas y de pantallas de la aplicación, no se validan: su esquema lo define la plataforma.
Infracciones
| Infracción | Ejemplo |
|---|---|
| Evento no descrito | Llegó product_viewd en lugar de product_viewed |
| Propiedad no descrita | order_completed llegó con la propiedad coupon, que no está en el esquema |
| Falta una propiedad obligatoria | add_to_cart sin quantity |
| Tipo incorrecto | El importe llegó como texto "1250" en lugar del número 1250 |
| Valor no permitido | currency = eur, pero en el esquema están EUR y USD |
Las infracciones de los últimos 7 días se ven encima de la lista de eventos del esquema: cuántas veces se produjeron y cuándo fue la última, y un ejemplo: el tipo del valor o el propio valor no permitido. Sin permiso para ver datos personales, el ejemplo se enmascara. Si un evento no está descrito por un error del esquema y no del etiquetado, pulse Añadir al esquema: se añadirá al borrador con las propiedades del catálogo.
Las mismas infracciones y el gráfico de eventos con infracciones de las últimas 24 horas están en la sección Diagnóstico.

Importación, exportación y API
Exportar JSON descarga el esquema guardado, e Importar JSON carga un archivo en el borrador: revíselo y guárdelo. Así se traslada un mismo esquema entre proyectos: por ejemplo, a todas las tiendas de una cadena o de un proyecto de pruebas al de producción.
A través de la API pública, el esquema se lee (GET /api/v1/event-schema) y se sustituye por completo (PUT /api/v1/event-schema, permiso de la clave «Modificar el esquema de eventos»), y las infracciones de la última semana se obtienen con la solicitud GET /api/v1/event-schema/violations. El formato del archivo y de la API es el mismo:
{
"enabled": true,
"events": [
{
"name": "order_completed",
"label": "Realizó un pedido",
"properties": [
{ "key": "amount", "type": "number", "required": true },
{ "key": "currency", "type": "string", "required": true, "values": ["EUR", "USD"] }
]
}
]
}
Los eventos que no están en el documento salen del esquema, pero se quedan en el catálogo de datos con sus etiquetas y estadísticas. Un documento sin events solo activa o desactiva la validación.