Recopilar direcciones de correo electrónico y números de teléfono

Cómo funciona

El producto Login guarda automáticamente la información de contacto de los usuarios proporcionados a su proyecto de Login cuando se registran o inician sesión en su aplicación. Esta información se almacena en la base de datos de Xsolla e incluye la dirección de correo electrónico y el número de teléfono del usuario. En algunos casos, es posible que no se transmitan todos los datos de contacto, por ejemplo:

• Con la opción de inicio de sesión sin contraseña, solamente los detalles de contacto especificados por el usuario para recibir un código de confirmación de un solo uso se transmiten a su proyecto de Login, es decir, solo una dirección de correo electrónico o un número de teléfono.
• Al autorizar a través de una red social, su proveedor puede no transmitir información sobre las direcciones de correo electrónico de los usuarios.

Además, puede solicitar los datos de contacto que falten mediante el producto Login y utilizarlos para:

• exportar los correos electrónicos de los usuarios a su cuenta de Mailchimp y añadirlos a su lista de boletines;
• crear un identificador único para el usuario basado en su dirección de correo electrónico o número de teléfono.

¿Quién puede utilizarlo?

Los socios que ya han integrado Login, y también hayan configurado la opción de iniciar sesión en la aplicación a través de redes sociales o la opción de utilizar la autorización sin contraseña.

Cómo conseguirlo

En función de la opción de integración seleccionada para su proyecto de Login, puede configurar la recopilación de direcciones de correo electrónico y números de teléfono:

• a través del widget de Login v2.0
• a través de las llamadas a Login API

Recopilar direcciones de correo electrónico y números de teléfono mediante el widget de Login v2.0

Con el widget de Login v2.0, puede solicitar a los usuarios sus direcciones de correo electrónico o números de teléfono si no se ha facilitado esta información:

• al registrarse mediante redes sociales;
• al acceder a la aplicación con un código de un solo uso (al utilizar la autenticación sin contraseña).

Después de activar la solicitud de direcciones de correo electrónico o números de teléfono en Cuenta del editor, su proyecto de Login automáticamente:

1. mostrará formularios al usuario para que introduzca su dirección de correo electrónico o número de teléfono;
2. después de rellenar los formularios, enviará al usuario un código o un enlace para confirmar la información introducida;
3. comprobará el código de confirmación y almacenará la información recibida en la base de datos.

Puede hacer que rellenar los formularios sea obligatorio para los usuarios.

Para habilitar la recopilación de direcciones de correo electrónico y números de teléfono de los usuarios:

1. Abra su proyecto en Cuenta del editor y vaya a la sección Login.
2. Haga clic en Configure en el panel de un proyecto de Login.
3. Vaya al bloque Authentication y seleccione la sección Miscellaneous data form.

4. Si desea que su proyecto de Login muestre un formulario en el que el usuario pueda especificar su dirección de correo electrónico:
   1. Establezca el conmutador Collect user email address en posición On.
   2. Seleccione un método de confirmación de la dirección de correo electrónico: Mediante código o Mediante código y enlace.
5. Para exigir a los usuarios que faciliten su dirección de correo electrónico, establezca el conmutador Require user to complete email form en posición On.
6. Si desea que su proyecto de Login muestre un formulario en el que el usuario pueda especificar su número de teléfono, establezca el conmutador Collect user phone number en On.

7. Para exigir a los usuarios que faciliten su número de teléfono, establezca el conmutador Require user to complete phone number en On.
8. Si ha habilitado tanto el formulario de recopilación de direcciones de correo electrónico como el de recopilación de números de teléfono, seleccione el orden en que se mostrarán al usuario en la lista desplegable de la parte inferior de la página.

Recopilación de direcciones de correo electrónico mediante llamadas a Login API

Con la Login API, puede solicitar a los usuarios sus direcciones de correo electrónico si no las facilitaron al registrarse a través de redes sociales.

Si ha integrado su proyecto de Login a través de llamadas a Login API:

• Cuando utilice la llamada Auth via social network con un estándar JWT, añada el parámetro fields=email.

Ejemplo de solicitud:

GET https://login.xsolla.com/api/social/{providerName}/login_redirect?projectId={projectId}&fields=email&login_url={login_url} HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/social/providerName/login_redirect?projectId=projectId&fields=email&login_url=login_url'

• Cuando utilice la llamada Auth via social network con un protocolo OAuth 2.0, añada el parámetro scope=email.

Ejemplo de solicitud:

GET https://login.xsolla.com/api/oauth2/social/{providerName}/login_redirect?scope=email&client_id={client_id}&redirect_uri={redirect_uri}&state={state}&response_type=code HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/oauth2/social/provider_name/login_redirect?scope=email&client_id=client_id&redirect_uri=redirect_uri&state=state&response_type=code'