Integración con PlayFab

Cómo funciona

• Importar un catálogo de PlayFab a Shop Builder para utilizar soluciones de Xsolla.
• Transferencia automática de artículos que un usuario compra a través de Shop Builder 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 Shop Builder

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

Para importar un catálogo de artículos desde PlayFab:

1. Abra su Cuenta del editor y vaya a Items catalog > External connectors > PlayFab.
2. En la pestaña Item import especifique:
   • Title ID: ID de proyecto en PlayFab.
   • Secret key: la clave del proyecto en PlayFab.
3. Haga clic en Save.
4. Sincronice el inventario de usuarios con PlayFab (opcional):
   1. Vaya a Inventory synchronization y especifique:
      • Title ID: ID de proyecto en PlayFab.
      • Secret key: la clave del proyecto en PlayFab.
   2. Active la opción Synchronize user inventory with PlayFab.
   3. Haga clic en Save.
5. Vaya a la pestaña Item import y haga clic en Start import. 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 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 verificar si la importación se realizó correctamente, vaya a la sección Items catalog > Virtual currency, Items catalog > Virtual items o Items catalog > Bundles en el menú lateral y asegúrese de que los artículos, la moneda y los lotes estén habilitados.

Reimportar el catálogo

Al volver a importar el catálogo, tenga en cuenta lo siguiente:

• Se actualizarán los artículos que ya estén en el Catálogo de artículos.
• Se añadirán los artículos que no estén disponibles en el Catálogo de artículos.
• Los artículos que ya hayan sido retirados de la fuente de importación permanecerán en el Catálogo de artículos. 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 Shop Builder 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 Items catalog > External connectors > PlayFab.
2. Vaya a Inventory synchronization y especifique:
   • Title ID: ID de juego único en PlayFab.
   • Secret key: la clave del proyecto en PlayFab.
3. Active la opción Synchronize user inventory with PlayFab.
4. Haga clic en Save.

Ahora la información sobre los artículos comprados en el Shop Builder se transfiere automáticamente a PlayFab.