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 e acesse a seção Items catalog > Virtual currency.
2. Selecione Nova moeda virtual.
3. Especifique:
   • Imagem (opcional).
   • SKU.
   • Nome.
   • Preço em moeda real ou virtual.
   • Moeda padrão.
   • Atributos (opcional).

4. Você pode definir uma moeda virtual como uma moeda premium. Essa moeda é vinculada à plataforma onde a compra é feita e só pode ser vendida com dinheiro real. Para configurar o armazenamento separado de moeda premium para diferentes plataformas, defina a opção Moeda Premium como Ligada.

Configure um pacote de moedas virtuais

Para configurar um pacote de moedas virtuais:

1. Abra seu projeto na Conta de Distribuidor e vá para a seção Items catalog > Virtual Currency > Packages.
2. Selecione Novo Pacote.

3. Especifique:
   • 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).

4. Para limitar o número de vezes que um usuário pode comprar um pacote de moedas virtuais, defina a configuração Limitar a quantidade de vezes que um usuário pode comprar um pacote de moedas virtuais como Ligado e especifique o limite.
5. Para definir um limite de tempo para a exibição do pacote na loja, no campo Exibir item na loja, selecione Período 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 item, marque a caixa Sem data final.
6. Clique em Criar pacote.

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 sua Conta de Distribuidor, vá para a seção Items catalog > Virtual items.
2. Selecione + e selecione Criar grupo na lista suspensa.

3. Especifique os seguintes parâmetros:
   • Código do grupo.
   • Nome do grupo.
4. Se quiser mostrar o grupo em um catálogo, defina a opção Exibir grupo na Loja como Ligada.

5. Clique em Criar grupo.

Para configurar um item virtual:

1. Abra seu projeto na sua Conta de Distribuidor, vá para a seção Items catalog > Virtual items.
2. Selecione + e selecione Criar item na lista suspensa.

3. Especifique:
   • Imagem (opcional).
   • SKU.
   • Um ou vários grupos aos quais o item deve pertencer.
   • Nome.
   • Descrição (opcional).

• Propriedade do item: consumível, não consumível, ou itens de tempo limitado.
• Preços em tempo real ou moedas virtuais.

4. Defina um limite de compra para o item (opcional). Para fazer isso, defina a opção Limitar a quantidade de vezes que um usuário pode comprar este item como Ligado e especifique a quantidade de itens que um usuário pode comprar.
5. Para definir um limite de tempo para a exibição do item na loja, no campo Exibir item na loja, selecione Período 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 item, marque a caixa Sem data final.
6. Clique em Criar item.

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 sua Conta de Distribuidor, vá para a seção Items catalog > Bundles.
2. Selecione + e selecione Criar conjunto na lista suspensa.

3. Especifique:
   • Imagem (opcional).
   • SKU.
   • Nome.
   • Descrição (opcional).
   • Conteúdos.
4. Prepare o preço do conjunto. Defina os preços ou crie um conjunto grátis:
   1. Para criar um conjunto grátis, no campo Pago ou Grátis, selecione o Conjunto grátis.
   2. Para definir um preço, no campo Pago ou Grátis, selecione conjunto Pago e especifique o preço em moedas reais ou virtuais. Se necessário, configure preços regionais.

5. Defina um limite de compra para o conjunto (opcional). Para fazer isso, defina a opção Limiter número de vezes que um usuário pode comprar o conjunto como Ligada e especifique a quantidade de conjuntos que cada usuário pode comprar.
6. Clique em Avançar.
7. Configure a exibição do conjunto na loja:
   • Mude o status para Disponível.
   • Defina um limite de tempo para exibir um conjunto na loja (opcional). Para fazer isso, selecione Período e especifique o fuso horário, o começo e o fim do período. Se você não quiser indicar o fim do período de exibição, marque a caixa Nenhuma data final.
8. Clique em Avançar.
9. Confira as configurações e clique em Salvar.

Você pode automatizar a criação e atualização do catálogo com as chamadas da API Shop Builder. Com a automação, você pode manter seu catálogo atualizado sem gastar muito tempo com ele. A automação de catálogos permite criar e atualizar itens e promoções e importar dados de sistemas externos.

