Personalização

Como funciona

A personalização permite especificar as condições de exibição do catálogo de itens e aplicar promoções apenas a determinados usuários autorizados.

Isso dá a oportunidade de:

• oferecer itens e promoções que sejam mais relevantes a usuários específicos
• motivar os usuários fazer a primeira compra no jogo

Os seguintes tipos de personalização estão disponíveis:

• Personalização do lado da Xsolla. As regras e a lógica de personalização são configuradas e armazenadas no lado da Xsolla. O parceiro envia os atributos de usuário para a Xsolla e, em seguida, a Xsolla cria o catálogo de acordo com a lógica configurada.
• Personalização do lado do parceiro. As regras e a lógica de personalização são configuradas e armazenadas pelo parceiro, que envia um catálogo para um usuário específico à Xsolla.

Quem pode usar

• Parceiros que integraram a In-Game Store e configuraram pelo menos um dos seguintes tipos de item:
  • moedas virtuais
  • itens virtuais
  • conjuntos
• Parceiros que desejam usar a personalização do catálogo de itens da Xsolla para os usuários, ou a própria personalização deles.

Pré-requisitos

Antes de personalizar o catálogo de itens, integre o produto In-Game Store.

Personalização do lado da Xsolla

Fluxo do usuário

1. Um usuário não autorizado acessa o catálogo de itens. Dependendo da posição da opção Exibir itens a usuários não autorizados, o usuário verá:
   • itens que não tenham regras de personalização aplicados a eles;
   • todos os itens, incluindo aqueles que tenham regras de personalização aplicadas a eles.
2. O usuário clica em Fazer login e realiza a autorização pelo Xsolla Login.

3. A Xsolla solicita atributos de usuário do Xsolla Login.
4. A Xsolla exibe um catálogo personalizado com base nas regras de disponibilidade do item, as promoções definidas no lado da Xsolla e atributos de usuário obtidos do Xsolla Login.
5. O usuário seleciona um item do catálogo personalizado e clica em Comprar agora.

6. No momento da compra, a Xsolla solicita os atributos do usuário novamente e os compara com as regras de personalização:
   • Se um item não estiver mais disponível para compra, o usuário recebe uma mensagem informando que o item não pode ser comprado.
   • Se o item estiver disponível para compra, o usuário prossegue ao pagamento.

Configurando um catálogo de itens personalizado

Para usar a personalização do catálogo de itens implementada no lado da Xsolla:

1. Configure os atributos do usuário no produto Login.
2. Ative a personalização.
3. Defina as regras de exibição do catálogo. Você pode fazer isso ao ativar a personalização ou em um projeto na Conta de Distribuidor na seção Loja > Gerenciamento do catálogo > Regras de exibição do catálogo.

Para habilitar a personalização:

1. Abra seu projeto na Conta de Distribuidor e vá para a seção Loja > Personalização.
2. Se a personalização não for configurada, clique em Configurar personalização.
3. Selecione o tipo Personalização do lado da Xsolla.
4. Clique em Next.

5. Crie uma regra de exibição de catálogo:
   • Se ainda não houver regras de exibição de catálogo, a janela para criar regras abrirá automaticamente.
   • Se já houver regras de exibição de catálogo, na seção Regras de exibição de catálogo, clique em Criar regra.

6. Especifique o nome da regra e defina as condições para exibir itens no catálogo.

7. Para tornar itens com regras aplicadas visíveis a usuários não autorizados, defina a opção Exibir itens afetados aos usuários que não fizeram login como On.

8. Clique em Next.
9. Selecione os itens aos quais a regra deve ser aplicada.

10. Clique em Next.
11. Verifique as configurações. Se necessário, clique no botão Editar para fazer alterações.

12. Clique em Salvar e sair.

Para editar ou excluir regras, acesse a página Regras de exibição de catálogos, clique no ícone ••• na fileira da regra e selecione a opção desejada do menu. Para ativar ou desativar uma regra, altere seu status.

Configuração de promoções personalizadas

Você pode configurar promoções personalizadas, tais como conceder descontos em compras de itens virtuais para usuários que atingiram um certo nível no jogo.

Você pode definir uma ou mais condições. Observe que não é possível alterar a promoção enquanto ela estiver ativa. Leia Configure campanhas promocionais para obter mais informações sobre tipos e configurações de promoções.

Para configurar promoções personalizadas:

1. Configure atributos de usuário no produto Login.
2. Configure uma campanha promocional com bônus ou campanha com descontos. Defina a configuração Trigger promotion only for specific users como On e especifique as condições.

