Preços em dinheiro real

O Economy v2 agora está em disponibilidade geral. Para obter suporte e enviar comentários, acesse o Fórum do PlayFab.

Os preços em dinheiro real permitem associar valores em moeda do mundo real a itens do catálogo por marketplace. A propriedade RealMoneyPriceDetails em um item do catálogo contém dicionários de preços separados para cada marketplace com suporte. Esses dados são usados pelo PlayFab para acompanhar a receita de transações de marketplace.

Visão geral

Quando os jogadores compram itens por meio de marketplaces externos (Apple App Store, Google Play, Steam, Microsoft Store, Nintendo eShop, PlayStation Store), a transação envolve dinheiro real. Ao definir RealMoneyPriceDetails nos itens do seu catálogo, o PlayFab pode:

Acompanhar a receita de resgates de marketplace no evento marketplace_transaction_redeemed.

Formato

RealMoneyPriceDetails é um objeto com um dicionário de preços separado para cada marketplace com suporte:

Propriedade	Tipo	Descrição
`AppleAppStorePrices`	`Dictionary<string, int>`	O valor do preço na Apple App Store por código de moeda.
`GooglePlayPrices`	`Dictionary<string, int>`	O valor do preço no Google Play por código de moeda.
`MicrosoftStorePrices`	`Dictionary<string, int>`	O valor do preço na Microsoft Store por código de moeda.
`NintendoEShopPrices`	`Dictionary<string, int>`	O valor do preço na Nintendo eShop por código de moeda.
`PlayStationStorePrices`	`Dictionary<string, int>`	O valor do preço na PlayStation Store por código de moeda.
`SteamPrices`	`Dictionary<string, int>`	O valor do preço na Steam por código de moeda.

Cada dicionário mapeia um código de moeda ISO 4217 de três letras para um preço na menor unidade da moeda (por exemplo, centavos para USD).

Atualmente, apenas o dólar americano (USD) tem suporte como código de moeda.

Você só precisa preencher as propriedades de marketplace relevantes para o seu título. Por exemplo, se o seu jogo estiver apenas no Google Play e na Apple App Store, você só precisa definir GooglePlayPrices e AppleAppStorePrices.

Exemplos de preços

Preço no mundo real	Valor do dicionário
$0.99 USD	`{"USD": 99}`
$1.39 USD	`{"USD": 139}`
$4.99 USD	`{"USD": 499}`
$9.99 USD	`{"USD": 999}`

Definir preços em dinheiro real em um item do catálogo

Os preços em dinheiro real normalmente são definidos em pacotes vinculados a produtos de marketplaces externos por meio de AlternateIds. Quando um jogador resgata uma compra de marketplace, o PlayFab usa o valor de RealMoneyPriceDetails do pacote correspondente no catálogo para registrar a receita.

API

Você pode definir RealMoneyPriceDetails ao criar ou atualizar um item do catálogo usando CreateDraftItem ou UpdateDraftItem:

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

Você também pode definir preços diferentes por marketplace se os seus preços variarem entre as lojas:

"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "MicrosoftStorePrices": {
    "USD": 499
  }
}

Game Manager

Navegue até Economy > Catalog (V2).
Na guia Bundles, selecione o pacote que você deseja editar ou crie um novo.
Na seção Prices, configure o preço em dinheiro real para cada marketplace.
Na seção Marketplace Mapping, vincule o pacote aos seus produtos de marketplaces externos.

Como os preços em dinheiro real aparecem nos eventos

Quando uma transação de marketplace é resgatada, o preço do marketplace correspondente é incluído no evento marketplace_transaction_redeemed como RealMoneyPrices. Por exemplo, um resgate no Google Play:

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

Esses dados de evento podem então ser usados para:

Consultas de análise personalizadas por meio do Insights Explorer

Práticas recomendadas

Sempre defina RealMoneyPriceDetails nos pacotes de marketplace. Isso garante um acompanhamento preciso da receita e das análises.
Use a menor unidade da moeda. Para USD, forneça o preço em centavos (por exemplo, 499 para $4.99).
Preencha apenas 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 seus anúncios nos marketplaces. 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.

XBOX Services

PlayFab

Preços em dinheiro real do Economy v2

Preços em dinheiro real

Visão geral

Formato

Exemplos de preços

Definir preços em dinheiro real em um item do catálogo

API

Game Manager

Como os preços em dinheiro real aparecem nos eventos

Práticas recomendadas

Consulte também

​Preços em dinheiro real

​Visão geral

​Formato

​Exemplos de preços

​Definir preços em dinheiro real em um item do catálogo

​API

​Game Manager

​Como os preços em dinheiro real aparecem nos eventos

​Práticas recomendadas

​Consulte também

Preços em dinheiro real

Visão geral

Formato

Exemplos de preços

Definir preços em dinheiro real em um item do catálogo

API

Game Manager

Como os preços em dinheiro real aparecem nos eventos

Práticas recomendadas

Consulte também