Itens virtuais

Como funciona

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

Principais características:

• Configure preços em moedas reais e virtuais.
• Configure o catálogo com vários níveis.
• Determine automaticamente a moeda e o país do usuário.
• Limitando a quantidade de itens disponíveis para compra.
• Limitando o tempo de exibição de itens na loja.
• Itens grátis.

Recursos de configuração de preços:

• Um item pode ter o preço em moedas reais e virtuais.
• Você pode configurar preços em várias moedas reais ou virtuais. Certifique-se de selecionar uma moeda padrão nesse caso.
• Você pode criar um item sem especificar seu preço em moeda real ou virtual. Se esse item for exibido na loja, ele estará disponível para os usuários gratuitamente.

Restrições de configuração de preços:

• Não é possível criar um item com um valor de preço zero.

Existem 3 tipos de itens virtuais:

• Consumíveis
• Não consumíveis
• Itens de tempo limitado

Itens virtuais consumíveis

Um item consumível é um item no estoque que você pode ter em grandes quantidades e comprar várias vezes. Sua quantidade é diminuída quando os usuários o consomem.

Principais características:

• Reabastecer o estoque de itens no inventário.
• Armazenar muitas instâncias do mesmo item no inventário do usuário.
• Pode ser consumido do lado do cliente.

Exemplo: granadas, munição, etc.

Itens virtuais não consumíveis

Um item não consumível é um item no inventário que pode ser adquirido ou comprado apenas uma vez.

Principais características:

• Os usuários podem ter apenas uma unidade deste item no inventário.
• Não pode ser removido do inventário por ser consumido no lado do cliente. Você pode retirá-lo apenas através de um método de servidor.

Exemplo: Acesso a um local, status, cosméticos, pré-instalado DLC, opção SEM ANÚNCIOS para jogos móveis, etc.

Itens de tempo limitado

Um item de tempo limitado é uma compra única. O usuário precisa comprá-lo novamente quando ele expirar.

Principais características:

• Torna-se inativo ao expirar.
• O usuário deve comprar esta assinatura novamente para ativá-la.

Exemplo: Battle Pass, Season Pass, acesso temporário a um item, item ou conteúdo adicional de cosméticos no jogo.

Consulte a receita de itens de tempo limitado para obter detalhes.

Limitação do número de itens disponíveis para compra

Você pode limitar a compra de itens. Por exemplo, você pode limitar:

• o número de itens por usuário
• itens de boas-vindas que só estão disponíveis para compra uma vez

Se o usuário tiver atingido o limite especificado, o item não será exibido no catálogo.

Você pode exibir o número máximo disponível de itens e o número restante de itens que está disponível para o usuário.

Para definir um limite de compra ao criar um item na Conta de Distribuidor, defina a opção Limit number of times one user can buy this item como On e especifique o número de vezes que o item pode ser comprado.

Você pode usar os métodos da subseção Catálogo do grupo de métodos Itens virtuais & moeda para obter informações sobre itens.

Na resposta, você receberá as seguintes informações, além de informações sobre o item virtual:

• o número máximo de itens que um usuário pode comprar
• o número restante de itens disponíveis para o usuário comprar

Você pode ler mais sobre como configurar ou atualizar restrições nas instruções Limites para o usuário.

{
  "items": [
    {
      "sku": "big_rocket",
      "name": "Big Rocket",
      "groups": [
        {
          "external_id": "accessory",
          "name": "Accessory"
        }
      ],
      "attributes": [
        {
          "external_id": "stack_size",
          "name": "Stack size",
          "values": [
            {
              "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
              "value": "5"
            }
          ]
        }
      ],
      "type": "virtual_good",
      "description": "Big Rocket - description",
      "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
      "is_free": false,
      "price": {
        "amount": "100.99",
        "amount_without_discount": "100.99",
        "currency": "USD"
      },
      "virtual_prices": [
        {
          "amount": 100,
          "sku": "vc_test",
          "is_default": true,
          "amount_without_discount": 100,
          "image_url": "http://image.png",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "description": "description"
        }
      ],
      "can_be_bought": true,
      "inventory_options": {
        "consumable": {
          "usages_count": 1
        },
        "expiration_period": {
          "type": "day",
          "value": 1
        }
      },
      "virtual_item_type": "non_renewing_subscription",
      "limits": {
        "per_user": {
            "total": 5,
            "available": 5
        },
        "per_item": null
      },
}

Limitando o tempo de exibição de itens na loja

• manter a relevância do catálogo em um determinado momento, por exemplo, durante as vendas de fim de ano
• criar um item com antecedência sem exibi-lo no catálogo
• motive os usuários a comprar itens exibindo um temporizador ao lado do item

• periods[0].date_from com a data e hora do início do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm.

• periods[0].date_until com a data e hora do final do período de exibição do item no formato YYYY-MM-DDThh:mm:ss±TMZ, onde TMZ é o indicador de fuso horário no formato GMT hh:mm. Para não indicar o final do período de exibição de um item, passe null

Você pode configurar vários períodos para exibir um item na loja. Para fazer isso, no método Obter pedido ou Atualizar item virtual, passe uma matriz de objetos com as datas de início e término de todos os períodos.

Exemplo:

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

Quem pode usar

• Parceiros que desejam configurar a economia do jogo ou monetização adicionando moedas virtuais ao jogo e vendendo itens virtuais com esta moeda.
• Para parceiros que integraram a In-Game Store e desejam configurar um novo tipo de produto – itens virtuais.

Como obtê-lo

Fluxo de integração

1. Configure itens virtuais e grupos de itens virtuais.
2. Configure restrições regionais e preços regionais.

Configure itens virtuais e grupos de itens virtuais

Para configurar itens virtuais, você precisa configurar grupos de itens virtuais. Os grupos permitem que você tenha um catálogo de vários níveis. Os itens que não têm um grupo especificado são adicionados ao grupo Ungrouped.

Para configurar itens virtuais e grupos de itens virtuais, você pode:

• usar a funcionalidade da Conta de Distribuidor
• usar chamadas de API

Configuração via Conta de Distribuidor

Configuração via chamadas de API

A autorização básica é usada para chamadas de API. Passe o Authorization:Basic <your_authorization_basic_key>, onde <your_authorization_basic_key> é o par merchant ID:API key codificado de acordo com o padrão Base64. Vá para a Conta de Distribuidor para encontrar estes parâmetros:

• O Merchant ID é exibido:
  • Na seção Company settings > Company.
  • No URL na barra de endereços do navegador em qualquer página da Conta de Distribuidor. O URL tem o seguinte formato: https:​//publisher.xsolla.com/<merchant ID>/<Publisher Account section>.

• A API key é mostrada na Conta de Distribuidor apenas uma vez, durante a criação, e deve ser armazenada por você. Você pode criar uma nova chave na seguinte seção:
  • Company settings > API keys
  • Project settings > API keys

Use chamadas de API da subseção Catalog do grupo Virtual Items & Currency para obter o catálogo de itens virtuais no lado do cliente. Essas chamadas não exigem autorização básica.

Use a chamada de API Get virtual items list para obter a lista completa de itens não divididos em grupos. Para obter a lista de itens do grupo definido, passe o parâmetro external_id para a chamada Get items list by specified group.

Configure restrições regionais e preços regionais

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Para configurar preços regionais para itens virtuais, passe uma matriz de objetos com configurações de preços regionais para as chamadas Create item ou Update item.

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]