Personalização

Como funciona

A personalização permite especificar as condições de exibição do catálogo de jogos 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 o Buy Button e configuraram a venda de chaves de jogo.
• Parceiros que desejam usar a personalização do catálogo de jogos da Xsolla ou sua própria personalização.

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 jogos e vê todos os jogos 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 jogos e promoções criadas do lado da Xsolla, e atributos de usuário obtidos do Xsolla Login.
5. O usuário seleciona um jogo 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 jogo não estiver mais disponível para o usuário, o usuário recebe uma mensagem informando que o jogo não pode ser comprado.
   • Se o jogo estiver disponível, o usuário prossegue ao pagamento.

Configurando um catálogo de jogos personalizado

Para usar a personalização do catálogo de jogos 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, como descontos em um DLC para usuários que já possuem o jogo base.

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 jogos e vê todos os jogos.
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 jogos com base no ID de usuário.
4. A resposta do parceiro retorna uma lista de SKUs de jogos disponíveis para este usuário.
5. O usuário seleciona um jogo 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 jogos no momento da compra:
   • Se um jogo não estiver mais disponível para o usuário, o usuário recebe uma mensagem de que o jogo não pode ser comprado.
   • Se o jogo estiver disponível, o usuário prossegue ao pagamento dos jogos.

Configurando um catálogo de jogos 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 de webhooks:
   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 jogos.
   2. Você deve retornar uma lista de SKU dos jogos que estão disponíveis para o usuário em resposta. Nesse caso, você também pode incluir determinações sobre quantos vezes cada jogo pode ser comprado. Este recurso permite controlar o número e o tipo de jogos 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 jogos. Você receberá um webhook no URL configurado em resposta.

Altere a variante da personalização

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