Récompenses quotidiennes
Comment ça marche
Les récompenses quotidiennes encouragent les utilisateurs à se connecter chaque jour au magasin pour recevoir des objets gratuits. Vous pouvez créer les types suivants :
- Login reward — récompenses accessibles de manière séquentielle toutes les 24 heures à partir de la première connexion de l’utilisateur.
- Reward calendar — récompenses accessibles chaque jour à la même heure pour tous les utilisateurs. Le calendrier est global et ne dépend pas de la date de la première connexion au magasin.
- Exemple : Si un utilisateur se connecte au magasin pour la première fois le quatrième jour de la promotion, il voit la récompense correspondant au quatrième jour de la chaîne.
Les types d’objets suivants peuvent être utilisés comme récompenses :
- Objets virtuels
- Monnaie virtuelle
- Packages de monnaie virtuelle
- Lots
Les paramètres suivants sont ignorés dans les chaînes de récompenses quotidiennes :
- règles de personnalisation ;
- limites d’achat ;
- disponibilité programmée (date de début/fin) ;
- promotions et remises.
Les récompenses quotidiennes sont organisées en chaînes que les utilisateurs peuvent débloquer consécutivement. Vous pouvez créer des chaînes récurrentes qui redémarrent automatiquement une fois le dernier jour atteint.
Pour garantir le bon fonctionnement du système de récompenses quotidiennes, l’authentification utilisateur doit être activée.
Les utilisateurs non authentifiés peuvent consulter l’ensemble de la chaîne de récompenses quotidiennes, mais ne peuvent pas réclamer de récompenses.
Flux utilisateur
- L’utilisateur visite le magasin.
- L’utilisateur voit la chaîne de récompenses quotidiennes ainsi que la récompense disponible pour la connexion du jour.
- L’utilisateur se connecte.
- L’utilisateur voit sa progression actuelle dans la chaîne de récompenses quotidiennes.
- L’utilisateur réclame la récompense quotidienne.
Configuration dans le Compte éditeur
Avant de créer une chaîne de récompenses quotidiennes, vous devez d’abord créer les objets que les utilisateurs pourront obtenir gratuitement en se connectant au magasin.
Pour créer des objets manuellement dans le projet depuis le Compte éditeur, accédez à la section Items catalog > All items. Pour des informations détaillées sur cette méthode et les autres façons de créer des objets, consultez la section Catalogue des objets de la documentation.
Créer des récompenses quotidiennes
Pour créer des récompenses quotidiennes :
- Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Daily rewards.
- Appuyez sur Create daily rewards.
- Spécifiez les paramètres suivants :
- Indiquez le titre à la chaîne de récompenses quotidiennes.
- Entrez une description (facultatif).
- Appuyez sur Next.
- Ajoutez une récompense pour le jour de la chaîne. Pour ce faire :
- Appuyez sur Add reward.
- Sélectionnez un objet, indiquez la quantité que l'utilisateur recevra en récompense pour cette journée, puis appuyez sur Save.
- Après avoir ajouté les récompenses pour chaque jour, appuyez sur Next.
- Sélectionnez le type de récompenses quotidiennes — Login reward ou Reward calendar. Le type de récompense est défini lors de la création et ne peut être modifié par la suite.
- Indiquez la date et l’heure de début des récompenses quotidiennes.
- Pour le type Login reward, vous pouvez activer la bascule Add time limit et spécifier la date et l’heure de fin de la promotion.
Pour le type Reward calendar, la date de fin se calcule automatiquement en fonction du nombre de jours pour lesquels les récompenses sont créées.
- Pour que la chaîne de récompenses quotidiennes redémarre après sa fin, activez la bascule Make promotion renewable.
- La logique de renouvellement dépend du type de chaîne :
- La chaîne Login reward redémarre après la fin du cycle actuel, tant que la promotion n'est pas terminée.
- Exemple : Une chaîne de 5 récompenses est disponible du 1ᵉʳ au 31 octobre. Si ce paramètre est activé, l'utilisateur peut entamer un nouveau cycle après avoir obtenu les 5 récompenses du cycle en cours ou réinitialisé la progression. Chaque nouveau cycle commence par la première récompense de la chaîne. Plusieurs renouvellements sont possibles jusqu'à la fin de la promotion, le 31 octobre inclus.
- La chaîne Reward calendar se renouvelle pour tous les utilisateurs à intervalles correspondant à la durée de la chaîne de récompenses.
- Exemple : Une chaîne de 5 récompenses est disponible à partir du 1ᵉʳ octobre. Si ce paramètre est activé, la chaîne se renouvelle pour tous les utilisateurs tous les 5 jours : les 6, 11, 16 octobre, ainsi de suite.
- Cliquez sur Create.
- Exemple : Dans une chaîne de 5 récompenses, si l'utilisateur se connecte 3 jours consécutifs puis manque le 4ᵉ jour, alors au 5ᵉ jour :
- L'utilisateur recevra la première récompense de la chaîne si le paramètre de réinitialisation est activé ;
- L'utilisateur recevra la quatrième récompense de la chaîne si le paramètre de réinitialisation est désactivé.
- Appuyez sur Create.
- Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Daily rewards.
- Dans la ligne contenant la récompense quotidienne, appuyez sur ••• et sélectionnez Activate dans la liste déroulante.
Modifier les récompenses quotidiennes
Vous pouvez activer, désactiver ou modifier les récompenses quotidiennes. Pour les récompenses de type Login reward, vous pouvez également réinitialiser la progression de tous les utilisateurs dans le cycle de récompenses quotidiennes en cours. Pour modifier les paramètres, cliquez sur ••• dans la ligne des récompenses quotidiennes et sélectionnez l’action souhaitée.
Impossible de modifier une chaîne de récompenses quotidiennes active. Désactivez-la d’abord pour effectuer des modifications.
Il est impossible de modifier le type de chaîne de récompenses (Login reward ou Reward calendar). Vous pouvez définir ce paramètre uniquement lors de la création d’une récompense quotidienne.
Pour les chaînes Login reward, les modifications suivantes réinitialisent la progression pour tous les utilisateurs :
- changement du paramètre Make promotion renewable ;
- changement du paramètre Reset user progress if they miss a day ;
- ajout ou suppression d’étapes.
Après réactivation, la chaîne redémarre pour tous les utilisateurs connectés au magasin après le début de la promotion, y compris ceux ayant déjà obtenu toutes les récompenses.
Modifier le titre, la récompense, la description, les dates, l’heure où le fuseau horaire n’entraîne pas de réinitialisation de la progression : les utilisateurs reprennent à partir du jour où ils s’étaient arrêtés.
Pour les chaînes Reward calendar, les modifications ne nécessitent pas de réinitialiser la progression de l’utilisateur.
Configuration via API
Pour configurer et gérer la récompense quotidienne via API, utilisez les appels suivants de la section Administrateur du groupe Récompenses quotidiennes :
| Tâche | Appel API |
|---|---|
| Créer une récompense quotidienne. | Créer une récompense quotidienne. |
| Activer une récompense quotidienne. | Passez le paramètre “is_enabled”: true aux appels Créer une récompense quotidienne ou Mettre à jour la récompense quotidienne. Vous pouvez également utiliser l’appel Basculer une récompense quotidienne. |
| Mettre à jour la récompense quotidienne. | Mettre à jour la récompense quotidienn. |
| Désactiver la récompense quotidienne. | Basculer une récompense quotidienne. |
| Supprimer une récompense quotidienne. | Supprimer la récompense quotidienne. |
Affichage des récompenses quotidiennes dans le magasin
Affichage sur le site web créé avec Xsolla
Pour afficher une récompense quotidienne sur votre site :
- Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.
- Sélectionnez votre site et appuyez sur Open Site Builder.
- Dans la zone principale de l’éditeur, choisissez l’emplacement où vous souhaitez ajouter un nouveau bloc, puis appuyez sur Add block.
- Sélectionnez le bloc Daily rewards.
- Dans le menu latéral, accédez aux paramètres du bloc.
- Dans la liste déroulante, choisissez la chaîne de récompenses quotidiennes.
- Pour prévisualiser la chaîne de récompenses quotidiennes, appuyez sur Preview dans le coin supérieur droit du constructeur.
- Pour appliquer les modifications, publiez le site :
- Dans le coin supérieur droit du constructeur, appuyez sur Publish.
- Sélectionnez les pages que vous souhaitez publier en cochant les cases correspondantes.
- Appuyez sur Publish.
Si la publication du site n’est pas disponible, assurez-vous que toutes les conditions suivantes sont remplies :
- Aucune section du constructeur n’est vide (marquée d’un point rouge).
- L’accord de licence avec Xsolla est signé.
- La page principale est publiée ou sélectionnée pour publication. Vous ne pouvez pas publier de pages enfant avant la page principale.
Les utilisateurs ne verront pas la chaîne de récompenses quotidiennes tant qu’elle n’est pas activée et que sa période de validité n’a pas débuté.
Les chaînes de récompenses quotidiennes dont les dates sont expirées ou qui n’ont pas encore commencé s’affichent en mode aperçu dans le constructeur de site. Ce mode permet de visualiser toutes les modifications non publiées, y compris les chaînes inactives.
Affichage dans votre propre interface utilisateur
- Dans l’interface de votre application, implémentez les éléments nécessaires pour afficher les étapes de la chaîne de récompenses quotidiennes.
- Implémentez la logique pour gérer les chaînes en utilisant les appels API côté client suivants du groupe Récompenses quotidiennes :
- Assurez-vous que les objets sont correctement attribués à l’utilisateur.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.
