Promotions par réduction

Comment ça marche

Les promotions par réduction sont une stratégie marketing efficace pour attirer de nouveaux joueurs et stimuler les ventes.

Caractéristiques principales :

• Configurer une remise pour un ou plusieurs objets.
• Appliquer un nombre illimité de promotions par réduction à un objet.
• Créer un catalogue des objets avec calcul automatique du prix des objets. Les méthodes de création d’un catalogue renvoient le paramètre price pour chaque objet. Ce paramètre contient les prix de l’objet avec et sans réduction en cours.

"price": {
  "amount": "2.3900000000000000",
  "amount_without_discount": "2.9900000000000000",
  "currency": "USD"
}

Restrictions :

• Vous ne pouvez définir la remise qu’en pourcentage compris entre 1 et 99.
• Vous ne pouvez pas appliquer de restrictions régionales aux promotions par réduction.

Vous pouvez configurer des promotions pour un nombre illimité d’objets et appliquer un nombre illimité de promotions à un objet.

L’utilisateur peut voir des informations sur les promotions :

• lorsqu’il consulte le catalogue de jeux ;
• lorsqu’il passe une commande.

Si vous utilisez Site Builder pour créer votre magasin, le catalogue du jeu affiche le montant de la remise, le prix barré sans remise et le prix avec remise.

Si vous créez votre propre version du magasin, implémentez l’affichage des promotions dans le catalogue sur la base des données reçues dans la méthode Lire une liste de jeux. Dans la réponse, vous obtenez les informations suivantes sur les promotions en plus des informations sur le jeu :

• titre ;
• dates de début et de fin ;
• montant de la remise pour une promotion de type Discount ;
• prix de l’objet avec et sans remise pour une promotion de type Discount ;
• objet bonus pour une promotion de type Bonus.

{
  "items": [
    {
      "sku": "game_1",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        },
        {
          "external_id": "Xsolla",
          "name": "Xsolla games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": {
        "$ref": "../examples/client-attribute-game.yaml#/value"
      },
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": true,
          "is_pre_order": true,
          "release_date": "2020-08-11T10:00:00+03:00"
        },
        {
          "sku": "game_key_02",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Origin",
          "drm_sku": "origin",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    },
    {
      "sku": "game_2",
      "name": "Game name",
      "groups": [
        {
          "external_id": "all",
          "name": "All games"
        }
      ],
      "type": "unit",
      "unit_type": "game",
      "description": "Game description",
      "image_url": "https://cdn.xsolla.net/img/misc/images/b79342cdf24f0f8557b63c87e8326e62.png",
      "attributes": [
        {
          "external_id": "OS",
          "name": "OS",
          "values": [
            {
              "external_id": "9d5c5efb7c0f00a00fe4e3583f1215b0050bc723",
              "value": "Windows"
            }
          ]
        }
      ],
      "promotions": [],
      "unit_items": [
        {
          "sku": "game_key_01",
          "type": "game_key",
          "is_free": false,
          "price": {
            "amount": "30.5",
            "amount_without_discount": "30.5",
            "currency": "USD"
          },
          "virtual_prices": [],
          "can_be_bought": true,
          "drm_name": "Steam",
          "drm_sku": "steam",
          "has_keys": false,
          "is_pre_order": false,
          "release_date": null
        }
      ]
    }
  ]
}

Lors de la passation d’une commande, les informations suivantes sont affichées sur les promotions appliquées :

• le résultat de l’application de la promotion par réduction :
  • montant de la remise pour la promotion ;
  • prix barré sans remise ;
  • prix réduit.
• le résultat de l’application de la promotion par bonus :
  • objets bonus ;
  • valeur Free dans la ligne de prix pour les objets bonus.
• le résultat de l’application du code promo :
  • montant de la remise pour le code promo ;
  • prix barré sans remise ;
  • prix réduit ;
  • objets bonus ;
  • valeur Free dans la ligne de prix pour les objets bonus.

Comment configurer

Configurer une promotion par réduction

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

Configuration dans le Compte éditeur

