Monedas virtuales
Inicio rápido
Configura una moneda virtual de extremo a extremo: crea una moneda de tokens, otorga tokens con una suscripción y gástalos a través de la API del lado del servidor.
Crear moneda virtual
Crea una moneda virtual en Adapty, vincúlala a productos para que las compras otorguen créditos y configura si esos créditos expiran.
Saldo de moneda virtual
Consulta el saldo de monedas virtuales de un usuario en su perfil y revisa cada cambio de saldo en el historial de eventos.
Otorga a tus usuarios moneda virtual — tokens de IA, créditos o monedas — cuando compran productos o renuevan suscripciones. Define una moneda una sola vez, vincúlala a los productos que deben concederla y Adapty acredita a cada usuario automáticamente y mantiene su saldo. Tu aplicación lee y gasta ese saldo a través de la API del lado del servidor — por ejemplo, para cobrar tokens por cada generación.
Cómo funciona
- Crea una moneda virtual: Abre Products y haz clic en la pestaña Virtual currency. Haz clic en New virtual currency. Define una moneda con un código, un nombre y una descripción opcional.
- Vincula la moneda a productos: Asocia la moneda a productos de compra única o suscripción y establece cuántos créditos otorga cada compra.
- Los créditos se conceden automáticamente: Cuando un usuario compra un producto único vinculado o renueva una suscripción vinculada, Adapty añade los créditos configurados a su saldo.
- Lee y gasta el saldo: Tu app lee el saldo de cada usuario y concede o gasta créditos a través de la API de servidor.
- Registra cada cambio: Cada cambio de saldo aparece en el perfil del usuario.
Para un recorrido completo —desde la configuración de la moneda hasta el uso de créditos a través de la API— sigue la guía de inicio rápido de moneda virtual.
Casos de uso
| Tipo de app | Cómo usar las monedas virtuales |
|---|---|
| Apps de IA (generación de imágenes, vídeo o texto) | Cobra créditos por cada generación. Incluye una cuota mensual de créditos en la suscripción y vende paquetes de créditos como productos únicos. |
| Apps de cortometrajes y vídeo | Cobra monedas para desbloquear episodios. Otorga a los suscriptores una cuota recurrente de monedas y vende paquetes de monedas como productos únicos. |
| Aprendizaje de idiomas y educación | Da a los usuarios gratuitos una cuota limitada de corazones o vidas a través de la API del servidor. Otorga una cuota mayor, o elimina la comprobación de saldo, en un plan de pago. |
| Juegos móviles | Gestiona una moneda blanda y una dura en paralelo: otorga oro por el juego a través de la API del servidor, vende gemas por dinero y convierte entre ellas en una única transacción atómica. |
| Apps de productividad | Limita las acciones costosas, como el OCR o las exportaciones, con créditos. Da a los usuarios gratuitos una pequeña cuota, otorga más con una suscripción y vende paquetes de créditos para trabajo en lote. |
Para las asignaciones de suscripción, activa la expiración de créditos. Cuando los créditos no utilizados se reinician en cada renovación, la asignación sigue siendo un motivo para mantener la suscripción, y los usuarios más activos compran paquetes de créditos en lugar de agotar un stock acumulado.
Limitaciones
- El acceso entre dispositivos requiere identificación: Un saldo pertenece a un perfil. Un usuario anónimo mantiene su saldo en el dispositivo donde lo ganó, por lo que debes identificar a los usuarios para que su saldo esté disponible en todos los dispositivos. Consulta Saldos, perfiles y dispositivos.
- Solo en el lado del servidor: Todavía no existe ningún método del SDK para leer o gastar un saldo, por lo que tu app necesita un backend. Este lee los saldos y otorga o gasta créditos a través de la API del lado del servidor.
- Hasta 20 monedas por app: Puedes crear hasta 20 monedas virtuales en una sola app.