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

As seguintes opções 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. O usuário não autorizado vai ao catálogo de itens e vê todos os itens que não foram configurados em promoções personalizadas.
2. O usuário clica em Fazer login e recebe a autorização através do Xsolla Login.

3. A Xsolla solicita atributos de usuário através do Xsolla Login.
4. A Xsolla exibe um catálogo personalizado com base nas regras de disponibilidade de itens e promoções criadas do 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 o usuário, o usuário recebe uma mensagem informando 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 usar a personalização do catálogo de itens da Xsolla para usuários:

1. Configure os atributos de usuário no produto de Login.
2. Defina as regras de exibição do catálogo.

Regras de exibição do catálogo

As regras de exibição do catálogo permitem personalizar a exibição do catálogo com base nos atributos do usuário.

Uma regra pode conter um número ilimitado de itens dos seguintes tipos:

• item
• conjunto
• pacote de moedas
• chaves de jogo

Você pode criar várias condições com o mesmo atributo de usuário em uma única regra.

Criando uma regra de exibição de catálogo

Para criar uma regra de exibição de catálogo:

1. Abra seu projeto na Conta de Distribuidor.
2. Clique em Store no menu lateral.
3. No painel Catalog Management, clique em Configure.

4. No painel Catalog display rules, clique em Configure.

5. Clique em Create rule.

6. Especifique o nome da regra e defina as condições de exibição de item no catálogo.

7. Selecione os itens aos quais a regra será aplicada.

8. Verifique suas configurações. Se necessário, clique no botão Edit para fazer alterações.

9. Clique em Save and Exit.

Para editar e excluir regras, clique no ícone ••• e selecione o item do menu. Para ativar ou desativar uma regra, clique na opção e selecione o item.

Você pode usar a Conta de Distribuidor ou os métodos de API para gerenciar as regras que especificam como o catálogo é exibido. Isso inclui o conjunto e a quantidade de itens, e as condições que serão aplicadas a esses itens.

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

Você pode enviar uma solicitação ao seu Gerente de Sucesso do Cliente ou um e-mail a csm@xsolla.com se quiser personalizar o catálogo do seu lado. Esse recurso é útil para implementar lógicas de personalização avançadas do seu lado caso não deseje definir regras e especificar atributos do lado da Xsolla.

Fluxo do usuário

1. O usuário não autorizado vai ao catálogo de itens e vê todos os itens.
2. O usuário clica em Fazer login e recebe a autorização através do Xsolla Login.

3. A Xsolla envia um webhook que solicita itens com base no ID de usuário.
4. A resposta do parceiro retorna uma lista de SKUs de itens disponíveis para este usuário.
5. O usuário seleciona um item do catálogo personalizado e clica em Comprar Agora.

6. No lado da Xsolla, as etapas 3 e 4 deste script são executadas para verificar a disponibilidade dos itens no momento da compra:
   • Se um item não estiver mais disponível para o usuário, 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 dos itens.

Configurando um catálogo de itens personalizado

1. Entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail a csm@xsolla.com para conectar a personalização.
2. Abra seu projeto na Conta de Distribuidor, vá para Settings > Webhooks e insira o URL para enviar webhooks. Esta etapa é opcional se você já tiver webhooks configurados.
3. Configure o processamento do webhook Personalização de catálogo no lado do parceiro:
   1. A Xsolla enviará um webhook que contém os parâmetros do usuário e do projeto para o URL do webhook quando um usuário interagir com o catálogo de itens.
   2. Você deve retornar uma lista de SKU dos itens que estão disponíveis para o usuário em resposta. Nesse caso, você também pode incluir determinações sobre quantos vezes cada item pode ser comprado. Este recurso permite controlar o número e o tipo de itens que o usuário pode adicionar ao carrinho e comprar.

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.

Altere a variante da personalização

Última atualização: 3 de Outubro de 2024