Campos Personalizados (Metadatos)
Los clientes de Guper tienen un conjunto de campos nativos (nombre, correo,
teléfono, documento, cumpleaños, género…). Los campos personalizados te permiten
guardar cualquier otra cosa que necesites sobre un cliente como metadatos
libres en clave/valor — por ejemplo shirt_size, tienda_favorita o
cumple_hijo.
Cada cliente tiene un valor por clave. Los valores son texto; un número o una fecha se reconoce automáticamente (útil para reportes futuros).
Dónde aparecen los campos personalizados
Los metadatos de cada cliente aparecen en la página Customer 360, en la tarjeta Metadatos. Ahí los consultas y — con permiso de edición — los cambias manualmente.
Tres formas de llenarlos
1. Capturarlos con un formulario de Data Capture
Al armar un formulario de Data Capture (Configuraciones → Captura de Datos → Formularios), cada campo tiene un switch "Guardar como metadato":
- Agrega un campo (ej.: nombre
shirt_size, etiqueta Talla de camisa). - Activa Guardar como metadato.
- Opcionalmente define la Clave del metadato — la clave de almacenamiento. Si
la dejas en blanco, se usa el nombre del campo. Se normaliza automáticamente a
minúsculas con guiones bajos (ej.: Talla de Camisa →
talla_de_camisa). - Guarda el formulario.
Desde entonces, cada envío de ese formulario escribe el valor capturado en los metadatos del cliente.
El campo identificador del formulario (el que identifica al cliente, normalmente correo o teléfono) no puede convertirse en metadato — siempre mapea al campo nativo.
2. Editarlos en la pantalla de Customer 360
Abre un cliente, encuentra la tarjeta Metadatos y haz clic en el lápiz. Puedes:
- editar el valor de una clave existente,
- Agregar una nueva fila clave/valor,
- eliminar una fila (borra ese valor para este cliente),
y hacer clic en Guardar. Las claves nuevas que escribas aquí se crean automáticamente.
3. Escribirlos por la API
Los desarrolladores pueden leer y escribir metadatos directamente:
GET /api/register/customer/{id}/metadata— el mapa de metadatos del cliente.PUT /api/register/customer/{id}/metadata— upsert de un objeto{ "clave": "valor" }(envíanullo""para eliminar una clave).
El mapa también viene incrustado como metadata en
GET /api/register/customer/{id}. Consulta la referencia de la API para más
detalles.
Gestionando tus claves (Configuraciones → General → Campos personalizados)
Las claves se crean automáticamente la primera vez que se escribe un valor, así que normalmente no hay nada que configurar. La pantalla Configuraciones → General → Campos personalizados lista todas las claves que usa tu organización y permite:
- dar una etiqueta amigable a una clave (claridad interna),
- eliminar una clave — lo que también quita ese valor de todos los clientes.
Eliminar una clave es permanente y afecta a todos los clientes. Úsalo solo para limpiar claves creadas por error.
Bueno saber
- Los nombres de clave se normalizan a
a–z,0–9y_(máx. 64 caracteres). Talla de Camisa ytalla_de_camisason la misma clave. - Una clave no puede reutilizar el nombre de un campo nativo (como
emailogender). - Un valor por clave por cliente. Para mantener historial o múltiples valores, modélalos como claves separadas.
- Segmentación: filtrar audiencias por campos personalizados aún no está disponible — está planificado para una versión futura.