> ## 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.

# Visão geral do Economy v2

> Explore a arquitetura do PlayFab Economy v2, incluindo transações idempotentes, operações em lote, catálogos grandes e suporte a inventário para títulos de alta escala.

<Info>
  O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o [Fórum do PlayFab](https://community.playfab.com).
</Info>

O Economy v2 é uma grande mudança em relação ao pacote de recursos de monetização existente do PlayFab. O objetivo da mudança é oferecer suporte a títulos com centenas de milhões de jogadores ativos, grandes sistemas de progressão e inventários gigantes. A arquitetura foi reconstruída do zero na moderna pilha do Azure. Ela atende às necessidades dos desenvolvedores relacionadas aos recursos a seguir.

* Transações idempotentes
* Operações em lote
* Tratamento de altas taxas de [simultaneidade](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/etags), especialmente com interações de inventário
* Catálogo unificado grande (até 20 GB por entidade) de bens do jogo ou conteúdo gerado pelo usuário (UGC), com suporte a várias entidades
* Documentos individuais de itens de catálogo, em vez de todos os itens armazenados em um único documento
* Inventários grandes de jogadores ([milhares de itens](/pt-BR/services/playfab/economy-monetization/economy-v2/limits))
* Integração com as entidades do PlayFab

O Economy v2 foi projetado com a mesma flexibilidade e extensibilidade que você espera de outros serviços do PlayFab. Embora a arquitetura seja nova no PlayFab, ela foi testada na prática e dá suporte a títulos internos da Microsoft, como **Minecraft**, **Sea of Thieves** e **Flight Simulator**.

Quer descobrir por que criamos o Economy v2 e como você pode usar as melhorias no seu título?

<iframe src="https://www.youtube.com/embed/NcvFFgTZ6ek" width="100%" height="400" allowFullScreen frameBorder="0" />

## Qual versão do Economy devo usar?

Use a versão 2. Se você estiver na versão 1, considere atualizar. Embora a Microsoft não esteja preterindo a v1 e vá mantê-la e oferecer suporte a ela para todos os títulos, ela está no modo somente de correção de bugs. Os novos recursos do Economy são desenvolvidos apenas para a versão 2. Para obter mais informações sobre as diferenças entre as duas versões, consulte as [Perguntas frequentes](/pt-BR/services/playfab/economy-monetization/economy-v2/faq).

## Novidades no Economy v2

O Economy v2 apresenta vários novos recursos que não estão disponíveis na v1:

* Interações atualizadas entre o [inventário](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory) e o catálogo permitem que você ofereça suporte a itens exclusivos, itens não exclusivos, pilhas de itens e várias pilhas de itens.
* Você pode carregar e gerenciar [metadados](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties) e conteúdo, incluindo imagens e arquivos, junto com os itens do catálogo.
* Você pode criar [links profundos](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/deep-links) para o conteúdo do jogo usando as configurações do Economy.
* A [pesquisa de catálogo](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/search) personalizável permite configurar exibições personalizadas com marcas e tipos de conteúdo.
* Uma forma simples de [localizar](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/localization) descrições e títulos de itens.
* APIs que dão suporte a [classificações e avaliações de itens](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/ratings) voltadas para PlayerEntity.
* Suporte a fluxo de trabalho personalizado na [criação com estados de rascunho](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/item-status) e em [conjuntos de permissões de políticas para administradores e revisores do catálogo](/pt-BR/services/playfab/economy-monetization/economy-v2/settings). Você pode pré-publicar itens de catálogo com uma data de início futura.
* [Itens de bundle](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/bundles) que você pode vincular a vários itens de marketplaces externos.
* [Coleções de inventário](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/collections) que permitem que um único jogador tenha vários inventários, como por personagem ou por plataforma.
* [Pilhas de inventário](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/stacks) que permitem várias instâncias distintas do mesmo item em um inventário, cada uma com sua própria quantidade e propriedades.
* [TurboLoading](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/turboloading), que carrega um inventário inteiro (até 10.000 itens) em uma única chamada de API compactada para uma inicialização mais rápida.
* [Conteúdo gerado pelo usuário (UGC)](/pt-BR/services/playfab/economy-monetization/economy-v2/ugc/overview), que permite aos jogadores criar, carregar e pesquisar conteúdo moderado usando um pipeline de moderação interno.
* [ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations) agrupa operações de inventário de forma atômica em uma única solicitação. Se qualquer operação falhar, todo o lote será revertido.
* [ETags](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/etags) que fornecem controle de simultaneidade otimista para atualizações de catálogo e inventário, evitando condições de corrida.
* [Prevenção contra fraudes e validação de recibos](/pt-BR/services/playfab/economy-monetization/economy-v2/fraud-prevention) internas nos marketplaces Apple, Google, Steam, Nintendo, PlayStation Store e Microsoft Store.
* [Ofertas direcionadas](/pt-BR/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers) que permitem lojas exclusivas por segmento com preços dinâmicos adaptados a diferentes grupos de jogadores.

## Alterações em relação à v1

Os recursos do Economy que eram restritivos demais para serem úteis não foram incluídos na v2. Para remediar essa limitação, a equipe de produto lançou o Azure Functions como um sucessor aprimorado do CloudScript. A equipe também forneceu documentação no estilo de receitas como ponto de partida para suas próprias implementações personalizadas. Em seguida, a equipe de produto concentrou os esforços no que você disse ser mais importante.

Os recursos da v1 a seguir não estão incluídos como tipos de item nativos no Economy v2. Alguns recursos podem ser parcialmente replicados usando os blocos de construção da v2, enquanto outros exigem lógica personalizada por meio do [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview).

### Com suporte parcial

Você pode obter esses recursos da v1 usando as APIs e os blocos de construção existentes da v2:

* **Conversão de itens**: você pode obter a conversão de itens (crafting) usando a API [ExecuteInventoryOperations](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/execute-inventory-operations), que subtrai atomicamente os itens de entrada e adiciona o resultado em uma única solicitação. Para ver um exemplo, consulte o [tutorial do jogo de crafting](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/craftingGame/game-context).
* **Contêineres (conteúdo fixo)**: você pode implementar contêineres que sempre concedem os mesmos itens usando [bundles e moeda virtual](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/containers-with-fixed-contents). Um token de moeda representa o contêiner, e a compra de um bundle com preço de um token concede o conteúdo.

### Sem suporte

Esses recursos da v1 não têm equivalente nativo na v2 e exigem lógica personalizada (por exemplo, usando o Azure Functions):

* **Trocas**: a v1 fornecia trocas atômicas bidirecionais de itens entre jogadores. A v2 não tem uma API de troca nativa. Implementar trocas entre jogadores exige orquestração personalizada com o [Azure Functions](https://learn.microsoft.com/en-us/azure/azure-functions/functions-overview).
* **Itens limitados**: a v1 dava suporte a itens de catálogo com um suprimento global finito. A v2 exige lógica do lado do servidor para controlar e impor um limite de quantidade global.
* **Tabelas de drop**: a v1 tinha tabelas de loot aleatórias ponderadas internas. A v2 exige lógica de seleção aleatória personalizada usando o Azure Functions. Para ver uma implementação completa, consulte o [tutorial de tabelas de drop e loot aleatório](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/drop-tables-and-randomized-loot).
* **Contêineres (aleatórios)**: os contêineres da v1 combinados com tabelas de drop concediam itens aleatórios ao serem abertos. A v2 exige lógica personalizada para subtrair o contêiner e conceder itens selecionados aleatoriamente. Consulte o [tutorial de tabelas de drop e loot aleatório](/pt-BR/services/playfab/economy-monetization/economy-v2/tutorials/drop-tables-and-randomized-loot).
* **Taxas de recarga**: a v1 permitia itens com contagens de uso que se regeneravam ao longo do tempo. A v2 exige lógica personalizada baseada em tempo para calcular e conceder as quantidades regeneradas.
* **Suporte de lojas para segmentos**: a v1 permitia a vinculação automática entre segmentos de jogadores e lojas. A v2 tem [Lojas](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/stores) e [Segmentos](/pt-BR/services/playfab/player-progression/player-data/player-segments) e dá suporte a [ofertas direcionadas](/pt-BR/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers) com lojas exclusivas por segmento, mas você deve definir a configuração manualmente em vez de usar a atribuição automática.

## Confira também

* [Início rápido](/pt-BR/services/playfab/economy-monetization/economy-v2/quickstart)
* [Configurações](/pt-BR/services/playfab/economy-monetization/economy-v2/settings)
* [Lojas](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [Inventário](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory)
* [Integrações com marketplaces](/pt-BR/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview)
* [Prevenção contra fraudes](/pt-BR/services/playfab/economy-monetization/economy-v2/fraud-prevention)
* [TurboLoading](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/turboloading)
* [Limites](/pt-BR/services/playfab/economy-monetization/economy-v2/limits)
* [Perguntas frequentes](/pt-BR/services/playfab/economy-monetization/economy-v2/faq)


## Related topics

- [Visão geral do catálogo](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/catalog-overview.md)
- [Visão geral das configurações do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/settings.md)
- [Ofertas direcionadas do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)
- [Ações de segmento do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/segment-actions.md)
- [TurboLoading do Economy V2](/pt-BR/services/playfab/economy-monetization/economy-v2/inventory/turboloading.md)