Rastreamento de preços em dinheiro real no Economy v2

​

Pré-requisitos

• Uma conta de desenvolvedor do PlayFab.
• Um título criado no Game Manager.
• Uma integração de marketplace já configurada (por exemplo, Google, Apple ou Microsoft Store).
• Um pacote publicado com um Mapeamento de Marketplace vinculando-o a um produto do marketplace.

​

Etapa 1: Definir preços em dinheiro real no seu pacote

​

API

{
  "Item": {
    "Id": "{{StarterPackBundleID}}",
    "Type": "bundle",
    "Title": {
      "NEUTRAL": "Starter Pack"
    },
    "ItemReferences": [
      {
        "Id": "{{LaserSwordID}}",
        "Amount": 1
      },
      {
        "Id": "{{GoldCurrencyID}}",
        "Amount": 500
      }
    ],
    "RealMoneyPriceDetails": {
      "GooglePlayPrices": {
        "USD": 499
      },
      "AppleAppStorePrices": {
        "USD": 499
      },
      "MicrosoftStorePrices": {
        "USD": 499
      }
    },
    "AlternateIds": [
      {
        "Type": "GooglePlay",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "AppleAppStore",
        "Value": "com.mygame.starterpack"
      },
      {
        "Type": "MicrosoftStore",
        "Value": "9NBLGGH42CFD"
      }
    ]
  },
  "Publish": true
}

​

Game Manager

1. Vá para Economy > Catalog (V2) > Bundles.
2. Selecione o pacote a ser editado.
3. Na seção Prices, defina o preço em dinheiro real para cada marketplace em que o pacote aparece.
4. Verifique se a seção Marketplace Mapping tem os AlternateIds corretos para cada marketplace.
5. Selecione Save and publish.

​

Referência de formato de preço

• AppleAppStorePrices
• GooglePlayPrices
• MicrosoftStorePrices
• NintendoEShopPrices
• PlayStationStorePrices
• SteamPrices

​

Preços diferentes por marketplace

"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "SteamPrices": {
    "USD": 449
  }
}

​

Etapa 2: O jogador faz uma compra e resgata

1. Associa o recibo do marketplace ao AlternateId do pacote.
2. Concede o conteúdo do pacote ao inventário do jogador.
3. Emite um evento marketplace_transaction_redeemed que inclui os RealMoneyPrices do pacote correspondente.

​

Etapa 3: Visualizar a receita nos eventos

​

Visualizar no Game Manager

1. Vá para Data > Event History (na seção Analyze).
2. Pesquise o nome do evento marketplace_transaction_redeemed.
3. Selecione um evento para ver seus detalhes, incluindo o campo RealMoneyPrices.

​

Exemplo de conteúdo do evento

{
  "EventName": "marketplace_transaction_redeemed",
  "Marketplace": "GooglePlay",
  "MarketplaceTransctionId": "GPA.1234-5678-9012-34567",
  "MarketplaceAlternateId": "com.mygame.starterpack",
  "Amount": 1,
  "ItemId": "{{StarterPackBundleID}}",
  "ItemType": "bundle",
  "RealMoneyPrices": {
    "USD": 499
  }
}

{
  "RealMoneyPrices": {
    "USD": 529
  }
}

​

Consultar dados de receita

Total revenue = Sum of (RealMoneyPrices.USD × Amount) across all events

​

Práticas recomendadas

• Sempre defina RealMoneyPriceDetails nos pacotes de marketplace. Sem isso, o campo RealMoneyPrices nos eventos de resgate fica vazio e você perde a visibilidade da receita.
• Use a menor unidade monetária. Para USD, informe o preço em centavos (por exemplo, 499 para $4.99).
• Preencha somente os marketplaces que você usa. Você não precisa definir preços para todos os marketplaces, apenas para aqueles em que seu título está publicado.
• Mantenha os preços sincronizados com suas listagens no marketplace. Ao atualizar preços em um marketplace externo, atualize a propriedade correspondente em RealMoneyPriceDetails para manter relatórios precisos.
• Defina preços por marketplace quando eles forem diferentes. Se o seu jogo tiver preços diferentes entre as lojas, use as propriedades por marketplace para refletir o preço real em cada plataforma.

​

Confira também

• Referência de preços em dinheiro real
• Pacotes do Economy v2
• Início rápido de prevenção de fraudes
• Integrações de marketplace
• Evento marketplace_transaction_redeemed