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.
Otorgar un saldo inicial
Dale a los nuevos usuarios un saldo inicial de moneda virtual mediante la API del servidor, y rellena el saldo de usuarios existentes cuando lances una nueva moneda.
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 suscripciones y define 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 del lado del servidor. Usa la misma API para conceder un saldo inicial a los usuarios que aún no han comprado nada.
- 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 balance pertenece a un perfil. Un usuario anónimo conserva su balance solo en la instalación donde lo obtuvo, por lo que se pierde si reinstala la app o la abre en otro dispositivo. Identifica a los usuarios para que el balance esté disponible en todos los dispositivos y tras cada reinstalación. Consulta Balances, perfiles y dispositivos.
- Solo en el lado del servidor: Todavía no hay ningún método del SDK para leer o gastar un balance, por lo que tu app necesita un backend. Este lee los balances y otorga o gasta créditos a través de la API del lado del servidor.
- Hasta 20 divisas por app: Puedes crear hasta 20 monedas virtuales en una sola app.