Chaîne d’offres

Les chaînes d’offres permettent de créer une séquence d’étapes, chacune proposant un objet à réclamer gratuitement ou à acheter. Les utilisateurs progressent étape par étape, en débloquant chaque nouvelle offre après avoir terminé la précédente.

Utilisez les chaînes d’offres pour encourager l’engagement récurrent et renforcer la rétention. Elles incitent les utilisateurs à revenir dans le jeu et à terminer la chaîne avant son expiration.

Glossaire

Comment ça marche

Visibilité et comportement de la chaîne d’offre

• Les utilisateurs non authentifiés peuvent voir toutes les chaînes d’offres disponibles dans le magasin.
• Une fois connectés, les utilisateurs ne voient que les chaînes d’offres accessibles selon les conditions d’affichage définies.
• Si un utilisateur a déjà réclamé ou acheté des objets dans une chaîne, sa progression est affichée, étapes terminées et prochaine action disponible incluses.
• Si la chaîne est configurée pour se réinitialiser (chaque semaine ou chaque mois), la progression est remise à zéro selon le calendrier, et l’utilisateur recommence depuis la première étape.
• Une fois toutes les étapes complétées, la chaîne apparaît comme terminée.

Logique d’étape et tarification

Chaque étape de la chaîne d’offres est associée à une UGS spécifique. Le prix de l’étape est automatiquement hérité de l’objet assigné :

• Si l’objet est gratuit, l’étape est également gratuite.
• Si l’objet est payant, l’étape l’est aussi, et l’achat de l’objet est nécessaire pour avancer dans la chaîne d’offres.

Visibilité et comportement d’UGS

• Si une UGS est disponible uniquement via la chaîne d’offres, définissez son statut sur Partly available dans les paramètres de l’objet dans le Compte éditeur pour le masquer du catalogue général.
• Si une UGS est disponible à l’achat direct, les utilisateurs peuvent l’acheter séparément. Cependant, les achats directs n’affectent pas leur progression dans la chaîne d’offres.

Propriétés ignorées de l’UGS

La chaîne d’offres ne prend pas en compte les configurations suivantes de l’objet :

• règles de personnalisation
• limites d’achat
• disponibilité programmée (date de début/fin)
• promotions et réductions

Limites de la chaîne d’offres

• Une chaîne d’offres peut contenir un maximum de 30 étapes.
• Chaque étape doit contenir un seul objet.

Remboursements

Si un objet acheté est remboursé, la progression de l’utilisateur dans la chaîne d’offres est réduite. L’étape concernée est marquée comme incomplète, et l’utilisateur ne peut pas continuer tant qu’il n’a pas acheté l’objet de nouveau.

Exemple :

L’utilisateur effectue les étapes 1, 2 et 3, puis demande le remboursement de l’objet à l’étape 2. Les étapes 1 et 3 restent terminées, mais l’étape 4 est bloquée jusqu’à ce que l’utilisateur termine à nouveau l’étape 2.

Flux utilisateur

1. L’utilisateur accède au magasin.
2. L’utilisateur voit la chaîne d’offres disponible et les récompenses pour chaque étape.
3. L’utilisateur se connecte.
4. Sa progression actuelle dans la chaîne d’offres est affichée.
5. L’utilisateur termine l’étape en cours :
   • Si l’étape est gratuite : l’utilisateur clique sur Claim reward.
   • Si l’étape est payée : l’utilisateur effectue l’achat et reçoit l’objet.
6. L’utilisateur passe à l’étape suivante de la chaîne d’offres.

Comment configurer

Pour configurer la fonctionnalité de chaîne d’offres dans votre projet, vous aurez besoin des informations suivantes :

• les étapes et leur statut ;
• la durée de la chaîne d’offres ;
• la progression de l’utilisateur ;
• les offres débloquées avec leurs boutons d’action.

Configuration dans le Compte éditeur

Créer une chaîne d’offres

1. Dans votre projet, dans le Compte éditeur, accédez à la section LiveOps > Chaînes d’offres.
2. Cliquez sur Create offer chain.

3. Spécifiez les paramètres suivants :
   • Nom de la chaîne d’offre.
   • Description (facultative).