• Configuration d’une remise en pourcentage entier.
• Configuration des promotions disponibles pour une durée limitée.
• Configuration des remises s’appliquant à un ou plusieurs packages de clés de jeu pour des plateformes spécifiques.

• Définir des remises avec des valeurs fractionnaires.
• Configurer des remises d’une durée illimitée.
• Modifier les promotions avec le statut Active.

1. Accédez à la section Store > Promotions and rewards du Compte éditeur et cliquez sur Create promotion.

2. Spécifiez les paramètres requis :
   1. Entrez le titre de la promotion ;
   2. Sélectionnez Discount sous Promotion type ;
   3. Décidez du pourcentage de la réduction ;
   4. Choisissez le type de produit ;

• 5. Choisissez un ou plusieurs objets qui bénéficieront d'une remise.

3. Cliquez sur Next.
4. Vous pouvez limiter le nombre de fois qu'un utilisateur peut utiliser la promotion. Pour le configurer, sur la page Condition and limit, réglez Limit number of times one user can use promotion sur On et spécifiez la limite.
5. Pour configurer des promotions personnalisées, réglez Promotion for only specific users sur On et suivez cette instruction.
6. Cliquez sur Next.

7. Définissez les dates de début et de fin de la promotion.
8. Cliquez sur Next.

9. Vérifiez les paramètres et cliquez sur Save and exit.

10. Pour activer une promotion :
    1. Trouvez la promotion dans votre catalogue des promotions ;
    2. Cliquez sur le bouton de menu ••• et sélectionnez Edit promotion ;

• 3. Dans le coin supérieur droit, ouvrez le menu déroulant et sélectionnez Activate promotion.

Configuration via des méthodes API

Pour configurer les promotions par réduction, vous pouvez utiliser les méthodes de la sous-section Discount du groupe de méthodes Promotions.

Pour créer la promotion via les méthodes API :

1. Appelez la méthode Create discount promotion for item avec les paramètres requis.
2. Appelez la méthode Update item promotion avec le paramètre “is_enabled”:true pour activer la promotion.

Pour modifier la promotion via une API, appelez la méthode Update item promotion avec les nouveaux paramètres de promotion. Vous pouvez également modifier la promotion dont le statut est Active.

Lorsque vous créez ou modifiez une promotion par réduction via les méthodes API, vous pouvez également :

• Configurer une remise sur tous les objets du projet. Passez le paramètre “items”:null à la méthode Create discount promotion for item ou Update item promotion.

"items": null

• Configurer une remise sur les biens physiques. Passez un tableau contenant les SKU de biens physiques à la méthode Create discount promotion for item ou Update item promotion.

"items": [{
     “sku”: “strw2030”
  }, {
     “sku”: “strw4060”
  }, {
     “sku”: “cupred200”
  }
]

• Définir une remise avec une valeur de pourcentage fractionnaire. Passez le paramètre discount.percent avec une fraction de remise à la méthode Create discount promotion for item ou Update item promotion.

"discount": {
    “percent”: ”49.9”
}

• Configurer une remise sur différents types d'objets. Passez un tableau contenant les SKU des objets requis à la méthode Create discount promotion for item ou Update item promotion.

"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]

• Configurer une remise sur certains DRM du jeu. Passez un tableau contenant les SKU des DRM requis à la méthode Create discount promotion for item ou Update item promotion.

"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]

• Configurer une promotion par réduction à durée indéterminée. Passez le paramètre “date_end”:null à la méthode Create discount promotion for item ou Update item promotion.

“date_end”: null

• Configurez une promotion pour les nouveaux acheteurs. Pour ce faire, passez dans l'appel API Créer une promotion par réduction pour un objet un objet ou dans l'appel API Mettre à jour une promotion sur les objets un objet dans un tableau attribute_conditions :

"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}

Personnaliser les conditions d'une promotion par réduction

• remise appliquée à une somme définie d’un panier ;
• remise appliquée uniquement si le panier contient une certaine quantité d’objets ;
• remise sur un objet si l’utilisateur achète un autre objet.