A autorização básica é usada para chamadas de API para criar e atualizar itens e promoções. 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>/.

• 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

Para criar itens via API:

1. Exporte os dados do item do seu sistema.
2. Transforme os dados exportados em um formato que corresponda à chamada API do tipo de item necessário.
3. Crie um script que chama o método API necessário para cada item na exportação:
   • Obter pedido
   • Criar moeda virtual
   • Criar pacote de moedas virtuais
   • Criar conjunto

Se você quiser usar grupos de itens, crie-os antecipadamente pela Conta de Distribuidor.

1. Abra seu projeto na Conta de Distribuidor e, na seção Items catalog, acesse o tipo correspondente de item que deseja configurar:
   • Moeda virtual
   • Itens virtuais
   • Chaves de jogo
   • Conjuntos
2. Na lista suspensa Manage catalog, selecione Import items (JSON).

3. Escolha uma ação:
   • Add new items — apenas itens com SKUs novos serão adicionados.
   • Add new items and update existing ones — itens com SKUs novos serão adicionados e os dados de itens existentes serão atualizados.
   • Add new, update existing, disable missing items — itens com SKUs do arquivo serão adicionados/atualizados. Se houver um item no catálogo, mas não houver tal SKU no arquivo, o status do item na Conta de Distribuidor será alterado para Partially available — o item não pode ser comprado separadamente, mas está disponível como parte de um conjunto ou bônus.

4. Preencha o arquivo para importação:
   • Baixe o modelo de arquivo na janela de download e preencha-o de acordo com o exemplo abaixo.
   • Exporte os itens e use o arquivo exportado como modelo.
   • Crie seu próprio arquivo JSON e preencha-o de acordo com o exemplo abaixo.

