Limitation de la durée d’affichage des objets dans le magasin

Comment ça marche

Définissez la période d’affichage d’un objet dans le magasin pour :

• Adapter le catalogue au moment de l’année, par exemple pendant les promotions des fêtes.
• Créer un objet à l’avance sans l’afficher dans le catalogue.
• Encourager l’achat en affichant un compte à rebours à côté de l’objet. Il s’affiche automatiquement si vous créez l’interface du catalogue avec le constructeur de site. Avec une interface personnalisée, vous devez l’implémenter vous-même.

La configuration de la limite de temps est disponible dans les scénarios suivants :

• Vente d’objets en jeu : objets virtuels, packages de monnaie virtuelle et lots
• Vente de jeux et de DLC au moyen de clés de jeu

Configuration et mise à jour des limites

Pour créer un objet soumis à une limite de quantité :

2. Appuyez sur Create manually, puis sélectionnez Virtual item dans la liste déroulante.

3. Dans la section General settings, indiquez les éléments suivants :
   • UGS
   • un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif)
   • nom
   • description courte
   • description détaillée : pour l’ajouter, activez la bascule correspondante (facultatif)

4. Dans la sectionMedia, importez une ou plusieurs images ou vidéos depuis votre appareil ou via un lien (facultatif). Dans le magasin créé avec l’éditeur de site Xsolla, toutes les fiches d’objet affichent le fichier marqué Main. Les autres fichiers sont uniquement disponibles dans les fiches dotées d’une galerie de médias. Le fichier marqué Main est également renvoyé dans les réponses des appels API de récupération du catalogue.

5. Dans la section Price settings, définissez les prix ou créez un objet gratuit :
   • Pour définir un prix, sélectionnez Paid item, activez les bascules Pricing in real currency et/ou Pricing in virtual currency, puis indiquez le prix. Si nécessaire, configurez les prix régionaux.
   • Pour créer un objet gratuit, sélectionnez Free item.

6. Pour limiter le nombre d’objets disponibles à l’achat :
   1. Activez la bascule dans la section Limits et indiquez la quantité.
   2. Configurez la fréquence de réinitialisation de la limite. Pour cela, sélectionnez une période dans la liste déroulante :
      1. Daily.
      2. Weekly.
      3. Monthly.
      4. Custom interval. L’intervalle est calculé à partir de la date de début daffichage de l’objet dans le magasin.
      5. No regular refresh.
   3. Définissez le calendrier de réinitialisation en renseignant les paramètres de la période sélectionnée.

7. Pour limiter la période d’affichage de l’objet (facultatif) :

   1. Activez la bascule dans la section Add specific display period.
   2. Indiquez le fuseau horaire ainsi que le début et la fin de la période.

   Pour ne pas définir de date de fin, activez la bascule No end date.

8. Configurez les attributs à l’aide de l’une des options suivantes (facultatif) :
   1. Ajouter des attributs et leurs valeurs au format JSON.
   2. Créer manuellement des attributs et leurs valeurs et les lier aux objets.

9. Si l’objet payant est utilisé dans un mécanisme de récompenses aléatoires, comme les loot boxes ou le gacha, activez la bascule Mark as paid randomized reward.

10. Appuyez sur Create.

11. Dans la fenêtre qui s’ouvre, sélectionnez le statut de l’objet et appuyez sur Continue.

L’objet créé apparaît dans la section All items.

Configuration et mise à jour via des appels API

Pour limiter la période d’affichage des objets dans le magasin, utilisez les appels API suivants :

• Créer un objet virtuel ou Mettre à jour un objet virtuel
• Créer une monnaie virtuelle ou Mettre à jour une monnaie virtuelle
• Créer un package de monnaie virtuelle ou Mettre à jour un package de monnaie virtuelle
• Créer un lot ou Mettre à jour un lot
• Créer un jeu, Mettre à jour un jeu par UGS ou Mettre à jour un jeu par ID

Passez les paramètres suivants à l’appel API de création ou de mise à jour de l’objet :

• periods[0].date_from : date et heure de début de la période d’affichage de l’objet au format YYYY-MM-DDThh:mm:ss±TMZ, où TMZ correspond au décalage par rapport à GMT au format hh:mm.

• periods[0].date_until : date et heure de fin de la période d’affichage de l’objet au format YYYY-MM-DDThh:mm:ss±TMZ, où TMZ correspond au décalage par rapport à GMT au format hh:mm. Pour ne pas définir de date de fin, indiquez une seule période et passez “periods[0].date_until”: null.

Vous pouvez définir plusieurs périodes d’affichage pour un objet dans le magasin. Pour cela, transmettez aux appels API un tableau d’objets contenant les dates de début et de fin de chaque période.

Exemple :

 1"periods": [
 2      {
 3        "date_from": "2022-06-10T14:00:00+03:00",
 4        "date_until": "2022-06-30T14:00:00+03:00"
 5      },
 6       {
 7        "date_from": "2022-07-10T14:00:00+03:00",
 8        "date_until": "2022-07-30T14:00:00+03:00"
 9      },
10       {
11        "date_from": "2022-08-10T14:00:00+03:00",
12        "date_until": "2022-08-30T14:00:00+03:00"
13      }
14]

Les appels API de récupération du catalogue renvoient les objets affichés dans le magasin au moment de la requête. Pour obtenir des informations sur les objets dont la période d’affichage n’a pas encore commencé ou a déjà expiré, passez le paramètre show_inactive_time_limited_items avec la valeur 1 lors de la requête du catalogue.

Affichage des limites dans le catalogue des objets

L’affichage des objets à durée limitée dans le catalogue dépend de la méthode d’implémentation : via le constructeur de site ou via API.

Affichage via le constructeur de site

Avec le constructeur de site, les limites de temps s’affichent automatiquement. Un compte à rebours apparaît sur la carte de l’objet 30 jours avant la fin de sa période de vente pour indiquer le temps restant :

• S’il reste plus d’une semaine avant la fin de la vente, le compte à rebours affiche les jours et les heures.
• S’il reste plus d’un jour avant la fin de la vente, il affiche les heures et les minutes.
• S’il reste moins d’un jour avant la fin de la vente, il affiche les minutes et les secondes.

Récupération des informations de limite via API

Si le catalogue est implémenté via API, les informations sur les périodes de vente des objets sont renvoyées dans le tableau items.periods par les appels API suivants :

• Lire la liste des objets virtuels
• Lire la liste des monnaies virtuelles
• Lire la liste des packages de monnaie virtuelle
• Lire la liste des lots
• Lire la liste des jeux

Les dates de disponibilité d’un objet permettent d’afficher les limites de temps dans le catalogue, par exemple en indiquant la période pendant laquelle l’utilisateur peut l’acheter.