Seguimiento de precios en dinero real en Economy v2

​

Requisitos previos

• Una cuenta de desarrollador de PlayFab.
• Un título creado en Game Manager.
• Una integración de marketplace ya configurada (por ejemplo, Google, Apple o Microsoft Store).
• Un lote publicado con una asignación de marketplace que lo vincule a un producto del marketplace.

​

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

​

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

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

​

Precios diferentes por marketplace

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

​

Paso 2: El jugador realiza una compra y la canjea

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

​

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

{
  "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
  }
}

​

Consulta de los datos de ingresos

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

​

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
• Lotes de Economy v2
• Inicio rápido de prevención del fraude
• Integraciones de marketplace
• Evento marketplace_transaction_redeemed