Coletando endereços de e-mail e números de telefone

Como funciona

O produto Login salva automaticamente as informações de contato dos usuários fornecidas ao seu projeto Login quando eles se cadastram ou fazem login em seu aplicativo. Essas informações são armazenadas no banco de dados Xsolla e incluem o endereço de e-mail e o número de telefone do usuário. Em alguns casos, nem todos os dados de contato podem ser passados, por exemplo:

• Com a opção de login sem senha, apenas os dados de contato que foram especificados pelo usuário para receber um código de confirmação único são passados para o seu projeto de login, ou seja, apenas um endereço de e-mail ou número de telefone.
• Ao autorizar por meio de uma rede social, seu provedor não pode passar informações sobre os endereços de e-mail dos usuários.

Você também pode solicitar detalhes de contato ausentes usando o produto Login e usá-los para:

• exportar os e-mails dos usuários para sua conta Mailchimp e adicioná-los à sua lista de boletins informativos;
• criar um identificador exclusivo para o usuário com base em seu endereço de e-mail ou número de telefone.

Quem pode usar

Parceiros que já integraram o Login, bem como configuraram a opção de fazer login no aplicativo através de redes sociais ou que usam a autorização sem senha.

Como obtê-lo

Dependendo da opção de integração selecionada para o seu projeto Login, você pode configurar a coleta de endereços de e-mail e números de telefone:

• através do widget de Login v2.0
• através das chamadas Login API

Coletando endereços de e-mail e números de telefone via widget de Login v2.0

Com o widget de Login v2.0, você pode solicitar aos usuários seus endereços de e-mail e/ou números de telefone se essas informações não foram fornecidas:

• ao se cadastrar através de redes sociais;
• ao entrar no aplicativo com um código único (ou seja, ao usar a autenticação sem senha).

Depois de ativar a solicitação de endereços de e-mail e/ou números de telefone na Conta de Distribuidor, seu projeto Login irá:

1. automaticamente exibir formulários ao usuário para inserir seu endereço de e-mail e/ou número de telefone;
2. após o preenchimento dos formulários, automaticamente enviar ao usuário um código ou um link para confirmar as informações inseridas;
3. automaticamente verificar o código de confirmação e armazenar as informações recebidas no banco de dados.

Você pode tornar obrigatório que os usuários preencham os formulários.

Para habilitar a coleta de endereços de e-mail e números de telefone de usuários:

1. Abra seu projeto na Conta de Distribuidor e vá para a seção Login.
2. Clique em Configure no painel de um projeto Login.
3. Vá para o bloco Authentication e selecione a seção Miscellaneous data form.

4. Se você quiser que seu projeto Login exiba um formulário onde o usuário possa especificar seu endereço de e-mail:
   1. Defina a opção Collect user email address como On.
   2. Selecione um método de confirmação de endereço de e-mail: Por código ou Por código e link.
5. Para exigir que os usuários forneçam seus endereços de e-mail, defina a opção Require user to complete email form como On.
6. Se você quiser que seu projeto Login exiba um formulário onde o usuário possa especificar seu número de telefone, defina a opção Collect user phone number como On.

7. Para exigir que os usuários forneçam seu número de telefone, defina a opção Require user to complete phone number como On.
8. Se você tiver habilitado o formulário de coleta de endereços de e-mail e o formulário de coleta de números de telefone, selecione a ordem em que eles serão exibidos ao usuário na lista suspensa na parte inferior da página.

Coletando endereços de e-mail por meio de chamadas Login API

Com a Login API, você pode solicitar aos usuários seus endereços de e-mail se eles não foram fornecidos ao se cadastrar através de redes sociais.

Se você integrou seu projeto de Login por meio de chamadas Login API:

• Ao usar a chamada Auth via social network com um JWT padrão, adicione o parâmetro fields=email.

Exemplo de solicitação:

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'

• Ao usar a chamada Auth via social network com um protocolo OAuth 2.0, adicione o parâmetro scope=email.

Exemplo de solicitação:

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'