Comment configurer une limite de durée d’affichage des objets dans le magasin

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

  • maintenir la pertinence du catalogue à un moment donné, par exemple pendant les soldes des fêtes ;
  • créer un objet à l’avance sans l’afficher dans le catalogue ;
  • motiver l’utilisateur à acheter des objets en affichant un chronomètre à côté de ceux-ci.
Note
Lorsque vous créez une interface de catalogue à l’aide de Site Builder, la minuterie s’affiche automatiquement. Lorsque vous créez un catalogue dans votre propre interface, vous devez implémenter la minuterie.
La limitation de la durée d’affichage est disponible pour les types de biens suivants :
  • objets virtuels
  • monnaie virtuelle et packages de monnaie virtuelle
  • lots
Note
Pour les objets virtuels, les packages de monnaie virtuelle et les lots, la configuration est disponible dans le Compte éditeur et via appels API. Pour la monnaie virtuelle, la configuration est disponible uniquement via appels API.
Pour définir une limite de temps pour l’affichage d’une monnaie virtuelle, de packages de monnaie virtuelle et d’un lot dans le magasin via le Compte éditeur, sélectionnez Time period et spécifiez le fuseau horaire ainsi que les dates de début et de fin de la période. Si vous ne souhaitez pas indiquer de date de fin d’affichage, cochez la case No end date.
Note
Une fois un objet virtuel, une monnaie virtuelle ou un package de monnaie virtuelle créé, vous pouvez définir des statuts pour déterminer s’il est disponible, indisponible ou partiellement disponible.
Pour définir une limite de temps pour l’affichage des biens dans le magasin via API, utilisez :Passez les paramètres suivants à l’appel API de création ou de mise à jour de bien :
  • periods[0].date_from avec la date et l’heure de début de la période d’affichage du bien au format YYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT ;
  • periods[0].date_until avec la date et l’heure de fin de la période d’affichage du bien au formatYYYY-MM-DDThh:mm:ss±TMZ, où TMZ est l’indicateur de fuseau horaire au format hh:mm GMT. Pour ne pas indiquer la fin de la période d’affichage du bien, passez null.

Vous pouvez définir plusieurs périodes pour l’affichage d’un bien dans le magasin. Pour ce faire, passez un tableau avec les dates de début et de fin de toutes les périodes dans les appels API.

Exemple :

Copy
Full screen
Small screen
    "periods": [
          {
            "date_from": "2022-06-10T14:00:00+03:00",
            "date_until": "2022-06-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-07-10T14:00:00+03:00",
            "date_until": "2022-07-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-08-10T14:00:00+03:00",
            "date_until": "2022-08-30T14:00:00+03:00"
          }
    ]
    

    Les méthodes GET du catalogue renvoient les objets qui sont 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 une valeur de 1 lors de la requête de catalogue.

    Note

    Les délais d’affichage des objets ne sont pas pris en compte dans un lot.

    EXEMPLE

    1. Vous créez un Booster virtuel et définissez sa période d’affichage du 29 octobre au 15 novembre.

    2. Vous créez un lot Legendary Start Pack qui comprend le Booster. Le lot n’a pas de limite de temps, il est donc toujours visible dans le magasin.

    3. Le 20 octobre, un utilisateur ouvre votre magasin en jeu. Vous utilisez les méthodes suivantes :

    Vous ne passez pas le paramètre show_inactive_time_limited_items dans ces méthodes.

    4. Vous récupérez le catalogue des objets :

    • Le Booster n’est pas inclus dans la réponse à Lire une liste d’objets virtuels, car sa période d’affichage va du 29 octobre au 15 novembre. Si vous passez le paramètre show_inactive_time_limited_items:1 dans Lire une liste d’objets virtuels, le Booster est inclus dans la réponse, et le tableau periods indique la période pendant laquelle il est en vente.
    • Booster est inclus dans la réponse à Lire une liste de lots en tant que partie du lot Legendary Start Pack, et l’utilisateur peut l’obtenir quel que soit la valeur du paramètre show_inactive_time_limited_items.

    Cet article vous a été utile ?
    Merci !
    Que pouvons-nous améliorer ? Message
    Nous sommes désolés de l'apprendre
    Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
    Merci pour votre commentaire !
    Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
    Dernière mise à jour: 3 Octobre 2024

    Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

    Signaler un problème
    Nous améliorons continuellement notre contenu grâce à vos commentaires.
    Indiquez votre adresse e-mail pour un suivi
    Merci pour votre commentaire !