Um exemplo de um arquivo JSON completo:

  1{
  2    "virtual_currency": [
  3        {
  4            "sku": "Gem_test_import",
  5            "name": {
  6                "en": "Gem_test_import"
  7            },
  8            "type": "virtual_currency",
  9            "description": {
 10                "en": "my test imported currency"
 11            },
 12            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
 13            "description": {
 14                "en": "my test imported currency",
 15                "de": "meine importierte Testwährung"
 16            },
 17            "attributes": [],
 18            "is_free": false,
 19            "order": 1,
 20            "groups": [],
 21            "regional_prices": [],
 22            "prices": [
 23                {
 24                    "amount": 2,
 25                    "currency": "USD",
 26                    "is_default": true,
 27                    "is_enabled": true
 28                }
 29            ],
 30            "media_list": [],
 31            "vc_prices": [],
 32            "is_enabled": true,
 33            "is_show_in_store": true,
 34            "regions": [],
 35            "limits": {
 36                "per_user": null,
 37                "per_item": null,
 38                "recurrent_schedule": null
 39            },
 40            "periods": [],
 41            "inventory_options": {
 42                "consumable": true,
 43                "expiration_period": null
 44            },
 45            "is_hard": false
 46        }
 47    ],
 48    "virtual_items": [
 49        {
 50            "sku": "event_access_test_import",
 51            "name": {
 52                "en": "Special Event Access_test_import"
 53            },
 54            "type": "virtual_good",
 55            "description": {
 56                "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
 57            },
 58            "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
 59            "long_description": null,
 60            "attributes": [],
 61            "is_free": false,
 62            "order": 1,
 63            "groups": [
 64                "my_test_group"
 65            ],
 66            "regional_prices": [],
 67            "prices": [
 68                {
 69                    "amount": 35,
 70                    "currency": "USD",
 71                    "is_default": true,
 72                    "is_enabled": true
 73                }
 74            ],
 75            "media_list": [],
 76            "vc_prices": [],
 77            "is_enabled": true,
 78            "is_show_in_store": true,
 79            "regions": [],
 80            "limits": {
 81                "per_user": null,
 82                "per_item": null,
 83                "recurrent_schedule": null
 84            },
 85            "periods": [],
 86            "inventory_options": {
 87                "consumable": true,
 88                "expiration_period": null
 89            }
 90        }
 91    ],
 92    "virtual_currency_packages": [
 93        {
 94            "item_id": 441982,
 95            "sku": "small_gold_pack_test_import",
 96            "type": "bundle",
 97            "name": {
 98                "en": "Small gold pack"
 99            },
100            "bundle_type": "virtual_currency_package",
101            "description": {
102                "en": "Gold x100"
103            },
104            "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105            "vc_prices": [],
106            "regional_prices": [],
107            "prices": [
108                {
109                    "amount": 5,
110                    "currency": "USD",
111                    "is_default": true,
112                    "is_enabled": true
113                }
114            ],
115            "is_enabled": true,
116            "is_show_in_store": true,
117            "regions": [],
118            "limits": {
119                "per_user": null,
120                "per_item": null,
121                "recurrent_schedule": null
122            },
123            "periods": [],
124            "attributes": [],
125            "long_description": null,
126            "media_list": [],
127            "order": 100000000,
128            "is_free": false,
129            "groups": [],
130            "content": [
131                {
132                    "sku": "Gem_test_import",
133                    "quantity": 100
134                }
135            ]
136        }
137    ],
138    "bundles": [
139        {
140            "item_id": 684024,
141            "sku": "start_pack_test_import_test_import",
142            "type": "bundle",
143            "name": {
144                "en": "Legendary Start Pack"
145            },
146            "bundle_type": "standard",
147            "description": {
148                "en": "Crystal x 1\nGem x 1"
149            },
150            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151            "regional_prices": [],
152            "prices": [
153                {
154                    "amount": 20,
155                    "currency": "USD",
156                    "is_default": true,
157                    "is_enabled": true
158                }
159            ],
160            "virtual_prices": [],
161            "is_enabled": true,
162            "is_show_in_store": true,
163            "regions": [],
164            "limits": {
165                "per_user": null,
166                "per_item": null,
167                "recurrent_schedule": null
168            },
169            "periods": [],
170            "attributes": [],
171            "long_description": null,
172            "media_list": [],
173            "order": 5,
174            "is_free": false,
175            "groups": [
176                "my_test_group"
177            ],
178            "content": [
179                {
180                    "sku": "Gem_test_import",
181                    "quantity": 1
182                },
183                {
184                    "sku": "event_access_test_import",
185                    "quantity": 1
186                }
187            ]
188        }
189    ]
190}

5. Envie o arquivo completo ao campo correspondente na janela de importação.
6. Se houver erros durante a importação, uma lista desses erros e recomendações para a correção deles será exibida na janela de importação. Faça as alterações necessárias ao arquivo e envie-o novamente.

Após um envio bem-sucedido, os itens com os SKUs especificados serão criados, atualizados ou desativados.

Você também pode importar itens usando a chamada de API Import itens via JSON file.

Se você estiver criando um site usando Web Shop ou o modelo Single game page, o bloco é adicionado ao site automaticamente.

Se você estiver criando um site usando outros modelos e quiser adicionar o bloco Store ao site:

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Storefronts > Websites.
2. Selecione Open Site Builder.

3. Clique em Add Block no modelo de site.
4. A partir da lista, selecione o bloco Store.

5. Na lista suspensa, escolha o tipo e grupo do item que você deseja vender no site.

6. Para vender tipos de itens diferentes, adicione seções da loja. Para fazer isso, no menu do bloco Store, clique em Add Store Section.
7. Para vender itens em diferentes partes do site, adicione blocos Store adicionais.

Você pode adicionar um botão de compra rápida de itens em qualquer modelo dentro dos seguintes blocos:

• Card grid
• Header
• Call-to-action
• Game editions
• Promo Slider

No modelo Single Game Page, o botão também se encontra no bloco Lead.

Para personalizar o botão:

1. Vá para um dos blocos especificados.
2. Na parte direita do construtor do site, vá para o botão.
3. Na lista suspensa de Action, selecione Purchase Item.
4. Na lista suspensa de Item, escolha o item.