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

# Seguimiento de precios en dinero real en Economy v2

> Establezca RealMoneyPriceDetails en los lotes de PlayFab Economy v2 y realice el seguimiento de los ingresos mediante el evento marketplace_transaction_redeemed para los informes de análisis.

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

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 configurar `RealMoneyPriceDetails` en los lotes de su catálogo, PlayFab registra el importe de los ingresos en el evento [marketplace\_transaction\_redeemed](/services/playfab/api-references/events/Inventory/marketplace-transaction-redeemed), lo que le permite crear análisis e informes de ingresos.

Este tutorial le guía por el flujo de un extremo a otro: establecer precios en dinero real en un lote, canjear una compra y ver los datos de ingresos en los eventos.

## Requisitos previos

* Una [cuenta de desarrollador de PlayFab](https://developer.playfab.com/en-us/sign-up).
* Un título creado en [Game Manager](https://developer.playfab.com/).
* Una integración de marketplace ya configurada (por ejemplo, [Google](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/google), [Apple](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/apple) o [Microsoft Store](/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/microsoft)).
* Un lote publicado con una [asignación de marketplace](/services/playfab/economy-monetization/economy-v2/catalog/bundles) que lo vincule a un producto del marketplace.

## Paso 1: Establecer los precios en dinero real en el lote

Agregue `RealMoneyPriceDetails` al lote que está vinculado a su producto del marketplace. Especifique los precios en la **unidad monetaria más pequeña** (por ejemplo, centavos para USD) por marketplace.

### API

Use [UpdateDraftItem](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/update-draft-item) para agregar precios a un lote existente y, después, publicarlo:

```json theme={null}
{
  "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. Vaya a **Economy** > **Catalog (V2)** > **Bundles**.
2. Seleccione el lote que quiera editar.
3. En la sección **Prices**, establezca el precio en dinero real para cada marketplace en el que aparezca el lote.
4. Asegúrese de que la sección **Marketplace Mapping** tiene los AlternateIds correctos para cada marketplace.
5. Seleccione **Save and publish**.

***

### Referencia del formato de precios

Los precios usan la unidad monetaria más pequeña. Actualmente solo se admite **USD**.

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

Establezca precios solo para los marketplaces que use su título. Las propiedades de marketplace compatibles son:

* `AppleAppStorePrices`
* `GooglePlayPrices`
* `MicrosoftStorePrices`
* `NintendoEShopPrices`
* `PlayStationStorePrices`
* `SteamPrices`

### Precios diferentes por marketplace

Si el precio de su juego varía entre las tiendas, establezca cada propiedad de marketplace de forma individual:

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

## Paso 2: El jugador realiza una compra y la canjea

Después de que un jugador compre el artículo en el marketplace externo, su juego llama a la API de canje apropiada:

| Marketplace       | API de canje                                                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Google Play       | [RedeemGooglePlayInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-google-play-inventory-items)              |
| Apple App Store   | [RedeemAppleAppStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-apple-app-store-inventory-items)       |
| Microsoft Store   | [RedeemMicrosoftStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-microsoft-store-inventory-items)      |
| Steam             | [RedeemSteamInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-steam-inventory-items)                         |
| Nintendo eShop    | [RedeemNintendoEShopInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-nintendo-e-shop-inventory-items)       |
| PlayStation Store | [RedeemPlayStationStoreInventoryItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/inventory/redeem-play-station-store-inventory-items) |

Cuando PlayFab procesa el canje:

1. Hace coincidir el recibo del marketplace con el `AlternateId` del lote.
2. Concede el contenido del lote al inventario del jugador.
3. Emite un evento `marketplace_transaction_redeemed` que incluye los `RealMoneyPrices` del lote coincidente.

## Paso 3: Ver los ingresos en los eventos

Después de un canje correcto, se emite el evento `marketplace_transaction_redeemed`, que incluye los datos de precios en dinero real. Puede encontrar este evento en Game Manager o consultarlo mediante la canalización de datos.

### Visualización en Game Manager

1. Vaya a **Data** > **Event History** (en la sección **Analyze**).
2. Busque el nombre de evento `marketplace_transaction_redeemed`.
3. Seleccione un evento para ver sus detalles, incluido el campo `RealMoneyPrices`.

### Ejemplo de carga del evento

Un canje en Google Play del Starter Pack (\$4.99 USD) produce un evento como este:

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

El mismo lote canjeado desde el Apple App Store (con un precio de \$5.29 USD) produce:

```json theme={null}
{
  "RealMoneyPrices": {
    "USD": 529
  }
}
```

PlayFab usa el precio del marketplace específico en el que se produjo el canje.

### Consulta de los datos de ingresos

Puede usar los datos de eventos para análisis personalizados. Por ejemplo, para calcular los ingresos totales durante un período, consulte todos los eventos `marketplace_transaction_redeemed` y sume los valores de `RealMoneyPrices.USD`:

```text theme={null}
Total revenue = Sum of (RealMoneyPrices.USD × Amount) across all events
```

<Note>
  `RealMoneyPrices` refleja lo que configuró en `RealMoneyPriceDetails`, no el importe real cobrado por el marketplace. Mantenga sus precios sincronizados con sus fichas del marketplace para obtener informes precisos.
</Note>

## Procedimientos recomendados

* **Establezca siempre `RealMoneyPriceDetails` en los lotes del marketplace.** Sin él, el campo `RealMoneyPrices` de los eventos de canje queda vacío y pierde la visibilidad de los ingresos.
* **Use la unidad monetaria más pequeña.** Para USD, proporcione el precio en centavos (por ejemplo, `499` para \$4.99).
* **Rellene solo los marketplaces que use.** No es necesario establecer precios para todos los marketplaces, solo para aquellos en los que se publica su título.
* **Mantenga los precios sincronizados con sus fichas del marketplace.** Cuando actualice los precios en un marketplace externo, actualice la propiedad correspondiente en `RealMoneyPriceDetails` para mantener la precisión de los informes.
* **Establezca precios por marketplace cuando difieran.** Si el precio de su juego varía entre las tiendas, use las propiedades por marketplace para reflejar el precio real en cada plataforma.

## Consulte también

* [Referencia de precios en dinero real](/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices)
* [Lotes de Economy v2](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
* [Inicio rápido de prevención del 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)


## Related topics

- [Precios en dinero real de Economy v2](/es/services/playfab/economy-monetization/economy-v2/catalog/real-money-prices.md)
- [Preguntas frecuentes sobre Economy versión 2 (V2)](/es/services/playfab/economy-monetization/economy-v2/faq.md)
- [Tiendas y ventas en Economy (heredado)](/es/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Obtención del valor hasta la fecha (VTD) de un jugador en Economy (heredado)](/es/services/playfab/economy-monetization/economy/tutorials/getting-a-players-vtd.md)
- [Contenedores con contenido fijo en Economy v2](/es/services/playfab/economy-monetization/economy-v2/tutorials/containers-with-fixed-contents.md)
