Monnaies virtuelles
Démarrage rapide
Configurez une monnaie virtuelle de bout en bout : créez une monnaie en jetons, accordez des jetons avec un abonnement et dépensez-les via l'API côté serveur.
Créer une monnaie virtuelle
Créez une monnaie virtuelle dans Adapty, liez-la à des produits pour que les achats accordent des crédits, et définissez si ces crédits expirent.
Accorder un solde initial
Donnez aux nouveaux utilisateurs un solde de départ en devise virtuelle via l'API côté serveur, et rétroalimentez les utilisateurs existants lors du lancement d'une nouvelle devise.
Solde de monnaie virtuelle
Consultez les soldes de devises virtuelles d'un utilisateur sur son profil et examinez chaque changement de solde dans l'historique des événements.
Accordez à vos utilisateurs une monnaie virtuelle — tokens IA, crédits ou pièces — lorsqu’ils achètent des produits ou renouvellent des abonnements. Définissez une monnaie une seule fois, associez-la aux produits qui doivent la distribuer, et Adapty crédite chaque utilisateur automatiquement en tenant à jour son solde. Votre application lit et dépense ce solde via l’API côté serveur — par exemple, pour facturer des tokens par génération.
Comment ça fonctionne
- Créer une devise virtuelle : Ouvrez Products et cliquez sur l’onglet Virtual currency. Cliquez sur New virtual currency. Définissez une devise avec un code, un nom et une description facultative.
- Associer la devise à des produits : Reliez la devise à des produits à achat unique ou par abonnement, et définissez le nombre de crédits accordés pour chaque achat.
- Les crédits sont accordés automatiquement : Lorsqu’un utilisateur achète un produit à achat unique associé ou renouvelle un abonnement associé, Adapty ajoute les crédits configurés à son solde.
- Lire et dépenser le solde : Votre application lit le solde de chaque utilisateur et accorde ou dépense des crédits via l’API côté serveur. Utilisez la même API pour accorder un solde initial aux utilisateurs qui n’ont encore rien acheté.
- Suivre chaque modification : Chaque changement de solde est répertorié dans le profil de l’utilisateur.
Pour un guide complet — de la configuration de la devise à l’utilisation des crédits via l’API — suivez le guide de démarrage rapide sur la monnaie virtuelle.
Cas d’usage
| Type d’application | Comment utiliser les monnaies virtuelles |
|---|---|
| Applications IA (génération d’images, de vidéos ou de texte) | Facturer des crédits par génération. Inclure un quota mensuel de crédits dans l’abonnement et vendre des packs de crédits en tant que produits à achat unique. |
| Applications de courtes séries et de vidéos | Facturer des pièces pour déverrouiller un épisode. Accorder aux abonnés un quota récurrent de pièces et vendre des packs de pièces en tant que produits à achat unique. |
| Apprentissage des langues et éducation | Donner aux utilisateurs gratuits un quota limité de cœurs ou de vies via l’API côté serveur. Accorder un quota plus important, ou ignorer entièrement la vérification du solde, avec un abonnement payant. |
| Jeux mobiles | Utiliser deux monnaies en parallèle (souple et forte) : accorder de l’or pour les parties via l’API côté serveur, vendre des gemmes contre de l’argent et convertir entre les deux dans une transaction atomique unique. |
| Applications de productivité | Mesurer les actions coûteuses, comme l’OCR ou les exports, avec des crédits. Donner aux utilisateurs gratuits un petit quota, en accorder davantage avec un abonnement, et vendre des packs de crédits pour les traitements en lot. |
Pour les allocations d’abonnement, activez l’expiration des crédits. Quand les crédits inutilisés sont réinitialisés à chaque renouvellement, l’allocation reste une raison de conserver l’abonnement, et les utilisateurs intensifs achètent des packs de crédits plutôt que d’épuiser un stock accumulé.
Limitations
- L’accès multi-appareils nécessite une identification : un solde appartient à un seul profil. Un utilisateur anonyme ne conserve son solde que sur l’installation où il l’a gagné ; il est donc perdu en cas de réinstallation ou d’ouverture sur un autre appareil. Identifiez vos utilisateurs pour rendre un solde disponible sur tous les appareils et après chaque réinstallation. Voir Soldes, profils et appareils.
- Côté serveur uniquement : il n’existe pas encore de méthode SDK pour lire ou dépenser un solde, votre application a donc besoin d’un backend. Celui-ci lit les soldes et accorde ou dépense des crédits via l’API côté serveur.
- Jusqu’à 20 devises par application : vous pouvez créer jusqu’à 20 monnaies virtuelles dans une seule application.