Promotions par bonus

Comment ça marche

Les promotions par bonus sont une stratégie marketing visant à inciter les utilisateurs à acheter des objets virtuels en leur offrant des objets bonus.

Caractéristiques principales :

• Octroyer un ou plusieurs objets bonus lors de l’achat d’un objet promotionnel.
• Spécifier le nombre de fois qu’un utilisateur peut bénéficier de la promotion.
• Configurer des promotions par bonus personnalisées.

Exemples d’utilisation :

• Octroi de bonus sous forme de monnaie virtuelle qui peuvent être utilisés pour l’achat d’objets virtuels.
• Organisation de promotions offrant des bonus à des dates importantes pour votre projet, telles que l’anniversaire du projet, afin de récompenser les utilisateurs pour leur fidélité.
• Octroi d’objets bonus en plus des achats d’objets pour les utilisateurs ayant atteint un certain niveau dans le jeu, en récompense de leur fidélité.

• Octroi d’objets bonus pour une durée limitée dans le but d’encourager les utilisateurs à acheter des objets virtuels.

Lorsque vous créez un catalogue des objets à l’aide de méthodes API, vous pouvez récupérer des informations sur les promotions. Dans la réponse, outre les informations sur l’objet virtuel, vous recevrez les informations suivantes sur les promotions de type Bonus :

• nom ;
• dates de début et de fin ;
• article(s) bonus ;
• nombre total de fois que l’utilisateur peut bénéficier de la promotion ;
• nombre de fois restant que l’utilisateur peut bénéficier de la promotion.

Si le nombre de fois restant que l’utilisateur peut bénéficier de la promotion est égal à zéro, les informations sur la promotion ne s’affichent pas dans le catalogue.

{
  "item_id": 400962,
  "sku": "test_item",
  "type": "virtual_good",
  "name": "name_test_limit",
  "description": "description_test_limit",
  "price": {
    "amount": "1.00",
    "amount_without_discount": "1.00",
    "currency": "USD"
  },
  "virtual_prices": [
    {
      "description": null,
      "item_id": 322172,
      "sku": "1234500",
      "name": "virt currency only",
      "type": "virtual_currency",
      "amount": 1,
      "amount_without_discount": 1,
      "calculated_price": {
        "amount": "1.00",
        "amount_without_discount": "1.00"
      },
      "is_default": true
    }
  ],
  "can_be_bought": true,
  "promotions": [
    {
      "name": "New Year Bonus",
      "date_start": "2022-12-30T22:00:00+03:00",
      "date_end": "2023-01-02T21:59:59+03:00",
      "discount": null,
      "bonus": [
        {
          "quantity": 3,
          "name": "mybonusitem",
          "sku": "444777",
          "type": "virtual_good"
        }
      ],
      "limits": {
        "per_user": {
          "available": 7,
          "total": 7
        }
      }
    }
  ],
  "limits": null,
  "attributes": [],
  "is_free": false,
  "groups": [
    {
      "external_id": "01022023",
      "name": "Group1"
    }
  ],
  "virtual_item_type": "consumable",
  "inventory_options": {
    "consumable": {
      "usages_count": 1
    },
    "expiration_period": null
  }
}

Comment configurer

Configurer une promotion par bonus

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

Configuration dans le Compte éditeur

• Définir la période de validité de la promotion ;
• Limiter le nombre de fois que la promotion peut être utilisée par l’utilisateur ;
• Définir les conditions de déclenchement de la promotion ;

• configurez des promotions qui s’appliquent à tous les types d’objets :

  • packages de monnaie virtuelle,
  • objets virtuels (y compris les objets à durée limitée),
  • clés de jeu,
  • lots.

L’édition des promotions par bonus dont le statut est Active n’est actuellement pas disponible dans le Compte éditeur.

Vous pouvez utiliser les méthodes API pour accéder aux options avancées de configuration de vos promotions par bonus.

Pour configurer une promotion dans le Compte éditeur :

1. Accédez à Store > Promotions and rewards dans le Compte éditeur.

2. Cliquez sur Create promotion.

3. Spécifiez les paramètres suivants :
   1. Entrez le titre de la promotion ;
   2. Sélectionnez Bonus sous Promotion type ;
   3. Indiquez les objets promotionnels ;
   4. Spécifiez l'objet qui est octroyé à l'utilisateur lors de l'achat de l'objet promotionnel.

4. Cliquez sur Next.
5. Vous pouvez définir le nombre d'utilisations de la promotion si nécessaire. Pour ce faire, sur la page Conditions and limits, réglez la bascule Limit number of times one user can use promotion sur On et spécifiez le nombre.
6. Pour configurer des promotions personnalisées, réglez Trigger promotion only for specific users sur On et spécifiez la ou les conditions. Pour configurer une personnalisation, suivez ces instructions.
7. Cliquez sur Next.
8. Spécifiez la période de promotion.

9. Cliquez sur Next.
10. Vérifiez les paramètres et cliquez sur Save and exit.
11. Pour activer une promotion :
    1. Trouvez la promotion dans votre catalogue de promotions ;
    2. Cliquez sur l'icône ••• et dans la liste déroulante, sélectionnez Edit promotion, ou accédez à l'édition en cliquant sur la promotion correspondante dans le catalogue des promotions.
    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 bonus, vous pouvez utiliser les méthodes des sous-sections Communs et Bonus du groupe de méthodes Promotions.

Pour créer une promotion par bonus, utilisez la méthode Créer une promotion par bonus et spécifiez les paramètres nécessaires.

Pour activer une promotion par bonus, utilisez la méthode Mettre à jour une promotion par bonus avec le paramètre “is_enabled”:true ou la méthode Activer une promotion.

Pour désactiver une promotion, utilisez la méthode Désactiver une promotion.

Pour modifier une promotion via les méthodes API, appelez la méthode Mettre à jour une promotion par bonus avec les nouveaux paramètres de la promotion. L’édition de la promotion est également disponible pour les promotions dont le statut est Active.

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

• Configurer l’application de la promotion sur tous les objets du projet. Passez le paramètre “condition”:null à la méthode Créer une promotion par bonus ou Mettre à jour une promotion par bonus.

“condition”: null

• Configurer une promotion à durée indéterminée. Passez le paramètre “date_end”:null à la méthode Créer une promotion par bonus ou Mettre à jour une promotion par bonus.

“date_end”: null