JSON para o mapa de nome-chave de perfil do usuário

Como funciona

Você pode mapear os campos do objeto JSON que você retornar em resposta aos webhooks do Xsolla Login para as seguintes propriedades de perfil de usuário no sistema Xsolla:

• data de nascimento (birthday)
• apelido (nickname)
• nome(first_name)
• sobrenome(last_name)
• gênero (gender)
• ID de usuário no seu servidor (server_custom_id)

• para sincronizar dados com a Web Shop
• para aplicar marcadores de mesclagem do Mailchimp
• para implementar integrações com outros sistemas externos

Quem pode usar

Parceiros que usam armazenamentos de dados de usuários personalizados e desejam usar os dados dentro do Xsolla Login.

Como obtê-lo

1. No seu projeto na Conta de Distribuidor, acesse a seção Login.
2. Selecione a opção de login e acesse a seção Banco de dados de usuários.
3. Acesse a seção Armazenamento.
4. Selecione Armazenamento personalizado.
5. Escolha o webhook para o qual deseja configurar o mapeamento de chaves:
   • verificação de usuário
   • criação de usuário
   • login social
6. No bloco Mapa de nome-chave, insira os nomes dos campos que devem ser mapeados às propriedades de perfil de usuário correspondentes.

7. Defina a opção Enable user account linking como ativa para permitir que o nosso sistema identifique todas as contas com o mesmo server_custom_id como pertencendo ao mesmo usuário (opcional).

8. Clique em Save changes.

Exemplos de uso de mapa de nome-chave

Transferência dos dados do usuário da resposta do webhook para um JWT e propriedades do perfil de usuário

1. Em resposta ao webhook de verificação de usuário, você envia o seguinte objeto JSON (ele pode conter qualquer conjunto de campos):

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17}

2. Na Conta de Distribuidor, você mapeou as chaves às propriedades nickname e server_custom_id.

3. Em resposta à solicitação Obter detalhes do usuário, você receberá o seguinte JSON:

 1{
 2  "birthday": null,
 3  "country": null,
 4  "devices": [
 5    {
 6      "device": null,
 7      "last_used_at": null,
 8      "type": null
 9    },
10    {
11      "device": null,
12      "last_used_at": null,
13      "type": null
14    }
15  ],
16  "email": null,
17  "external_id": null,
18  "first_name": null,
19  "gender": null,
20  "groups": [
21    {
22      "id": 1,
23      "is_default": false,
24      "name": "admin"
25    },
26    {
27      "id": 5,
28      "is_default": false,
29      "name": "user"
30    }
31  ],
32  "id": null,
33  "is_anonymous": false,
34  "last_login": null,
35  "last_name": null,
36  "nickname": "gamer123",
37  "phone": null,
38  "phone_auth": null,
39  "registered": null,
40  "tag": null,
41  "username": null
42}

Uso do mapa de nome-chave e vinculação de conta durante a autenticação na Web Shop

1. O usuário faz login na Web Shop usando seu ID. O ID de Usuário é registrado no campo server_custom_id do JWT.
2. A Web Shop envia um webhook User validation in Web Shop ao seu servidor.
3. Seu servidor responde ao webhook com o código HTTP 200 se o usuário existir, ou 404 se não.
4. A Web Shop autentica o usuário.
5. O usuário faz login na Web Shop novamente usando um método diferente, tal como um login social.
6. A Web Shop redireciona o usuário para a página de login da rede social.
7. O usuário faz login na rede social.
8. A rede social retorna os dados do perfil do usuário à Web Shop.
9. A Web Shop envia um webhook ao seu URL de login social.
10. Seu servidor identifica o usuário com base nos dados do perfil da rede social e atribui a ele o mesmo ID de Usuário que foi usado durante a autenticação de ID de Usuário.
11. Seu servidor responde com um código 2xx e inclui um corpo JSON contendo o ID de Usuário.
12. A Web Shop salva os atributos de usuário e adiciona os dados da resposta do webhook ao campo partner_data no JWT.
13. Se o mapa de nome-chave incluir uma chave para server_custom_id e a vinculação de conta estiver ativada, a Web Shop mapeia os dados do usuário recebidos às propriedades do perfil com base no mapa de nome-chave e vincula as contas.
14. A Web Shop autentica o usuário na mesma conta usada durante o login por ID de Usuário.

Continuar lendo