SDK para o Cocos Creator / Configure os planos de catálogo e assinatura
  Voltar aos Documentos

SDK para o Cocos Creator

Configure os planos de catálogo e assinatura

Configure moedas virtuais, itens virtuais e/ou planos de assinatura em sua Conta de Distribuidor seguindo as instruções passo a passo:

Criação de moedas virtuais

Moedas virtuais são tipos de dinheiro virtual que são usados para comprar e vender itens dentro do jogo. Dependendo de sua finalidade, uma moeda virtual afeta o equilíbrio da economia do jogo ou está conectada à monetização do aplicativo. Você também pode criar moedas fortes, uma moeda virtual que está vinculada à plataforma de compra e que só pode ser comprada com dinheiro real.

Você pode vender a moeda virtual em quantias predefinidas. Para um pacote, você pode definir um preço especial que tenha um valor diferente da quantia de moedas virtuais nele.

Veja a seção Moedas Virtuais para saber mais sobre as moedas virtuais.

Para configurar uma moeda virtual:

  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Store no menu lateral e conecte o módulo Virtual Currency.

  1. Na aba Prices, clique em New virtual currency.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar

Configure um pacote de moedas virtuais

Para configurar um pacote de moedas virtuais:

  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Store no menu lateral e vá para Virtual Currency.
  3. Vá para Packages.
  4. Clique em New package.

  1. Especifique os seguintes parâmetros:
    • Imagem do pacote (opcional).
    • SKU do pacote.
    • Nome do pacote.
    • Breve descrição do pacote.
    • Moeda virtual do pacote.
    • Preços nas moedas reais e virtuais.
    • Moeda padrão.
    • Atributo (opcional).
Observação
Você pode adicionar apenas um tipo de moeda virtual a um pacote. Você deve especificar os preços dos pacotes de moedas virtuais em pelo menos uma moeda real ou virtual. A quantia de moedas virtuais pode ser especificada apenas como o valor inteiro.
  1. Se você quiser limitar o número de vezes que um usuário pode comprar um pacote de moedas virtuais, defina a configuração Limit the number of times one user can buy package como On e especifique o limite.
  2. Você também pode definir um limite de tempo para a exibição do pacote na loja. Para fazer isso, selecione Time period, especifique o fuso horário, o início e o fim do período. Para não indicar o fim do período de exibição do pacote, marque a caixa No end date.
  3. Clique em Create package.
Observação
Depois de criar um item virtual, moeda virtual ou pacote de moedas virtuais, você pode definir os status do item para determinar se ele está disponível, indisponível ou parcialmente disponível.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar

Criar itens virtuais

Itens virtuais são conteúdos do jogo que você pode vender por moedas reais e virtuais.

Existem 3 tipos de itens virtuais:

  • Consumíveis — itens que você pode ter em grandes quantidades e comprar várias vezes. A quantidade deles é reduzida quando os usuários os consomem.
  • Não consumíveis — itens que podem ser acumulados ou comprados apenas uma vez. Eles permanecem no inventário do usuário e não podem ser removidos do inventário quando consumidos no lado do cliente. Você pode retirá-los somente por meio de um método de servidor.
  • Itens de tempo limitado — item não consumível que fica disponível por tempo limitado e não desaparece do inventário quando expira. O usuário precisa comprar esse item novamente para ativá-lo.

Veja a seção dos Itens Virtuais para saber mais sobre os itens virtuais.

Para configurar itens virtuais, você precisa configurar grupos de itens virtuais. Os grupos permitem que você tenha um catálogo multinível e gerencie a exibição de itens na loja.

Para criar grupos de itens virtuais:

  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique na Store no menu lateral e conecte o módulo Virtual Items.

  1. Clique em Create a group.

  1. Especifique os seguintes parâmetros:
    • Código do grupo.
    • Nome do grupo.
  2. Se quiser mostrar o grupo em um catálogo, defina a configuração Show group in Store como On.
Observação
Os itens que não têm um grupo especificado são adicionados ao grupo Ungrouped.

  1. Clique em Create group.

Para configurar um item virtual:

  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Store no menu lateral e conecte o módulo Virtual Items.
  3. Clique em Create item.

  1. Especifique:
    • Imagem.
    • SKU.
    • Um ou vários grupos aos quais o item deve pertencer.
    • Nome.
    • Descrição.
Observação
Uma descrição de item é limitada a 255 símbolos. Se você precisa adicionar uma descrição maior do que 255 símbolos, contate seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
    • Propriedade do item: consumível, não consumível, ou itens de tempo limitado.
    • Preços em tempo real ou moedas virtuais.
