---
title: 'Campos Personalizados (Metadatos)'
description: 'Guarda cualquier información extra en clave/valor en el cliente — más allá de los campos nativos — y llénala desde un formulario de captura, la pantalla del cliente o la API.'
---

# 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"**:

1. Agrega un campo (ej.: nombre `shirt_size`, etiqueta *Talla de camisa*).
2. Activa **Guardar como metadato**.
3. 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`).
4. 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ía `null` o `""` 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–9` y `_` (máx. 64 caracteres).
  *Talla de Camisa* y `talla_de_camisa` son la misma clave.
- Una clave **no puede reutilizar el nombre de un campo nativo** (como `email` o
  `gender`).
- **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.
