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

# Precios en dinero real de Economy v2

> Configure RealMoneyPriceDetails en los artículos del catálogo de PlayFab Economy v2 para establecer precios por marketplace y realizar un seguimiento de los ingresos de Apple, Google y Steam.

# Precios en dinero real

<Info>
  Economy v2 ya está disponible con carácter general. Para obtener soporte técnico y enviar comentarios, vaya al [foro de PlayFab](https://community.playfab.com).
</Info>

Los precios en dinero real le permiten asociar valores de moneda del mundo real a los artículos del catálogo por cada marketplace. La propiedad `RealMoneyPriceDetails` de un artículo del catálogo contiene diccionarios de precios independientes para cada marketplace compatible. PlayFab usa estos datos para realizar un seguimiento de los ingresos de las transacciones de marketplace.

## Información general

Cuando los jugadores compran artículos a través de marketplaces externos (Apple App Store, Google Play, Steam, Microsoft Store, Nintendo eShop, PlayStation Store), la transacción implica dinero del mundo real. Al establecer `RealMoneyPriceDetails` en los artículos de su catálogo, PlayFab puede:

* **Realizar un seguimiento de los ingresos** de los canjes de marketplace en el evento [marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed).

## Formato

`RealMoneyPriceDetails` es un objeto con un diccionario de precios independiente para cada marketplace compatible:

| Propiedad                | Tipo                      | Descripción                                                      |
| :----------------------- | :------------------------ | :--------------------------------------------------------------- |
| `AppleAppStorePrices`    | `Dictionary<string, int>` | El importe del precio de Apple App Store por código de moneda.   |
| `GooglePlayPrices`       | `Dictionary<string, int>` | El importe del precio de Google Play por código de moneda.       |
| `MicrosoftStorePrices`   | `Dictionary<string, int>` | El importe del precio de Microsoft Store por código de moneda.   |
| `NintendoEShopPrices`    | `Dictionary<string, int>` | El importe del precio de Nintendo eShop por código de moneda.    |
| `PlayStationStorePrices` | `Dictionary<string, int>` | El importe del precio de PlayStation Store por código de moneda. |
| `SteamPrices`            | `Dictionary<string, int>` | El importe del precio de Steam por código de moneda.             |

Cada diccionario asigna un código de moneda de tres letras [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) a un precio en la **unidad de moneda más pequeña** (por ejemplo, centavos para USD).

<Note>
  Actualmente solo se admite el **dólar estadounidense (USD)** como código de moneda.
</Note>

Solo necesita rellenar las propiedades de los marketplaces relevantes para su título. Por ejemplo, si su juego solo está en Google Play y Apple App Store, solo necesita establecer `GooglePlayPrices` y `AppleAppStorePrices`.

### Ejemplos de precios

| Precio en el mundo real | Valor del diccionario |
| :---------------------- | :-------------------- |
| \$0.99 USD              | `{"USD": 99}`         |
| \$1.39 USD              | `{"USD": 139}`        |
| \$4.99 USD              | `{"USD": 499}`        |
| \$9.99 USD              | `{"USD": 999}`        |

## Establecimiento de precios en dinero real en un artículo del catálogo

Los precios en dinero real se establecen normalmente en **lotes** vinculados a productos de marketplaces externos mediante `AlternateIds`. Cuando un jugador canjea una compra de marketplace, PlayFab usa el valor de `RealMoneyPriceDetails` del lote del catálogo correspondiente para registrar los ingresos.

### API

Puede establecer `RealMoneyPriceDetails` al crear o actualizar un artículo del catálogo mediante `CreateDraftItem` o `UpdateDraftItem`:

```json theme={null}
{
  "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
}
```

También puede establecer precios diferentes por marketplace si sus precios varían entre tiendas:

```json theme={null}
"RealMoneyPriceDetails": {
  "GooglePlayPrices": {
    "USD": 499
  },
  "AppleAppStorePrices": {
    "USD": 529
  },
  "MicrosoftStorePrices": {
    "USD": 499
  }
}
```

### Game Manager

1. Vaya a **Economy** > **Catalog (V2)**.
2. En la pestaña **Bundles**, seleccione el lote que quiere editar o cree uno nuevo.
3. En la sección **Prices**, configure el precio en dinero real para cada marketplace.
4. En la sección **Marketplace Mapping**, vincule el lote a sus productos de marketplaces externos.

***

## Cómo aparecen los precios en dinero real en los eventos

Cuando se canjea una transacción de marketplace, el precio del marketplace correspondiente se incluye en el evento [marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed) como `RealMoneyPrices`. Por ejemplo, un canje de Google Play:

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

Estos datos de eventos se pueden usar después para:

* Consultas de análisis personalizadas mediante Insights Explorer

## Procedimientos recomendados

* **Establezca siempre `RealMoneyPriceDetails` en los lotes de marketplace.** Esto garantiza un seguimiento de ingresos y análisis precisos.
* **Use la unidad de moneda más pequeña.** Para USD, proporcione el precio en centavos (por ejemplo, `499` para \$4.99).
* **Rellene solo los marketplaces que use.** No necesita establecer precios para todos los marketplaces, solo para aquellos en los que se publica su título.
* **Mantenga los precios sincronizados con sus listados de marketplace.** Cuando actualice los precios en un marketplace externo, actualice la propiedad correspondiente en `RealMoneyPriceDetails` para mantener informes precisos.
* **Establezca precios por marketplace cuando difieran.** Si su juego tiene precios distintos según la tienda, use las propiedades por marketplace para reflejar el precio real en cada plataforma.

## Consulte también

* [Lotes de Economy v2](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [Tiendas](/services/playfab/economy-monetization/economy-v2/catalog/stores)
* [Inicio rápido de prevención de fraude](/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart)
* [Integraciones de marketplace](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/overview)
* [Evento marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed)