Artículos gratuitos
Los artículos gratuitos son un tipo de artículo que los usuarios pueden conseguir sin gastar moneda virtual o real. Entre ellos se incluyen:
- Artículos virtuales
- Lotes
- Paquetes de moneda virtual
Los artículos gratuitos solo están disponibles para usuarios autorizados. Los usuarios no autorizados solo pueden ver el catálogo de artículos gratuitos.
Ejemplos de uso:
- Puede regalar artículos gratuitos en fechas importantes para su proyecto (por ejemplo, el día de la fundación del proyecto) para recompensar a los usuarios por su fidelidad.
- Puede regalar paquetes de inicio para el juego en la tienda para atraer a nuevos usuarios al juego.
Puede limitar el obsequio de artículos únicos si el usuario ya los ha recibido.
Para configurar los artículos gratuitos:
- Añada artículos gratuitos al catálogo.
- Implemente la lógica de realización de pedidos de artículos gratuitos por parte de los usuarios.
- Implemente la lógica de concesión de artículos gratuitos al usuario.
Añadir artículos gratuitos al catálogo
Encontrará instrucciones detalladas para crear artículos en las siguientes secciones de la documentación:
Al crear o editar un artículo gratuito, debe seleccionar un Free item, Free package o Free bundle en la sección Paid or Free.
Pedidos de artículos gratuitos por parte del usuario
Un usuario puede pedir un artículo gratis de dos maneras:
- Con un solo clic (sin usar la cesta de la compra): con un código de artículo (SKU), para cualquier cantidad. Por ejemplo, 100 pociones idénticas.
- A través de la cesta de la compra: cualquier tipo de artículo en cualquier cantidad.
Pedir un artículo gratuito con un solo clic
Para implementar esta opción, haga una llamada al método createOrderWithSpecifiedFreeItem
de la biblioteca de Store cuando un usuario haga clic en el botón del catálogo para pedir el artículo gratuito.
La entrega de artículos al inventario del usuario en el lado de Xsolla se produce inmediatamente después de una solicitud realizada correctamente a este método (sin necesidad de abrir Pay Station).
Pedir artículos gratuitos a través de la cesta de la compra
En caso de que el usuario compre a través de una cesta de la compra:
- Si la cesta del usuario contiene artículos de pago y gratuitos:
- Obtenga el token de pago y el ID del pedido mediante el método
createOrderWithCart
de la biblioteca de Store. - Obtenga la URL para abrir la interfaz de pago. Para ello, llame al método
createPaymentUrl
de la biblioteca de Store y transmita el token de pago y el ID del pedido. - Implemente la apertura de la interfaz de pago:
- Obtenga el token de pago y el ID del pedido mediante el método
- Para abrir la interfaz de pago en un navegador externo, llame al método estático
UIApplication.shared.open
y transmítale la URL obtenida en el paso anterior. - Para abrir la interfaz de pago en el navegador integrado, cree una instancia de la clase
PaystationWebView
de la biblioteca de Payments y llame al métodoloadPaystation
. En el proyecto de demostración se proporciona un ejemplo de implementación en la clasePaystationVC
.
- Para abrir la interfaz de pago en un navegador externo, llame al método estático
- Si la cesta del usuario contiene solo artículos gratuitos, llame al método
createOrderWithFreeCart
de la biblioteca de Payments. La entrega de artículos al inventario del usuario en el lado de Xsolla se produce inmediatamente después de una solicitud aceptada a este método (sin necesidad de abrir Pay Station).
Concesión de artículos gratuitos al usuario
Puede hacer un seguimiento del estado de un pedido de artículo gratuito llamando repetidamente al método getOrder
de la biblioteca de Store.
Si el pedido se ha realizado correctamente, utilice métodos del SDK para visualizar el inventario del usuario para actualizar los datos en el lado del cliente de la aplicación.
Enlaces útiles
Última actualización: 22 de Enero de 2024¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.