For the complete documentation index, see llms.txt. This page is also available as Markdown.

Productos dentro del juego

Los consumibles y los pases de juego se crean de manera similar, ¡pero tienen casos de uso ligeramente distintos!

Tipos de producto

Pases de juego

Usa los pases de juego para compras únicas persistentes:

  • Desbloquear pases de administrador

  • Potenciadores/habilidades permanentes

  • Comprar casas

Consumibles

Usa consumibles para productos que quieras que la gente pueda comprar varias veces:

  • Pociones de salud

  • Beneficios que caducan con el tiempo

  • Compras únicas de monedas dentro del juego

Crear productos

Add Product form in the Monetization tab
Para crear un producto, haz clic en el botón "+ Add Product" de la pestaña Monetization del Portal del Creador de tu juego
Product form with the consumable option clear
Si la casilla de consumible no está marcada, esto será un "pase de juego"

Entender la lista de productos

Products list with sales, revenue estimate, ID, and grant failures

La lista de productos muestra los nombres de todos tus productos junto con algunos elementos útiles:

  • La cantidad de chispas gastadas (y el número total de ventas al pasar el cursor sobre el icono ?)

  • Una estimación de la cantidad de ingresos generada por cada uno

  • El ID del producto (puedes hacer clic para copiarlo a colócalo en el código de tu juego para comprar)

  • El número de "fallos de concesión"

Manejadores de compra / fallos de concesión

Cuando un usuario compra un producto en tu juego, ejecutamos la ao_purchase_handler función que has definido en el código de tu juego.

Tu manejador de compra normalmente otorgará un objeto o función a un jugador según el ID de producto que haya comprado. Devuelve true solo después de que la concesión se complete con éxito.

Si tu manejador de compra falla —por ejemplo, si su inventario estaba lleno y no manejaste ese escenario— devuelve false. Contará como un "fallo de concesión" y se mostrará en la página de Productos del Creator Portal para que puedas solucionar el problema.

Los fallos de concesión serán reintentados automáticamente cada vez que el jugador entre hasta que tengan éxito. Los manejadores deben poder ejecutarse de nuevo de forma segura y no deben conceder parcialmente una recompensa antes de devolver false.

Si tu manejador de compra tuvo éxito, pero por alguna razón el usuario perdió el objeto debido a un error del juego o por otro motivo, puedes volver a ejecutar el manejador de compra para ese usuario marcando la compra como no concedida en la Editar/ver datos del jugador sección "Purchases". Confirma primero que volver a ejecutar el manejador no duplicará la recompensa.

Última actualización