Integración con PlayFab

Cómo funciona

PlayFab brinda a los desarrolladores de juegos soluciones de servidor predefinidas para gestionar el catálogo de artículos y la monetización. Tras la integración con PlayFab, puede:

• Importar un catálogo de PlayFab a la tienda In-Game Store para utilizar soluciones de Xsolla.
• Transferencia automática de artículos que un usuario compra a través de la In-Game Store a PlayFab.

¿Quién puede utilizarlo?

• Socios que integraron PlayFab y ahora quieren ampliar el área de distribución de artículos (moneda virtual y artículos virtuales) a través de las soluciones de Xsolla.
• Socios que integraron soluciones de Xsolla y ahora quieren monetizar sus artículos en PlayFab (vender artículos a cambio de moneda real).

Reglas de importación

Al importar artículos de PlayFab, se aplica la siguiente lógica:

• Los bienes duraderos de PlayFab se importan como artículos virtuales (no moneda virtual ni lotes).
• Todos los artículos, así como los paquetes de moneda virtual y los artículos incluidos en un lote de PlayFab, se importan como consumibles (parámetro consumable = true o no especificado).
• La moneda virtual se importa con el estado Parcialmente disponible y sin un precio especificado (banderas API: is_show_in_store = false, is_enabled = true, is_free = true).
• Un lote que contiene un solo tipo de moneda virtual se importa como un paquete de moneda virtual.
• Un lote que contiene varios tipos de moneda virtual se importa como paquetes de moneda virtual independientes. Para cada combinación de SKU y cantidad, se crea un paquete de moneda virtual libre con el estado Parcialmente disponible (banderas API: is_show_in_store = false, is_enabled = true, is_free = true).
• Un lote que contiene distintos tipos de artículos se importa como un lote.
• Si el campo Descripción de un artículo no se rellena en PlayFab, se utiliza el campo Nombre como descripción del artículo; si no hay Nombre, se utiliza el SKU.

Limitaciones de importación

Limitaciones de la tienda del juego

• Los contenedores y lotes que contengan contenedores no se importarán.
• Los DropTables y lotes que contengan DropTables no se importarán.
• Los parámetros específicos de PlayFab, como isStackable, isTradable, UsageCount, UsagePeriod, UsagePeriodGroup se ignorarán.
• Los artículos consumibles se crearán sin tener en cuenta la cantidad (el artículo desaparece del inventario tras el primer uso).

Limitaciones de PlayFab

• PlayFab no almacena precios en moneda real. Solo se utiliza moneda virtual preconfigurada codificada como RM (Real money), equivalente a moneda real: 1 centavo (100 RM = 1 USD). Por lo tanto, los precios de los artículos solo se pueden establecer en moneda virtual o RM.
• Los SKU de los artículos deben ser únicos y constar de números, letras latinas, guiones y guiones bajos.

Cómo conseguirlo

Importar catálogo desde PlayFab

Si aún no ha configurado PlayFab, haga lo siguiente:

• Cree su cuenta de PlayFab.
• Cree su juego.
• Obtenga su ID único de título de juego.
• Obtenga su clave secreta de PlayFab.

Vaya a Cuenta del editor e exporte el catálogo de artículos desde PlayFab a In-Game Store.

1. Abra su Cuenta del editor y vaya a Store > Catalog management > Integration with external platforms > PlayFab.
2. En la pestaña Importación de artículos especifique:
   • ID de título: ID de proyecto en PlayFab.
   • Clave secreta: la clave del proyecto en PlayFab.
3. Haga clic en Guardar.
4. Sincronice el inventario de usuarios con PlayFab (opcional):
   1. Acceda a Sincronización de inventario y especifique:
      • ID de título: ID de proyecto en PlayFab.
      • Clave secreta: la clave del proyecto en PlayFab.
   2. Active la opción Sincronizar inventario de usuarios con PlayFab.
   3. Haga clic en Guardar.
5. Vaya a la pestaña Importación de artículos y haga clic en Iniciar importación. La importación del catálogo se iniciará automáticamente.
6. Para vender artículos virtuales en la tienda web creada con Site Builder, configure grupos de artículos en la Cuenta del editor y asigne uno o varios de ellos a cada artículo.
7. Para mostrar imágenes de artículos, súbalas a su Cuenta del editor.

Para comprobar si la importación se ha realizado correctamente, vaya a la sección Store del menú lateral y asegúrese de que los artículos, la moneda y los lotes están activados en las pestañas Moneda virtual, Artículos virtuales y Lotes.

Reimportar el catálogo

Al reimportar el catálogo, tenga en cuenta lo siguiente:

• Se actualizarán los artículos que ya estén en Store.
• Se añadirán los artículos que no estén disponibles en Store.
• Los artículos que ya hayan sido retirados de la fuente de importación permanecerán en Store. Puede eliminarlos en su Cuenta del editor o a través de la API.

Añadir artículos al inventario de PlayFab

Puede establecer la adición de artículos comprados en In-Game Store de Xsolla a su inventario de PlayFab de las siguientes maneras:

• Sincronizando el inventario del usuario con PlayFab.
• Integrando el almacenamiento de PlayFab con Xsolla Login. En este caso, el ID de PlayFab especificado en el token. En el caso de una devolución de artículos en el lado de Xsolla, se envía una solicitud a PlayFab en el token.

Si quiere sincronizar el inventario de usuarios con PlayFab:

1. Abra su Cuenta del editor y vaya a Store > Catalog management > Integration with external platforms > PlayFab.
2. Acceda a Sincronización de inventario y especifique:
   • ID de título: ID de juego único en PlayFab.
   • Clave secreta: la clave del proyecto en PlayFab.
3. Active la opción Sincronizar inventario de usuarios con PlayFab.
4. Haga clic en Guardar.

Ahora la información sobre los artículos comprados en la In-Game Store se transfiere automáticamente a PlayFab.

Última actualización: 27 de Diciembre de 2024