Personalização do lado do parceiro

Escolha esse tipo se você usa lógicas de personalização avançadas implementadas do seu lado e não deseja definir regras ou especificar atributos do lado da Xsolla.

Para usar a personalização do catálogo de itens implementada do seu lado:

1. Crie um catálogo de itens no lado da Xsolla e sincronize-o com o seu catálogo. Cada item no seu sistema deve ter um item_id ou sku correspondente na Xsolla.
2. Ative a personalização na Conta de Distribuidor.
3. Configure o processamento do webhook Personalização do catálogo do lado do parceiro.

Fluxo do usuário

1. O usuário não autorizado acessa o catálogo de itens. Dependendo da posição da opção Exibir itens relevantes aos usuários que não fizeram login, o usuário vê:
   • todos os itens no catálogo;
   • itens que você retornar em resposta ao webhook Personalização do catálogo do lado do parceiro.

A ordem na qual os itens são exibidos ao usuário depende da definição da opção Obter ordem dos skus via resposta de webhook.

2. O usuário clica em Fazer login e faz a autorização.

3. A Xsolla envia um webhook que solicita itens pelo ID do usuário.
4. A resposta do parceiro retorna uma lista dos SKUs de itens disponíveis a esse usuário.
5. O usuário seleciona um item do catálogo personalizado e clica em Comprar agora.

6. No lado da Xsolla, a etapa 3 e 4 desse fluxo são executadas para verificar a disponibilidade dos itens no momento da compra:
   • Se um item não estiver mais disponível para compra, o usuário recebe uma mensagem de que o item não pode ser comprado.
   • Se o item estiver disponível, o usuário prossegue ao pagamento.

Configurando um catálogo de itens personalizado

Para habilitar a personalização:

1. Abra seu projeto na Conta de Distribuidor e vá para a seção Loja > Personalização.
2. Se a personalização não for configurada, clique em Configurar personalização.
3. Selecione o tipo Personalização do lado do parceiro.

4. Clique em Next.
5. Configure a exibição de itens. Para fazer isso, defina as opções correspondentes como ativadas:
   • Exibir itens relevantes aos usuários que não fizeram login — para ativar a exibição apenas dos itens retornados aos usuários não autorizados em resposta ao webhook Personalização do catálogo do lado do parceiro. Se a opção estiver desativada, os usuários não autorizados verão todos os itens no catálogo.
   • Obter ordem dos SKUs via resposta de webhook — para a exibição de itens ao usuário na ordem que você passar em resposta ao webhook Personalização do catálogo do lado do parceiro. Se a poção estiver inativa, os itens serão exibidos ao usuário na ordem definida no lado da Xsolla. Para definir ou recuperar a ordem de exibição de itens no lado da Xsolla, use o parâmetro ordem na subseção Admin do grupo Itens e moedas virtuais.

6. Clique em Salvar alterações.

Configurando o processamento de webhooks

A Xsolla enviará um webhook Personalização de catálogo no lado do parceiro que contém os parâmetros de usuário e projeto ao URL do webhook quando um usuário interage com o catálogo de itens. Configuração do processamento de webhooks:

1. No seu projeto na Conta de Distribuidor, acesse Configurações do Projeto > Webhooks e insira o URL para enviar webhooks. Essa etapa é opcional se você já configurou webhooks.
2. Você deve retornar uma lista dos SKUs de itens disponíveis ao usuário como resposta. Neste caso, você também pode incluir informações de que um usuário pode comprar um item específico uma certa quantidade limitada de vezes, ou somente dentro de um certo período de disponibilidade. Esse recurso permite que você controle a quantidade e tipo de itens disponíveis ao usuário.

Cada solicitação à Xsolla para recuperar o catálogo gera uma nova solicitação da Xsolla ao servidor do jogo. A Xsolla usa o armazenamento de dados em cache para reduzir a quantidade de solicitações do servidor do jogo e envia o webhook partner_side_catalog após o fim da validade do cache.

Se o cache não estiver concluído, o webhook partner_side_catalog é enviado com cada solicitação à Xsolla. Por exemplo, a Xsolla recebe diversas solicitações de catálogo simultaneamente e o servidor do jogo responde com atraso.

Para testar o webhook, você pode consultar o catálogo de itens. Você receberá um webhook no URL configurado em resposta.

Alteração do tipo de personalização

Última atualização: 19 de Março de 2025