Cupons e promoções (Legacy Economy)

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 para saber mais sobre a próxima versão do PlayFab Economy!

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, pacotes e contêineres.
Familiaridade com o Game Manager.
Familiaridade com o Inventário do jogador.

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.

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

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.

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.

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

Game Manager - Economy - Editar pacote de catálogo

Vários itens funcionam da mesma forma:

Crie um pacote com vários itens, ou até mesmo Tabelas de drop.
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 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.

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

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.

XBOX Services

PlayFab

Cupons e promoções no Economy (Legacy)

Cupons e promoções (Legacy Economy)

Requisitos

Instruções para gerar e resgatar cupons

Caso de exemplo: cupom de item de inventário

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

Cenários de uso

Práticas recomendadas

​Cupons e promoções (Legacy Economy)

​Requisitos

​Instruções para gerar e resgatar cupons

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

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

​Cenários de uso

​Práticas recomendadas

Cupons e promoções (Legacy Economy)

Requisitos

Instruções para gerar e resgatar cupons

Caso de exemplo: cupom de item de inventário

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

Cenários de uso

Práticas recomendadas