Gestión de la recopilación de datos del usuario

Cómo funciona

Durante el registro del usuario, se solicitan los siguientes datos básicos:

• Al utilizar la Login API:
  • nombre de usuario
  • correo electrónico
  • contraseña
• Al utilizar el widget de Login:
  • correo electrónico
  • contraseña

Puede solicitar datos personales adicionales a los usuarios. Para ello, en su cuenta de Cuenta del editor, especifique qué campos adicionales deben incluirse en el formulario de registro. El registro del usuario solo es posible después de rellenar todos los campos que haya marcado como obligatorios. Los datos facilitados por los usuarios se almacenan en sus perfiles en la base de datos.

Si, durante la autenticación de un usuario previamente registrado, se detecta que no se han rellenado algunos campos de su perfil, el producto Login mostrará un formulario para recopilar la información que falta. Para iniciar sesión, el usuario debe rellenar todos los campos obligatorios de este formulario.

Cómo conseguirlo

1. Establezca su proyecto de Login en Cuenta del editor.
2. Envíe una solicitud a su gestor del éxito del cliente para que incluya sus campos personalizados en el formulario de registro de usuarios (opcional).
3. Integre la solución en el lado de su aplicación.

Configurar en Cuenta del editor

1. Abra su proyecto en Cuenta del editor y vaya a la sección de Login.
2. Haga clic en Configure en el panel de un proyecto de Login.
3. Vaya al bloque User database y seleccione la sección Supplementary user information.

4. Los siguientes campos y casillas pueden visualizarse en el formulario de registro del usuario:
   • Nombre de usuario.
   • Nombre.
   • Apellidos.
   • Fecha de nacimiento.
   • País.
   • Sexo/género.
   • Boletín - una casilla que sirve para que el usuario se suscriba al boletín. Cuando el usuario marca la casilla, sus contactos se exportan automáticamente a Mailchimp si Mailchimp está conectado a su proyecto.
   • Acuerdo adicional - una casilla para que el usuario firme su acuerdo adicional. Puede obtener una lista de los usuarios que han firmado el acuerdo adicional a través de Cuenta del editor o a través del método API. La lista estará disponible en el archivo additional_agreement.csv.

5. Para que un campo sea obligatorio, haga clic en el icono ★ de la línea de descripción del campo. El icono se volverá azul.

6. Haga clic en Save changes.

Solicitud para añadir campos personalizados al formulario de registro

Además de los campos disponibles en la Cuenta del editor, puede agregar sus propios campos al formulario de registro. Para ello, contacte con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com y facilite la lista de campos con la siguiente información para cada campo:

• nombre del campo en inglés;
• tipo:
  • string;
  • date;
  • select - selección de una opción de una lista;
  • multi-select - selección de varias opciones de una lista;
• si el campo es obligatorio.

Para los campos select y multi-select, facilite también a su gestor del éxito del cliente conjuntos de posibles valores para estos campos.

Integración del lado de la aplicación

Si ha utilizado la integración mediante el widget de Login, no es necesario realizar ninguna acción para integrar el formulario de registro ampliado en el lado de su aplicación.

Cuando se integra a través del SDK de Xsolla, la recopilación de información adicional sobre los usuarios aún no está disponible.

Al realizar la integración a través de la Login API, transmita los datos de usuario adicionales recopilados en la solicitud Register new user utilizando el parámetro fields. Este parámetro es un conjunto de pares propiedad-valor. Los campos del formulario de registro que se pueden conectar en la Cuenta del editor corresponden a las siguientes propiedades del parámetro fields:

POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
Content-Type: application/json

{
  "username": "john-email@email.com",
  "password": "123456",
  "email": "john-email@email.com",
  "fields": {
     "nickname": "John",
     "country-name": "US",
     "bday": "1997-07-16"
  }
}

curl --request POST \
  --url 'https://login.xsolla.com/api/user?login_url=https%3A%2F%2Fexample.com&projectId=projectId' \
  --header 'content-type: application/json' \
  --data '{"username":"john-email@email.com","password":"123456","email":"john-email@email.com","fields":{"nickname":"John","country-name":"US","bday":"1997-07-16"}}'

Las opciones para añadir campos al formulario de registro y la ubicación para almacenar la información recopilada difieren en función del tipo de almacenamiento de datos de usuario elegido:

• Almacenamiento de Xsolla
• Almacenamiento de PlayFab
• Almacenamiento de Firebase
• Almacenamiento personalizado

Almacenamiento de Xsolla

Almacenamiento de PlayFab

Si utiliza un almacenamiento de PlayFab , puede añadir al formulario de registro tanto los campos disponibles en su Cuenta del editor como sus propios campos.

La información sobre los campos adicionales y sus valores se guardan como datos de usuario en su almacenamiento PlayFab. Puede acceder a estos datos de usuario a través de PlayFab API o en su cuenta de PlayFab:

1. Vaya a la sección Players y haga clic en el ID de usuario.

2. Seleccione la pestaña de Player Data (Title).

Firebase Storage

Almacenamiento personalizado

Si utiliza un almacenamiento personalizado , puede añadir al formulario de registro tanto los campos disponibles en su Cuenta del editor como sus propios campos.

La información sobre los campos adicionales y sus valores son enviados por el servidor de Xsolla Login en la solicitud de registro a la URL que se especificó en el campo New user URL en Cuenta del editor al conectar su almacenamiento personalizado.

Ejemplo

En el formulario de registro de usuario se añaden los siguientes campos:

• país;
• campo nickname personalizado del tipo string;
• campo platform personalizado del tipo multi-select con los posibles valores: windows, mac os y linux.

Durante el registro del usuario, el servidor de Xsolla Login enviará la siguiente solicitud a la URL de nuevo usuario:

POST https://your.hostname/new_user_url.path HTTP/1.1
Content-Type: application/json
Authorization: Bearer {JWT}

{
  "email": "john@gmail.com",
  "password": "123456",
  "country-name": "DE",
  "nickname": "JohnSnow",
  "platform": ["windows", "mac os"]
}

curl --request POST \
  --url 'https://your.hostname/new_user_url.path' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","password":"123456","country-name":"DE","nickname":"JohnSnow","platform":["windows","mac os"]}'