Lots

Comment ça marche

Un lot est un ensemble de plusieurs biens vendus en une seule unité.

Fonctionnalités principales :

• Ajout de biens de différents types à un lot :
  • monnaie virtuelle (y compris la monnaie dépendante de la plateforme) ;
  • package de monnaie virtuelle ;
  • clés de jeu pour des plateformes présélectionnées ;
  • objets virtuels, y compris des objets à durée limitée ;
  • lots.
• Configuration de prix de lot en devises réelles et en monnaie virtuelle.
• Lot gratuit.
• Limitation du nombre de lots disponibles à l’achat.
• Limitation du temps d’affichage de lots dans le magasin.

Une offre groupée est automatiquement déballée après l’achat. Si une offre groupée comprend une autre offre groupée, l’offre groupée incluse se sépare automatiquement en articles autonomes.

La méthode de livraison des objets d’un package déballé dépend du type bien :

• Les packages de monnaie virtuelle, les objets virtuels, les objets à durée limitée et les lots sont livrés :
  • dans l’inventaire (méthode par défaut) ;
  • dans PlayFab, si vous avez configuré son intégration.
• Les clés de jeu sont livrées :
  • par e-mail (méthode par défaut) ;
  • dans PlayFab, si vous avez configuré son intégration.

Lorsque l’acheteur retourne un lot, par exemple en annulant une transaction, tous les objets du lot qui lui ont été octroyés lui sont automatiquement retirés. Si l’utilisateur a dépensé une partie des objets, les objets restants sont quand même retirés.

Restrictions :

• Vous ne pouvez pas ajouter les objets suivants à un lot :
• le même lot ;
• des biens physiques.
• Vous ne pouvez pas créer un lot vide.
• Les ventes du lot sont interrompues lorsque vous n’avez plus de clés à vendre et que ces clés sont incluses dans le lot.
• Le prix d’un lot doit être une valeur fixe de devises réelles et/ou de monnaie virtuelle.
• Vous pouvez configurer des restrictions régionales pour un lot uniquement via API.

Limiter le nombre de lots disponibles à l'achat

L’achat de lots peut être limité. Par exemple, vous pouvez limiter :

• le nombre de lots par utilisateur ;
• les lots de bienvenue qui ne peuvent être achetés qu’une seule fois.

Si l’utilisateur a atteint la limite spécifiée, le lot ne sera plus affiché dans le catalogue. Si le lot contient un package de monnaie virtuelle ou un objet virtuel avec une limite d’achat et que l’utilisateur a déjà acheté la quantité autorisée, le lot ne sera pas affiché dans le catalogue.

Vous pouvez afficher le nombre maximal de lots disponibles pour l’utilisateur ainsi que le nombre de lots restant.

Pour définir une limite d’achat lors de la création d’un lot dans le Compte éditeur, réglez l’option Limit number of times one user can buy this bundle sur On et spécifiez le nombre de fois que le lot peut être acheté.

Utilisez les méthodes de la sous-section Catalog du groupe de méthodes Bundles pour obtenir des informations sur les lots.

Dans la réponse, vous recevrez les informations suivantes en plus des informations sur le lot :

• le nombre maximum de lots que l’utilisateur peut acheter ;
• le nombre restant de lots que l’utilisateur peut acheter.

Pour en savoir plus sur la manière de définir ou de mettre à jour des restrictions, consultez les instructions Limites pour l’utilisateur.

{
  "items": [
    {
      "sku": "kg_1",
      "name": "kg_10.00_bundle",
      "type": "bundle",
      "description": "pricePoint_44056_1",
      "image_url": null,
      "long_description": null,
      "attributes": {
        "external_id": "genre",
        "name": "Genre",
        "values": [
          {
            "external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
            "value": "Casual"
          },
          {
            "external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
            "value": "Strategy"
          },
          {
            "external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
            "value": "Mobile"
          }
        ]
      },
      "is_free": false,
      "order": 999,
      "groups": [],
      "price": {
        "amount": 9.99,
        "currency": "USD",
        "amount_without_discount": 9.99
      },
      "total_content_price": {
        "amount": 10.99,
        "currency": "USD",
        "amount_without_discount": 10.99
      },
      "media_list": [],
      "virtual_prices": [],
      "can_be_bought": true,
      "bundle_type": "standard",
      "limits": {
        "$ref": "./Catalog_item_limits.yaml"
      },
      "content": [
        {
          "sku": "big_rocket",
          "name": "Big Rocket",
          "description": "Big Rocket - short description.",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "type": "virtual_currency",
          "quantity": 100,
          "virtual_item_type": "non_consumable",
          "attributes": {
            "external_id": "size",
            "name": "Size",
            "values": [
              {
                "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
                "value": "Large"
              }
            ]
          },
          "is_free": false,
          "groups": [],
          "price": {
            "amount": 10.99,
            "currency": "USD",
            "amount_without_discount": 10.99
          },
          "virtual_prices": [],
          "limits": {
            "per_user": {
              "total": 5,
              "available": 5
              },
            "per_item": null
           },
          }
        }
      ]
    }
  ]
}

Limiter la durée d'affichage des lots dans le magasin

• maintenir la pertinence du catalogue à un moment donné, par exemple pendant les soldes des fêtes ;
• créer un lot à l’avance sans l’afficher dans le catalogue ;
• inciter l’utilisateur à acheter des lots en affichant une minuterie à côté du bien.

Pour définir une limite de temps pour l’affichage 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.

Pour définir une limite de temps d’affichage d’un lot dans le magasin via API, passez les paramètres suivants dans l’appel API Create bundle ou Update bundle.

• 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 lot dans le magasin. Pour ce faire, dans la méthode Create bundle ou Update bundle, passez un tableau contenant les dates de début et de fin de toutes les périodes.

Exemple :

"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"
      }
]

Qui peut l'utiliser

Les partenaires qui souhaitent vendre des ensembles d’objets à un prix inférieur au total initial de tous les objets de l’ensemble, ce qui stimule les ventes et permet d’attirer de nouveaux joueurs.

Comment configurer

Flux d'intégration

1. Configurez un lot.
2. Implémentez l'obtention de lots dans le catalogue.

Configurer un lot

• dans le Compte éditeur ;
• via méthodes API.

Configuration dans le Compte éditeur

1. Accédez au Compte éditeur, puis à Store > Bundles et cliquez sur Create bundle.
2. Spécifiez les paramètres suivants du lot :
   1. Image ;
   2. Nom ;
   3. Description ;
   4. Contenu ;
   5. Prix ;
   6. Afficher dans le magasin.
3. Vérifiez les paramètres et cliquez sur Save.

Configuration via des méthodes API

Ajouter une clé de jeu au lot

Pour ajouter une clé de jeu pour une plateforme sélectionnée à un lot, passez un tableau contenant les UGS des plateformes nécessaires à la méthode Create bundle ou Update bundle.

"content": [{
     “sku”: “brilliant_game_sku_steam”,
     “quantity”: 1
  }
]

Configurer des restrictions régionales

Pour configurer des restrictions régionales pour un lot, passez à la méthode Create bundle ou Update bundle un tableau contenant les ID des régions prises en charge.

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Configurer des prix régionaux

Pour configurer des prix régionaux pour un lot, passez à la méthode Create bundle ou Update bundle un tableau contenant les paramètres de prix pour les régions prises en charge.

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

Obtenir des lots dans le catalogue