Campos

Los campos de evento son los atributos definidos en el tipo de evento que forman el contrato de datos aceptado en POST /events.

En términos prácticos, son estos campos los que determinan qué se validará en el envío, qué se ignorará y qué podrá usarse para generar métricas y monitoreos.

Qué se puede configurar en un campo

Al registrar un campo en el panel de administración, usted define:

ID del campo: identificador usado en el payload de la API;
nombre y descripción: etiquetas mostradas en el panel;
tipo de dato: formato esperado para el valor;
tipo de propiedad: cómo se tratará el campo en el modelado;
obligatoriedad: si el campo debe estar presente en cada evento;
estado: si el campo está activo o inactivo.

Tipos de dato disponibles

La plataforma permite los siguientes tipos de campo:

texto;
lista (valores predefinidos);
número entero;
número decimal;
número en coma flotante;
booleano.

Observaciones importantes

El campo de texto acepta hasta 128 caracteres.
Los campos de tipo lista permiten registrar ítems permitidos para validación.
En campos decimales, la precisión y la escala se definen en la creación.

Tipo de propiedad: dimensión o medición

Cada campo también recibe un tipo de propiedad:

dimensión: representa una característica del evento usada para segmentación;
medición: representa un valor variable usado en consolidaciones.

Esta elección impacta cómo las métricas y los monitoreos pueden configurarse más adelante.

Reglas de validación en el envío de eventos

Al recibir eventos a través de POST /events, el contrato de campos se aplica con las siguientes reglas:

los campos obligatorios ausentes causan rechazo;
los valores fuera del tipo esperado causan rechazo;
los campos inactivos pueden permanecer en el payload, pero sus valores son ignorados;
los campos desconocidos pueden ignorarse o rechazarse, según la configuración del tipo de evento.

Buenas prácticas para modelar campos

Defina IDs estables y semánticos desde el principio.
Comience con un conjunto reducido de campos esenciales.
Use campos de lista cuando haya un conjunto controlado de valores.
Evite crear campos redundantes para el mismo concepto.
Revise periódicamente los campos sin uso.

Restricciones y ciclo de vida

Algunas configuraciones son estructurales y deben planificarse en el momento de la creación:

el ID del campo no puede modificarse después del registro;
el tipo de propiedad no puede modificarse después del registro;
en campos decimales, la precisión y la escala quedan fijas después de la creación;
los ítems de campo del tipo lista se gestionan después de que se crea el campo;
el tipo de evento tiene un límite de hasta 100 campos.

Al eliminar un campo, la operación puede fallar si está en uso por métricas (por ejemplo, en dimensiones o agregaciones).