Aviso
Não é possível criar um item sem especificar o preço em moeda real ou virtual. Não é possível criar um item com um valor zero.
  1. Se você quiser limitar o número de vezes que um usuário pode comprar um item, defina a configuração Limit number of times one user can buy this item como On e especifique o limite.
  2. Você pode definir um limite de tempo para a exibição do item na loja. Para fazer isso, selecione o Time period, especifique o fuso horário, o início e o fim do período. Para não indicar o fim do período de exibição do item, marque a caixa No end date.
  3. Clique em Create item.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar

Criação de conjuntos

Conjunto é uma combinação de vários itens que são vendidos como uma única unidade. Você pode adicionar itens de diferentes tipos a um conjunto:

  • Moedas virtuais.
  • Pacote de moedas virtuais.
  • Itens virtuais, incluindo itens de tempo limitado.
  • Conjuntos.

Veja a seção Conjuntos para saber mais sobre eles.

Para configurar um conjunto:

  1. Abra seu projeto na Conta de Distribuidor.
  2. Clique em Store no menu lateral e conecte o módulo Bundles.

  1. Clique em Criar conjunto.
  2. Especifique os seguintes parâmetros:
    • Imagem (opcional).
    • SKU.
    • Nome.
    • Descrição curta (opcional).
    • Tipo de produto.
    • Preço.
Aviso
Não é possível adicionar o mesmo conjunto ou bens físicos a um conjunto. Não é possível criar um conjunto vazio.
Observação
Você pode criar um conjunto sem especificar seu preço em moeda real ou virtual. Se esse conjunto for exibido na loja, ele estará disponível para os usuários gratuitamente.
  1. Se você quiser limitar o número de vezes que um usuário pode comprar um conjunto, defina a configuração Limit the number of times one user can buy bundle como On e especifique o limite.
  2. Você pode definir um limite de tempo para a exibição do conjunto na loja. Para fazer isso, selecione o Time period e especifique o fuso horário, o início e o fim do período. Para não indicar o fim do período de exibição do conjunto, marque a caixa No end date.
  3. Clique em Save.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar

Configure um plano de assinatura

Você pode configurar planos de assinatura por meio da Conta de Distribuidor ou com a chamada de API Criar Plano.

Para configurar um plano através da Conta de Distribuidor:

  1. Vá para a seção Subscriptions.
  2. Na aba Subscription plan, clique em Create subscription plan.
  1. Escolha e configure o tipo de plano:
Observação
Todos os planos criados por meio da Conta de Distribuidor recebem um External ID que permite a você:
  • Abrir uma interface de pagamento com um plano específico.
  • Identificar o plano nos alertas.
  • Identificar o plano em um relatório transacional.
Se precisar especificar o External ID, crie um plano com a chamada de API Criar Plano.

Configure um plano regular

  1. Especifique:
    1. Nome do plano.
    2. Descrição (opcional): essa descrição do plano é exibida na interface de pagamento quando os usuários estão comprando uma assinatura.

  1. Clique em Next.
  2. Escolha uma das opções de taxa de assinatura:
    • Regular: o valor de cada pagamento é especificado manualmente.
    • Including setup fee: o valor de cada pagamento, bem como o valor da taxa de configuração, são especificados manualmente. Use essa configuração se quiser cobrar custos adicionais do assinante, como conectar uma licença, configurar um sistema, treinar um usuário ou fornecer uma consulta. Neste caso, o primeiro pagamento incluirá uma taxa de configuração e os pagamentos restantes serão equivalentes ao valor do pagamento regular.
Observação
Se o seu projeto não tiver a capacidade de configurar uma assinatura com taxa de configuração e preços para moedas diferentes, entre em contato com o Gerente de Sucesso do Cliente ou envie um e-mail ao endereço csm@xsolla.com para habilitar várias moedas no projeto.

    • Associated with the first payment: o valor de cada pagamento é equivalente ao primeiro pagamento. O custo da assinatura e o tipo de moeda são passados nos parâmetros purchase.checkout.amount e purchase.checkout.currency ao abrir a interface de pagamento. Use essa opção se quiser gerenciar preços do seu lado e definir preços individuais para usuários específicos.

  1. Independentemente do tipo de taxa escolhida, regular ou de configuração, você poderá configurar preços de assinatura diferentes para diferentes moedas. Para fazer isso:

    1. No campo Currency e Price, selecione a moeda necessária e especifique o preço da assinatura. Para uma assinatura com taxa de configuração, insira também o valor da taxa de configuração no campo correspondente.
    1. Clique em + para adicionar preços em outras moedas.
    1. Especifique a moeda padrão.
  1. Configure o ciclo de cobrança:
    1. Especifique a frequência do pagamento.
    2. Especifique o número de dias no período de avaliação em que a assinatura pode ser usada sem pagamento. Defina o valor como 0 para criar um plano sem um período de avaliação.
  1. Especifique parâmetros para um pagamento único. Com esse tipo de renovação de assinatura, os usuários fazem pagamentos por meio de um link de pagamento enviado por e-mail.
    1. Lembrete de vencimento: especifique o número de dias antes da data de vencimento da assinatura em que o usuário receberá um lembrete. Se o valor for definido como 6 ou superior, o usuário receberá um lembrete extra um dia antes da data de vencimento. Defina o valor como 0 se você não quiser enviar um lembrete.
    2. Período de carência: o número de dias que os usuários podem continuar usando sua assinatura após a data de validade com a opção de renová-la. Defina o valor como 0 para criar um plano sem um período de cortesia.
  1. Especifique os parâmetros para um pagamento automático: com esse tipo de renovação de assinatura, os pagamentos são feitos automaticamente usando as informações de cobrança salvas sem qualquer interação do usuário.
    1. Lembrete de validade da assinatura.
    2. A quantidade de tentativas após a primeira tentativa malsucedida de cobrar pela assinatura. O sistema tentará novamente uma vez por dia.
  1. Clique em Next.
