Recopilar perfil de usuario

Más allá de los identificadores de autenticación y credenciales requeridos para el inicio de sesión del usuario, tu aplicación puede necesitar recopilar información adicional del perfil de usuario almacenada en Logto para facilitar su recuperación mediante reclamos JWT o APIs y así ofrecer experiencias de producto personalizadas. Puedes recopilar datos de usuario a través de los siguientes métodos:

• Durante el registro de nuevos usuarios: Utiliza la función Recopilar perfil de usuario para añadir un paso listo para usar de "Cuéntanos sobre ti" que recopila información adicional del perfil de usuario durante el registro. Los nuevos usuarios deben completar todos los campos obligatorios antes de que el registro se considere finalizado. Este documento se centra en este enfoque.

• Después del registro del usuario: Utiliza la Account API para implementar experiencias de autoservicio durante los flujos de incorporación, centros de cuentas o a lo largo del uso del producto para actualizar la información del perfil de usuario.

Beneficios clave

La función Recopilar perfil de usuario te permite obtener información adicional del usuario durante la experiencia de registro del usuario final. Recomendamos recopilar solo la información esencial requerida para tu producto para evitar flujos de registro extensos que puedan afectar las tasas de conversión de usuarios.

Esta función te permite:

• Capturar datos de usuario completos: Recopila cualquier dato de usuario para fines comerciales o de cumplimiento, incluyendo propiedades estándar de usuario OIDC y datos personalizados.

• Personalización flexible de campos: Elige entre varios tipos de campo incluyendo texto, número, fecha, casilla de verificación, lista desplegable (selección), URL y validación por expresión regular para adaptarse a tus necesidades específicas de datos.

• Experiencia de usuario optimizada: Personaliza la visualización con etiquetas, descripciones, marcadores de posición y reglas de validación. Configura los campos como obligatorios u opcionales según las necesidades de tu negocio.

• Configuraciones de campo integradas: Utiliza campos de datos básicos preconfigurados para propiedades comunes de usuario con configuración plug-and-play. Aprovecha los campos compuestos (dirección, nombre completo) para recopilar datos estructurados de manera eficiente en un solo paso.

Inicio rápido

1. Ve a Consola Logto > Experiencia de inicio de sesión > Recopilar perfil de usuario.
2. Haz clic en "Agregar campos de perfil" y elige un campo integrado o define un dato personalizado (clave alfanumérica) para crear.
3. Abre los detalles del campo para establecer el tipo de campo, etiqueta, descripción, indicador de obligatorio y configuraciones específicas del tipo (longitud, rango, formato, opciones, etc.). Haz clic en "Guardar cambios".
4. Regresa a Experiencia de inicio de sesión > Recopilar perfil de usuario, arrastra y suelta los campos para reordenarlos y los cambios se aplicarán automáticamente.
5. Prueba la experiencia de usuario con Logto live preview o tu aplicación de prueba. Ya sea que los usuarios creen una nueva cuenta mediante identificador (correo electrónico / número de teléfono / nombre de usuario), inicio de sesión social o SSO empresarial, todos verán la página de "Cuéntanos sobre ti" durante el registro.

Tipos de datos de usuario

Los datos de usuario pueden verse en cada perfil de usuario. Para una visión general completa de todas las categorías de datos de usuario, consulta la documentación de Estructura de datos de usuario. La función Recopilar perfil de usuario te permite recopilar tanto datos básicos de usuario como datos personalizados durante el registro.

Campos básicos de datos de usuario

Los campos básicos de datos de usuario proporcionados por Logto se almacenan directamente en la propiedad user o user.profile. Estos campos vienen con valores de configuración predeterminados y traducciones i18n, listos para usar inmediatamente después de su creación. También puedes personalizar los tipos de campo y parámetros según tus necesidades específicas.

Nombre del campo	Clave de dato de usuario	Descripción
Nombre	user.name	El nombre completo del usuario en forma visible, incluyendo todos los componentes del nombre (ejemplo: "Jane Doe").
Nombre completo	user.profile.givenName user.profile.middleName user.profile.familyName	El nombre legal completo del usuario. Combina de manera flexible familyName, givenName y middleName según la configuración.
Apodo	user.profile.nickname	Nombre casual o familiar para el usuario, que puede diferir de su nombre legal.
Fecha de nacimiento	user.profile.birthdate	Fecha de nacimiento del usuario en un formato especificado (ejemplo: "MM-dd-yyyy").
Género	user.profile.gender	Género autoidentificado del usuario (ejemplo: "Femenino", "Masculino", "Prefiero no decirlo").
Perfil	user.profile.profile	URL de la página de perfil legible del usuario (ejemplo: perfil de red social).
Sitio web	user.profile.website	URL del sitio web personal o blog del usuario.
Dirección	user.profile.address.formatted user.profile.address.streetAddress user.profile.address.region user.profile.address.zoneinfo user.profile.address.postalCode user.profile.address.country	Dirección completa del usuario (ejemplo: "123 Main St, Anytown, USA 12345"). Elige entre una sola línea (address.formatted) o varias líneas con componentes configurables (calle, ciudad, estado, código postal, país).

Campos personalizados de datos de usuario

Los campos personalizados de datos de usuario son campos definidos por el usuario que capturan información adicional no cubierta por los campos básicos, como preferencias, intereses, tamaño de la empresa u otros atributos específicos del negocio.

