Kits SDK para Unity / Artículos gratuitos
  Volver a Documentos

Kits SDK para Unity

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:

  1. Añada artículos gratuitos al catálogo.
  2. Implemente la lógica de realización de pedidos de artículos gratuitos por parte de los usuarios.
  3. 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:

Pedir un artículo gratuito con un solo clic

Para implementar esta opción, haga una llamada al método del SDK PurchaseFreeItem cuando un usuario pulse 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 contiene artículos de pago y gratuitos, llame al método Purchase del SDK de la clase Cart. Este método encapsula métodos para crear un pedido, abrir una interfaz de pago y hacer un seguimiento del estado del pedido.

  • Si la cesta contiene solo artículos gratuitos, llame al método del SDK PurchaseFreeCart de la clase Cart. La entrega de artículos al inventario del usuario por parte de Xsolla se produce inmediatamente después de una solicitud admitida a este método (sin necesidad de abrir Pay Station).

Concesión de artículos gratuitos al usuario

Los métodos Purchase, PurchaseFreeItem y PurchaseFreeCart contienen la lógica para hacer el seguimiento del estado del pedido. Cuando llame a estos métodos, transmita una función que sea llamada cuando el pedido pase al estado done en el parámetro onSuccess. Actualice el inventario en el lado cliente de la aplicación utilizando una de las siguientes opciones:

Nota
Si ha configurado el servidor de su aplicación para manejar los webhooks de Xsolla, puede actualizar los datos en el lado cliente de su aplicación cuando se reciba el webhook order_paid.
¿Te ha resultado útil este artículo?
¡Gracias!
¿Hay algo en lo que podamos mejorar? Mensaje
Lo sentimos
Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
¡Gracias por tu mensaje!
Nos ayudará a mejorar tu experiencia.
Valore esta página
Valore esta página
¿Hay algo en lo que podamos mejorar?

Prefiero no responder

¡Gracias por tu mensaje!

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.

Informar de un problema
Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
Déjanos tu correo electrónico para que te podamos responder
¡Gracias por tu mensaje!