4. Cliquez sur Next.

5. Pour configurer les étapes de la chaîne d’offres, cliquez sur Add step.

6. Spécifiez l’UGS que l’utilisateur peut obtenir à cette étape :
   • Sélectionnez l’UGS existante dans la liste déroulante.
   • Créez un nouvel objet : monnaie virtuelle, objets virtuels, clés de jeu, lots.

7. Si l’utilisateur peut obtenir cet objet gratuitement, réglez la bascule Offer free reward sur On.
8. Cliquez sur Save.

9. Cliquez sur Add step et répétez les étapes 5 à 8 pour ajouter d’autres étapes.
10. Cliquez sur Next lorsque vous avez terminé.

11. Spécifiez les paramètres suivants dans Time zone settings :
    • Fuseau horaire
    • Date de début
    • Heure de début
    • Date de fin (facultatif)
    • Heure de fin (facultatif)

12. Si vous souhaitez rendre la chaîne d’offres récurrente, réglez la bascule Make offer chain renewable sur On et spécifiez les paramètres suivants :
    • Période de renouvellement
    • Jour du renouvellement
    • Heure du renouvellement (facultatif)
13. Cliquez sur Create. La chaîne d’offres est créée avec le statut Inactive.

14. Pour l’activer, cliquez sur ⋯ à côté de la chaîne d’offres.
15. Cliquez sur Publish ; le statut de la chaîne d’offres passe à Active.

Modifier une chaîne d’offre

Pour modifier la chaîne d’offres :

1. Dans votre projet, dans le Compte éditeur, accédez à la section LiveOps > Chaînes d’offres.
2. Cliquez sur ⋯ à côté de la chaîne.
3. Cliquez sur Edit et apportez les modifications nécessaires.
4. Cliquez sur Next.

5. Pour ajouter des étapes à la chaîne d’offres, cliquez sur Add step.
   1. Spécifiez l’UGS que l’utilisateur peut obtenir à cette étape :
      • Sélectionnez une UGS existante dans la liste déroulante ;
      • Créez un nouvel objet :monnaie virtuelle, objets virtuels, clés de jeu, lots.

2. Si l’utilisateur peut obtenir cet objet gratuitement, réglez la bascule Offer free reward sur On.
3. Cliquez sur Save.

6. Pour modifier une étape existante, cliquez sur l’icône en forme de crayon et apportez les modifications souhaitées.

7. Pour supprimer une étape, cliquez sur Delete.

8. Cliquez sur Next lorsque vous avez terminé.

9. Apportez les changements nécessaires dans Time zone settings.
10. Activez la bascule Make offer chain renewable et configurez les paramètres suivants.
11. Cliquez sur Save.

Supprimer une chaîne d’offres

Pour supprimer la chaîne d’offres :

1. Dans votre projet, dans le Compte éditeur, accédez à la section LiveOps > Chaînes d’offres.
2. Choisissez la chaîne d’offres souhaitée dans la liste et cliquez sur ⋯ à côté.
3. Cliquez sur Delete.

Configuration via des appels API

Pour gérer les chaînes d’offres, utilisez les méthodes de la sous-section Admin du groupe de méthodes Chaînes d’offres.

• Créez une chaîne d’offres en utilisant l’API Créer une chaîne d’offres.
• Récupérez une chaîne d’offres spécifique en utilisant l’API Lire une chaîne d’offre.
• Récupérez la liste des chaînes d’offres en utilisant l’API Lire une liste de chaînes d’offres.

Pour gérer les chaînes d’offres, utilisez les méthodes de la sous-section Client du groupe de méthodes Chaînes d’offres.

• Récupérez la liste des chaînes d’offres disponibles en utilisant l’API Lire les chaînes d’offres de l’utilisateur actuel.
• Vérifiez la progression de l’utilisateur en utilisant l’API Lire une chaîne d’offres de l’utilisateur actuel par ID.
• Réclamez une récompense gratuite en utilisant l’API Réclamer une étape de chaîne d’offres gratuite.
• Achetez une récompense payante en utilisant l’API Créer une commande pour une étape payante de la chaîne d’offres.

Vous pouvez également modifier, désactiver ou supprimer les chaînes d’offres.