Al crear campos personalizados, utiliza solo caracteres alfanuméricos para la clave de dato de usuario (ejemplo: customData.companySize). Luego puedes configurar el tipo de campo y personalizar propiedades adicionales para satisfacer tus necesidades específicas.

Para más información sobre cómo recuperar y actualizar datos personalizados de usuario después de la creación del usuario, consulta estructura de datos de usuario.

Tipos de campo

Podemos categorizar los campos por simplicidad:

• Primitivos: Texto, Número, Fecha, Casilla de verificación (Booleano), Lista desplegable (Selección única), URL, Expresión regular.
• Compuestos: Nombre completo, Dirección.

Propiedades comunes

Propiedad	Aplica a	Notas
Etiqueta	Todos	Nombre visible mostrado a los usuarios. Flota hacia arriba cuando el campo tiene valor o está enfocado. Obligatorio.
Marcador de posición	Todos (excepto Checkbox)	Pista en línea visible cuando la etiqueta está flotando (texto de ejemplo / guía de formato).
Descripción	Todos (excepto Checkbox)	Texto de apoyo debajo del campo para instrucciones más largas o contexto adicional.
Obligatorio	Todos (excepto Checkbox)	Si está habilitado, el envío se bloquea cuando está vacío. Si está deshabilitado, se añade una etiqueta "(Opcional)" a la etiqueta.

Configuraciones específicas por tipo

Tipo	Aspectos configurables	Notas
Texto	longitud mínima / máxima	Limita la longitud mínima y máxima del texto ingresado por el usuario.
Número	valor mínimo / máximo	Limita el rango numérico mínimo y máximo del valor ingresado.
Fecha	Formato de fecha (predefinido / personalizado)	Elige formatos predefinidos (MM/dd/yyyy, dd/MM/yyyy, yyyy-MM-dd). Cambiar el marcador de posición sobrescribe las interacciones predeterminadas. O utiliza patrones totalmente personalizables de date-fns.
Casilla de verificación	Valor predeterminado	Marcado (Verdadero) / No marcado (Falso).
Lista desplegable (Selección)	Lista de opciones (≥1)	Usa valor:etiqueta por línea. Si se omite la etiqueta, se muestra el valor.
URL	N/A	N/A
Expresión regular	Expresión regular	Patrón de validación (omite las barras iniciales / finales). Ejemplo: ^\d3-\d2-\d4$ para SSN.
Dirección	Componentes	Una o varias líneas; subcomponentes: calle, ciudad, estado, código postal, país.
Nombre completo	Componentes	Subcomponentes: nombre, segundo nombre, apellido.

Validación

La validación de campos se realiza en el envío del usuario en el paso final del registro. Se aplican las siguientes comprobaciones:

• Presencia obligatoria (excepto Checkbox).
• Límites de longitud (Texto).
• Rango numérico (Número).
• Coincidencia de patrón (Expresión regular, Fecha con formato, URL, pertenencia a opción de selección).
• Estructura de URL (validación sintáctica básica, no comprobación de accesibilidad).

También se aplica a los subcomponentes de los dos campos compuestos: address y fullname. Los componentes individuales también deben cumplir los mismos criterios de validación.

Localización

Logto proporciona traducciones a nivel de sistema para los campos básicos de datos de usuario, como firstName, lastName, gender y birthdate. La etiqueta de estos campos es configurable en la Consola Logto. Puedes sobrescribir estas etiquetas proporcionando tus propias traducciones en Logto > Experiencia de inicio de sesión > Contenido

Los campos personalizados dependen completamente de las etiquetas, marcadores de posición y descripciones que proporciones. Para la localización de campos personalizados, puedes gestionar las traducciones utilizando Bring your UI o contactarnos con tus comentarios.

Management API (puntos clave)

Método	Endpoint	Propósito
GET	/api/custom-profile-fields	Listar todos los campos.
GET	/api/custom-profile-fields/:name	Obtener la definición de un campo por nombre.
POST	/api/custom-profile-fields	Crear un campo.
POST	/api/custom-profile-fields/batch	Crear en lote (≤20 elementos por solicitud).
PUT	/api/custom-profile-fields/:name	Actualizar campo por nombre y conjunto completo de datos.
DELETE	/api/custom-profile-fields/:name	Eliminar un campo.
POST	/api/custom-profile-fields/properties/sie-order	Actualizar el orden de los campos en la Experiencia de inicio de sesión.

Mejores prácticas

• Recopila solo los datos esenciales en el registro; deja la información adicional para completar el perfil más adelante.
• Utiliza campos compuestos para datos estructurados (dirección, nombre completo) para coherencia y localización.
• Proporciona ejemplos claros / marcadores de posición para campos sensibles al formato (expresión regular, fecha, rangos numéricos).

Preguntas frecuentes

¿Los campos de perfil recopilan datos de usuarios existentes?

No, solo recopilan información del paso final del registro de nuevos usuarios.

¿Qué sucede si elimino un campo? ¿Se elimina el dato del usuario?

No, no se eliminarán los datos de usuario existentes. Solo se eliminará el campo del formulario de registro en la experiencia del usuario final.

¿Puedo recopilar el país con una lista controlada en lugar de un campo de texto normal?

Sí, puedes cambiar el componente "País" a un campo de "Lista desplegable (Selección única)" con opciones estandarizadas.