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

# Cupons e promoções no Economy (Legacy)

> Gere e resgate cupons do PlayFab Legacy Economy no Game Manager e combine-os com pacotes ou CloudScript para impulsionar promoções no jogo.

# Cupons e promoções (Legacy Economy)

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

Cupons são tokens de cadeia de caracteres que você pode gerar para que seus clientes os usem para resgatar itens de inventário no jogo. Combinados com pacotes ou CloudScript, esses cupons podem ser usados para acionar praticamente qualquer funcionalidade no seu jogo.

## Requisitos

* Familiaridade com [Catálogos](/pt-BR/services/playfab/economy-monetization/economy/items/catalogs), pacotes e contêineres.
* Familiaridade com o [Game Manager](/pt-BR/services/playfab/live-service-management/gamemanager).
* Familiaridade com o [Inventário do jogador](/pt-BR/services/playfab/player-progression/player-data/player-inventory).

## Instruções para gerar e resgatar cupons

Todos os exemplos a seguir compartilham a primeira etapa básica de gerar um cupom. Isso é feito no Game Manager.

No **Game Manager**:

* Navegue até o seu **Título**.
* Selecione **Economy** no menu à esquerda.
* Vá para a guia **Catalogs**.

Em qualquer uma das três seções de guia, **Items**, **Bundles** e **Containers**, há um link **Coupons**.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=01c2a878fe4e703656b294f53ee70c21" alt="Game Manager - Economy - Itens de catálogo - Botão Coupons" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-catalog-items-coupon-button.png" />

O link abre uma janela que permite gerar cupons para qualquer um dos itens da seção. Se você quiser criar cupons para um item específico:

* Selecione **Coupons** na guia **Items**.
* **Coupons** de pacotes em **Bundles** e **Coupons** de contêineres em **Containers**.

A janela pop-up é semelhante à que fornecemos abaixo. (Sua lista de itens deve corresponder ao seu título. Os itens exibidos são descritos em nosso tutorial [Tabelas de drop](/pt-BR/services/playfab/economy-monetization/economy/tutorials/drop-tables)).

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=ca852ef6cb03a6bc62d187fa93dca085" alt="Game Manager - Gerar cupons" width="1053" height="733" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-generate-coupons.png" />

Para concluir a geração de cupons:

* Selecione uma quantidade de **Coupons** a gerar.

* Em seguida, selecione o **Item** que os **Coupons** devem gerar.

* O arquivo de texto **CSV** com a lista de **Coupons** poderá então ser baixado

Selecionar um dos links no exemplo gera os dez **Coupons** separados por vírgula a seguir.

```xml theme={null}
65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz
```

Por fim, o cliente poderá resgatar um cupom se você fornecer uma GUI que permita inserir o código, que então chama [RedeemCoupon](xref:titleid.playfabapi.com.client.playeritemmanagement.redeemcoupon).

```csharp theme={null}
// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}
```

### Caso de exemplo: cupom de item de inventário

A maneira mais simples de usar cupons é presentear um item de inventário. Depois de criar seu catálogo, você pode gerar cupons para itens comuns seguindo as instruções anteriores que já discutimos. Não há outras etapas especiais para esse caso.

### Caso de exemplo: cupom de moeda virtual *ou* cupom de vários itens

Os cupons não podem conceder [Moeda virtual](/pt-BR/services/playfab/economy-monetization/economy/tutorials/currencies) diretamente e só podem conceder um único item.

No entanto, os pacotes podem ser usados para converter itens de inventário de forma transparente em grupos de itens ou em moeda virtual. No exemplo de VC, você deve criar um novo item de pacote com conteúdo de VC.

Defina o pacote para expirar em **15 segundos**. Dessa forma, o jogador verá a VC imediatamente assim que abrir o pacote e não verá o item intermediário.

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=1811ef16679c9be97687ef51cc436fc0" alt="Game Manager - Economy - Editar pacote de catálogo" width="1280" height="1500" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-economy-edit-catalog-bundle.png" />

Vários itens funcionam da mesma forma:

* Crie um pacote com vários itens, ou até mesmo [Tabelas de drop](/pt-BR/services/playfab/economy-monetization/economy/tutorials/drop-tables).
* Defina-o para expirar em **15 segundos**.
* O cupom pode gerar o pacote.
* O pacote é então convertido em vários itens.
* O item de pacote intermediário desaparece.

## Cenários de uso

* Recompensas físicas em convenções:
  * Você pode imprimir sua lista de códigos de cupom e distribuí-los como brindes em convenções.
* Comunicação fora do jogo, como fóruns, [Notificações por push](/pt-BR/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart) e email.
  * Envie códigos de cupom *diretamente* aos seus jogadores, como parte de campanhas de reaquisição ou outras ações de divulgação na comunidade.
* Torneios:
  * Envie cupons aos jogadores mais bem classificados ao usar [Placares redefiníveis](/pt-BR/services/playfab/community/leaderboards/tournaments-leaderboards/using-resettable-statistics-and-leaderboards).

<Note>
  Nesse caso, você também pode distribuir itens de inventário diretamente, então escolha o que for mais relevante para o seu jogo.
</Note>

## Práticas recomendadas

Ao usar o inventário do PlayFab, você deve manter o tamanho dos inventários relativamente pequeno, *menos de 100 itens no total* por jogador. Um pacote que concede *itens demais* pode sofrer limitação ou restrição de taxa.


## Related topics

- [Lojas e promoções no Economy (Legado)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Lojas personalizadas para segmentos de jogadores no Economy (Legacy)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Gerenciar moedas virtuais no Economy (Legacy)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/currencies.md)
- [Tabelas de drop no Economy (Legacy)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Práticas recomendadas para segmentação de lojas no Economy (Legacy)](/pt-BR/services/playfab/economy-monetization/economy/tutorials/best-practices-for-store-segmentation.md)