> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido do Economy (Legado)

> Início rápido do Economy Legado do PlayFab (v1) abordando a configuração inicial do catálogo, a configuração de moeda virtual e a criação básica de itens e lojas.

# Início rápido (Economy Legado)

<Info>
  As APIs do Economy v1 estão em modo de manutenção e não receberão novos recursos, apenas correções de bugs. **As APIs v1 serão mantidas no futuro próximo.** Consulte a [Visão geral do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/overview) para saber mais sobre a próxima versão do PlayFab Economy!
</Info>

Fazer a monetização funcionar é um dos maiores desafios nos jogos. O PlayFab simplifica essa experiência com base em três peças fundamentais: moedas, itens e inventário.

Neste início rápido, você vai:

1. Configurar uma moeda virtual.
2. Criar um item.
3. Adicionar um item ao inventário de um jogador.
4. Conhecer as próximas etapas para personalizar sua economia.

## Configurar uma moeda virtual

As moedas virtuais são a base das economias dos jogos. Jogadores e personagens podem receber essas moedas, que podem então ser usadas para comprar ou negociar itens.

Os itens podem ter um custo em moeda virtual ou em dinheiro real. Cada título pode oferecer suporte a várias moedas virtuais arbitrárias, dando flexibilidade para o seu jogo implementar qualquer meio de troca (por exemplo, ouro, gemas, corações ou créditos interestelares).

Para criar uma moeda virtual:

1. Abra o **Game Manager** e selecione **Economy** na barra lateral esquerda.
2. Selecione a guia **Currency**.
3. Escolha **New Currency** e altere estes campos (conforme mostrado na imagem abaixo):
   * Defina **Currency code (2 uppercase characters)** como **GD**.
   * Defina **Display name** como **Gold**.
4. Selecione **SAVE CURRENCY**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=fcf039d9e16ac42519f73544b6f3a8fd" alt="Criar item" width="1200" height="394" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-currency-new-currency.png" />

Agora que uma moeda foi configurada, os itens do catálogo podem receber preços correspondentes à moeda virtual.

## Criar um item

Muitos jogos oferecem ao jogador itens para compra, como um escudo, um desbloqueio de nível ou um power-up. Esses itens são especificados em um catálogo. Antes que o jogador possa comprar um item de um catálogo, você precisa criar os itens para preenchê-lo.

Para criar um catálogo com um item:

1. Selecione **Economy** na barra lateral esquerda e selecione a guia **Catalogs**.

2. Escolha o botão **NEW CATALOG** e insira **main** como **Catalog version**. Um item com o ID **One** é adicionado automaticamente.

3. Selecione **One** e altere estes campos (conforme mostrado na imagem abaixo):

   * Defina **Item ID** como **apple**.
   * Defina **Display name** como **apple**.
   * Defina **Description** como **Perfectly normal apple**.

4. A seção **PRICES** fica na parte inferior do formulário.

5. Defina o preço da maçã em ouro (**GD**) como **5**.

6. Selecione o botão **SAVE ITEM**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/create-item.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=b07c6dc306edea1d41c9a4d73f5c3915" alt="Editar ou salvar moeda" width="1280" height="1200" data-path="images/playfab/economy-monetization/economy/tutorials/create-item.png" />

## Adicionar um item ao inventário de um jogador

As APIs [Player Item Management (Server)](xref:titleid.playfabapi.com.server.playeritemmanagement) e [Player Item Management (Client)](xref:titleid.playfabapi.com.client.playeritemmanagement) do PlayFab oferecem suporte a muitas estratégias de compra de itens:

* Dinheiro real
* Moeda virtual
* Concessões de itens disparadas pela compra de outro item
* Caixas bloqueadas (com uma chave saqueável/comprável) e desbloqueadas
* Tabelas de resultados aleatórios
* Itens não compráveis que são concedidos com base em eventos pagos ou gratuitos dentro de um jogo
* E mais cenários, especialmente com o [PlayFab CloudScript usando Azure Functions](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript-af)

**Adicione um item ao inventário de um jogador comprando-o com moeda virtual.**

1. No seu jogo, entre como um jogador que recebeu moeda virtual. ([Dar moeda virtual a um jogador](/pt-BR/services/playfab/economy-monetization/economy/items/quickstart#giving-virtual-currency-to-a-player) tem mais informações, se necessário.)

2. Chame [GetCatalogItems](xref:titleid.playfabapi.com.client.title-widedatamanagement.getcatalogitems) com o seguinte parâmetro na solicitação:
   * `CatalogVersion = "main"`

3. Verifique se o `Catalog` no resultado contém uma **apple** com um preço em **GD** de **5**.

4. Chame [PurchaseItem](xref:titleid.playfabapi.com.client.playeritemmanagement.purchaseitem) para comprar a **apple**, com estes valores de parâmetro na solicitação:

   * `CatalogVersion = "main"`
   * `ItemId = "apple"`
   * `VirtualCurrency  = "GD"`
   * `Price =  5`

5. Por fim, chame [GetUserInventory](xref:titleid.playfabapi.com.client.playeritemmanagement.getuserinventory) e observe o resultado desse método. Na matriz de itens do `Inventory` do jogador, você deverá ver uma maçã!

## Próximas etapas para personalizar sua economia

Depois de ter um catálogo com itens suportados por moedas virtuais, você pode dar vida à sua economia com:

* **Compras no mundo real**: nossos tutoriais [Introdução ao PlayFab, Unity IAP e Android](/pt-BR/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android) e [Processamento de pagamentos sem recibo](/pt-BR/services/playfab/economy-monetization/economy/tutorials/non-receipt-payment-processing) ajudam você a conectar sua economia virtual a lojas existentes.
* **Aproveitar seu catálogo**: para criar pacotes, contêineres e tabelas de drop. Para obter mais informações, consulte nosso tutorial [Catálogos](/pt-BR/services/playfab/economy-monetization/economy/items/catalogs).
* **Usar atributos de itens**: para definir vários preços e especificar [Itens](/pt-BR/services/playfab/economy-monetization/economy/items) empilháveis, negociáveis e de edição limitada.
* **Configurar vendedores exclusivos no jogo ou eventos de vendas**: usando [Lojas e vendas](/pt-BR/services/playfab/economy-monetization/economy/tutorials/stores-and-sales).
* **Criar alguns segmentos de jogadores e usar lojas**: para direcionar diferentes ofertas de itens e pacotes aos seus jogadores, independentemente de onde eles estejam no ciclo de vida do seu jogo. Para ver um exemplo, consulte nosso tutorial [Lojas personalizadas para segmentos de jogadores](/pt-BR/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments).
* **Coletar dados econômicos**: permitindo que você melhore e itere seu jogo usando os [Relatórios](/pt-BR/services/playfab/data-analytics/learn-data/reports/overview) do PlayFab.


## Related topics

- [Início rápido de lojas (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/stores/quickstart.md)
- [Início rápido de itens (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Início rápido](/pt-BR/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Itens (Economy Legado)](/pt-BR/services/playfab/economy-monetization/economy/items/index.md)
- [Início rápido do inventário do jogador](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)
