Gerenciando a coleta de dados do usuário

Como funciona

Durante o cadastro do usuário, os seguintes dados básicos são solicitados:

• Ao usar a Login API:
  • nome de usuário
  • e-mail
  • senha
• Ao usar o widget de Login:
  • e-mail
  • senha

Você pode solicitar dados pessoais adicionais dos usuários. Para fazer isso, em sua Conta de Distribuidor, especifique quais campos adicionais devem ser incluídos no formulário de cadastro. O cadastro de usuário só é possível após o preenchimento de todos os campos que você marcou como obrigatórios. Os dados fornecidos pelos usuários são armazenados em seus perfis no banco de dados.

Se, durante a autenticação de um usuário previamente cadastro, for constatado que alguns campos de seu perfil não estão preenchidos, o produto Login exibirá um formulário para coletar as informações faltantes. Para fazer o login, o usuário precisará preencher todos os campos obrigatórios deste formulário.

Como obtê-lo

1. Configure seu projeto Login na Conta de Distribuidor.
2. Envie uma solicitação ao seu Gerente de Sucesso do Cliente para incluir seus campos personalizados no formulário de cadastro de usuário (opcional).
3. Integre a solução na lateral do seu aplicativo.

Configuração na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor e vá para a seção Login.
2. Clique em Configure no painel do projeto Login.
3. Vá para o bloco User database e selecione a seção Supplementary user information.

4. Os campos e caixas de seleção a seguir podem ser exibidos no formulário de registro do usuário:
   • Nome de usuário.
   • Nome.
   • Sobrenome.
   • Data de nascimento.
   • País.
   • Sexo.
   • Boletim informativo: uma caixa de seleção que permite ao usuário assinar o boletim informativo. Quando o usuário marca a caixa, seus contatos são exportados automaticamente para o Mailchimp, caso o Mailchimp estiver conectado ao seu projeto.
   • Contrato adicional: uma caixa de seleção que permite ao usuário assinar seu contrato adicional. Você pode obter uma lista de usuários que assinaram o contrato adicional por meio da Conta de Distribuidor ou por meio do método API. A lista estará disponível no additional_agreement.csvarquivo.

5. Para tornar um campo obrigatório, clique no ícone ★ na linha de descrição do campo. O ícone ficará azul.

6. Clique em Save changes.

Solicitação para adicionar campos personalizados ao formulário de cadastro

Além dos campos disponíveis na Conta de Distribuidor, você pode adicionar seus próprios campos ao formulário de cadastro. Para fazer isso, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com e forneça a lista de campos com as seguintes informações para cada campo:

• nome do campo em inglês;
• tipo:
  • string;
  • date;
  • select — selecionando uma opção de uma lista;
  • multi-select — selecionando várias opções de uma lista;
• se o campo é obrigatório ou não.

Para os campos select e multi-select, forneça também ao seu Gerente de Sucesso do Cliente conjuntos de valores possíveis para esses campos.

Integração do lado do aplicativo

Se você usou a integração através do widget de Login, nenhuma ação é necessária para integrar o formulário de cadastro estendido no lado do seu aplicativo.

Ao integrar por meio do Xsolla SDK, a coleta de informações adicionais sobre os usuários ainda não está disponível.

Ao integrar por meio da Login API, passe os dados de usuário adicionais coletados na solicitação Register new user usando o parâmetro fields. Esse parâmetro é um conjunto de pares propriedade-valor. Os campos do formulário de cadastro que podem ser conectados na Conta de Distribuidor correspondem às seguintes propriedades do 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"}}'

As opções para adicionar campos ao formulário de cadastro e o local para armazenar as informações coletadas diferem dependendo do tipo de armazenamento de dados do usuário escolhido:

• Armazenamento Xsolla
• Armazenamento PlayFab
• Armazenamento Firebase
• Armazenamento personalizado

Armazenamento Xsolla

Armazenamento PlayFab

Se você usar o armazenamento PlayFab, você poderá adicionar os campos disponíveis em sua Conta de Distribuidor e seus próprios campos ao formulário de cadastro.

As informações sobre campos adicionais e seus valores são salvas como dados do usuário no armazenamento PlayFab. Você pode acessar esses dados do usuário através da PlayFab API ou em sua conta PlayFab:

1. Vá para a seção Players e clique no ID do usuário.

2. Selecione a aba Player Data (Title).

Armazenamento Firebase

Armazenamento personalizado

Se você usar um armazenamento personalizado, você poderá adicionar os campos disponíveis em sua Conta de Distribuidor e seus próprios campos ao formulário de cadastro.

As informações sobre campos adicionais e seus valores são enviadas pelo servidor Xsolla Login na solicitação de cadastro para o URL especificado no campo New user URL na Conta de Distribuidor ao conectar seu armazenamento personalizado.

Exemplo:

Os seguintes campos são adicionados ao formulário de cadastro do usuário:

• país;
• campo nickname personalizado do tipo string;
• campo platform personalizado do tipo multi-select com valores possíveis: windows, mac os e linux.

Durante o cadastro do usuário, o servidor Xsolla Login enviará a seguinte solicitação para o URL do novo usuário:

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"]}'