Observação
A configuração de bônus na Conta de Distribuidor não está disponível no momento. Para ativar o envio de bônus, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
  1. Clique em Criar.

Configure um plano vitalício

  1. Especifique:
    1. Nome do plano.
    2. Descrição (opcional): essa descrição do plano é exibida na interface de pagamento quando os usuários estão comprando uma assinatura.

  1. Clique em Next.
  2. Escolha uma das opções de taxa de assinatura:
    • Regular: o valor de cada pagamento é especificado manualmente.
    • Associated with the first payment: o valor de cada pagamento é equivalente ao primeiro pagamento feito pelo usuário. O custo da assinatura e o tipo de moeda são passados nos parâmetros purchase.checkout.amount e purchase.checkout.currency ao abrir a interface de pagamento. Use essa opção se quiser gerenciar os preços do seu lado e ser capaz de definir o preço individual para um usuário específico.

  1. No campo Refund period, defina o número de dias em que o usuário pode cancelar a assinatura e reembolsar o pagamento.

  1. Se você escolher uma taxa de assinatura regular, você poderá configurar preços de assinatura diferentes para moedas diferentes. Para fazer isso:
Observação
Se o seu projeto não tiver a capacidade de configurar preços para moedas diferentes, entre em contato com o Gerente de Sucesso do Cliente ou envie um e-mail ao endereço csm@xsolla.com para habilitar várias moedas no projeto.
    1. No campo Currency e Price, selecione a moeda necessária e especifique o valor do preço de assinatura.
    1. Clique em + para adicionar preços em outras moedas.
    1. Especifique a moeda padrão.
  1. Clique em Next.

Observação
A configuração de bônus na Conta de Distribuidor não está disponível no momento. Para ativar o envio de bônus, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
  1. Clique em Create.

Configure um passe de temporada

  1. Especifique:
    1. Nome do plano.
    2. Período de validade do passe de temporada.
    3. Descrição (opcional): essa descrição do plano é exibida na interface de pagamento quando os usuários compram uma assinatura.

  1. Clique em Next.
  2. Escolha uma das opções de taxa de assinatura:
    • Regular: o valor de cada pagamento é especificado manualmente.
    • Associated with the first payment: o valor de cada pagamento é equivalente ao primeiro pagamento feito pelo usuário. O custo da assinatura e o tipo de moeda são passados nos parâmetros purchase.checkout.amount e purchase.checkout.currency ao abrir a interface de pagamento. Use essa opção se quiser gerenciar os preços do seu lado e ser capaz de definir o preço individual para um usuário específico.

  1. No campo Período de reembolso, defina o número de dias em que o usuário pode cancelar a assinatura e reembolsar o pagamento.

  1. Se você escolher uma taxa de assinatura regular, você poderá configurar preços de assinatura diferentes para moedas diferentes. Para fazer isso:
Observação
Se o seu projeto não tiver a capacidade de configurar preços para moedas diferentes, entre em contato com o Gerente de Sucesso do Cliente ou envie um e-mail ao endereço csm@xsolla.com para habilitar várias moedas no projeto.
    1. No campo Currency e Price, selecione a moeda necessária e especifique o valor do preço de assinatura.
    1. Clique em + para adicionar preços em outras moedas.
    1. Especifique a moeda padrão.
  1. Clique em Next.
Observação
A configuração de bônus na Conta de Distribuidor não está disponível no momento. Para ativar o envio de bônus, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.
  1. Clique em Create.
Este artigo foi útil?
Obrigado!
Podemos melhorar alguma coisa? Mensagem
Que pena ouvir isso
Explique porque este artigo não foi útil para você. Mensagem
Obrigado pelo seu feedback!
Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.
Ocultar
Última atualização: 10 de Outubro de 2023

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Relatar um problema
Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
Forneça um e-mail para que possamos responder
Obrigado pelo seu feedback!