Conjuntos

Como funciona

Conjunto é um aglomerado de vários itens que são vendidos como uma única unidade.

Principais recursos:

• Adição de itens de diferentes tipos a um conjunto:
  • moedas virtuais
  • pacotes de moedas virtuais
  • chaves de jogo para as plataformas pré-selecionadas
  • itens virtuais
  • conjuntos
• Conjunto gratuito.
• Configuração da precificação do conjunto em moedas reais e virtuais. Você pode definir preços em diversas moedas virtuais ou reais. Certifique-se de selecionar uma moeda padrão nesse caso.
• Definindo preços regionais para conjuntos.
• Limitação do número de conjuntos disponíveis para compra.
• Definindo um limite de tempo para a exibição dos conjuntos na loja.
• Restrição da disponibilidade do conjunto por região.

• Não é possível adicionar o mesmo conjunto ao conjunto.
• Não é possível criar um conjunto vazio.
• Se um conjunto inclui chaves e as chaves disponíveis estão esgotadas, a venda do conjunto é pausada.
• Só é possível definir restrições regionais para conjuntos via chamadas de API.

Como configurar

Configuração através da Conta de Distribuidor

Para criar um conjunto:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Items catalog > All items.
2. Selecione Add e então Bundle na lista suspensa.

3. Especifique os seguintes parâmetros:
   • Imagem (opcional).
   • SKU.
   • Um dos diversos grupos do qual o conjunto deve pertencer.
   • Nome.
   • Descrição (opcional).
4. Configure atributos do conjunto (opcional) usando um dos seguintes métodos:
   • Adicione atributos e seus valores no formato JSON.
   • Crie atributos e valores manualmente e vincule-os a itens específicos.
5. Selecione Next.
6. Se a personalização do lado do parceiro estiver habilitada, você pode escolher entre um tipo de conjunto padrão e um dinâmico. Conjuntos dinâmicos permitem que você pule a criação do item na Xsolla e, em vez disso, retorne os conteúdos do conjunto gerado pelo seu servidor quando o catálogo é solicitado. Se a personalização do lado do parceiro for desativada, o seletor do tipo de conjunto não é exibido, e um conjunto padrão é criado automaticamente.

7. Adicione itens ao conjunto:
   1. Selecione o tipo de item.
   2. Especifique um ou mais SKUs de itens a serem inclusos no conjunto.
   3. Defina a quantidade para cada SKU.

8. Selecione Next.
9. Defina o preço do conjunto no campo Paid or Free:
   • Para criar um conjunto gratuito, selecione Free bundle.
   • Para definir um preço, selecione Paid bundle e especifique o preço em moeda real ou virtual. Não é possível criar um conjunto com um preço de valor zero. Se necessário, configure preços regionais.
10. Para limitar a quantidade de conjuntos disponíveis para compra, ative a opção Limit bundle purchases per user e insira a quantidade desejada.

11. Para configurar a frequência de redefinição do limite:
    1. Na lista suspensa, selecione um período:
       • Diariamente.
       • Semanalmente.
       • Mensalmente.
       • Intervalo personalizado — isso é calculado a partir da data inicial de exibição do conjunto.
       • Sem atualização regular.
    2. Defina o cronograma de redefinição com base no período selecionado.

12. Selecione Next.

13. Configure como o conjunto é exibido na loja:
    1. Escolha o status.
    2. Defina um limite de tempo de exibição para o conjunto (opcional): especifique o fuso horário e o início e fim do período. Se você não quiser indicar o fim do período de exibição, marque a caixa No end date.

14. Selecione Next.
15. Confira as configurações e clique em Save.

Configuração via API

Para definir conjuntos, você pode usar as chamadas da subseção Admin no grupo Bundles.

1"content": [
2  {
3     "sku": "brilliant_game_sku_steam",
4     "quantity": 1
5  }
6]

Para limitar a quantidade de conjuntos disponíveis para compra, use as chamadas de API Criar conjunto ou Conjunto de atualização com os seguintes parâmetros:

• limits — especifica a quantidade máxima de conjuntos disponíveis para compra.
• limits.recurrent_schedule — define a frequência da redefinição do limite.

Você também pode configurar o limite de tempo de exibição do conjunto na loja e defina restrições regionais.

Exibir conjuntos na loja

Conjuntos são exibidos no catálogo dependendo de como ele é implementado — pelo site builder ou via API.

Exibição via site builder

Para exibir conjuntos no seu site:

1. Criação de conjuntos.
2. No seu projeto na Conta de Distribuidor, acesse a seção Storefronts > Websites.
3. No painel do site desejado, clique em Open Site Builder.

4. No bloco Store, acesse a seção Store.
5. No campo Item type, selecione Bundles.

6. No campo Item group, selecione o grupo.
7. Escolha um layout de cartão de item.

8. Se necessário, personalize o layout do cartão ativando as opções correspondentes nas configurações de layout do cartão.

9. Depois de fazer todas as alterações necessárias e preparar seu site para o lançamento:
   1. No canto superior direito do construtor de sites, selecione Publish.
   2. Marque as caixas próximas às páginas que deseja publicar.
   3. Selecione Publish.

Depois que o site for publicado, uma seção com conjuntos ficará disponível. Se nenhum conjunto for exibido, verifique se o status de Available and that no time-based display limit está ativado.

Obter informações de conjunto via API

Se seu catálogo é configurando usando API, os dados de conjunto são retornados pelas chamadas disponíveis na subseção Catálogo:

• Obter lista de pacotes
• Obter lista de pacotes por grupo especificado
• Obter pacote especificado

Configure os webhooks

Você pode configurar quais dados de itens são inclusos nos webhooks Pagamento do pedido bem-sucedido e Cancelamento do pedido pela matriz items.

Concessão de conjuntos aos usuários

Dependendo do tipo de item e configurações de integração, o conjunto é concedido ao usuário em uma das seguintes maneiras:

• Se você integrou o PlayFab, moedas virtuais e itens são concedidos ao inventário PlayFab do usuário automaticamente.
• Se você usar um sistema de entrega personalizado, todos os itens virtuais e moedas são concedidos do seu lado. Recomendamos configurar um gerenciador de webhooks para receber dados de pedido no seu backend. Os dados necessários são inclusos no webhook Pagamento bem-sucedido do pedido.
• Se a entrega do conteúdo do conjunto não for desativada, depois de uma compra de conjunto, todos os itens inclusos no conjunto são listados na matriz de itens do webhook Pagamento bem-sucedido do pedido como itens separados. Se um conjunto contiver outro conjunto, ele também será desempacotado e passado como itens separados.

Consulte a seção Configure o rastreamento de status de pedidos para obter mais detalhes sobre isso e outros métodos de recuperação de dados de compra.