Coupons et promotions (Economy hérité)

Les API Economy v1 sont en mode maintenance et ne recevront plus de nouvelles fonctionnalités, uniquement des correctifs de bogues. Les API v1 seront maintenues dans un avenir prévisible. Consultez la vue d’ensemble d’Economy v2 pour en savoir plus sur la prochaine version de PlayFab Economy !

Les coupons sont des jetons de type chaîne que vous pouvez générer pour que vos clients les utilisent afin d’obtenir des objets d’inventaire dans leur jeu. Combinés à des lots ou à CloudScript, ces coupons peuvent servir à déclencher pratiquement n’importe quelle fonctionnalité de votre jeu.

Configuration requise

Connaître les catalogues, les lots et les conteneurs.
Connaître Game Manager.
Connaître l’inventaire du joueur.

Instructions pour générer et utiliser des coupons

Tous les exemples qui suivent partagent la même première étape de base : la génération d’un coupon. Celle-ci s’effectue dans Game Manager. Dans Game Manager :

Accédez à votre titre.
Sélectionnez Economy dans le menu de gauche.
Accédez à l’onglet Catalogs.

Dans chacune des trois sections d’onglet, Items, Bundles et Containers, se trouve un lien Coupons.

Ce lien ouvre une fenêtre qui vous permet de générer des coupons pour n’importe quel objet de la section. Si vous souhaitez créer des coupons pour un objet spécifique :

Sélectionnez Coupons dans l’onglet Items.
Coupons de lot sous Bundles, et Coupons de conteneur sous Containers.

La fenêtre contextuelle est similaire à celle présentée ci-dessous. (Votre liste d’objets doit correspondre à votre titre. Les objets affichés sont décrits dans notre tutoriel Tables de butin.)

Pour terminer la génération des coupons :

Sélectionnez le nombre de Coupons à générer.
Sélectionnez ensuite l’Item que les Coupons doivent générer.
Le fichier texte CSV contenant la liste des Coupons peut alors être téléchargé.

La sélection de l’un des liens de l’exemple génère les dix Coupons suivants, séparés par des virgules.

65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz

Enfin, le client peut utiliser un coupon si vous fournissez une interface graphique qui lui permet de saisir le code, laquelle appelle ensuite RedeemCoupon.

// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}

Exemple : coupon d’objet d’inventaire

La façon la plus simple d’utiliser des coupons consiste à offrir un objet d’inventaire. Une fois votre catalogue créé, vous pouvez générer des coupons pour des objets standard en suivant les instructions précédentes. Aucune autre étape particulière n’est nécessaire dans ce cas.

Exemple : coupon de monnaie virtuelle ou coupon de plusieurs objets

Les coupons ne peuvent pas accorder directement de monnaie virtuelle, et ils ne peuvent accorder qu’un seul objet. Cependant, les lots peuvent servir à convertir de manière transparente des objets d’inventaire en groupes d’objets ou en monnaie virtuelle. Dans l’exemple de la monnaie virtuelle, vous devez créer un nouvel objet de type lot dont le contenu est de la monnaie virtuelle. Configurez le lot pour qu’il expire au bout de 15 secondes. Ainsi, le joueur verra immédiatement la monnaie virtuelle dès qu’il ouvrira le lot, sans voir l’objet intermédiaire.

Game Manager - Economy - Modifier un lot de catalogue

Le principe est le même pour plusieurs objets :

Créez un lot contenant plusieurs objets, voire des tables de butin.
Configurez-le pour qu’il expire au bout de 15 secondes.
Le coupon peut générer le lot.
Le lot est ensuite converti en plusieurs objets.
L’objet de lot intermédiaire disparaît.

Scénarios d’utilisation

Récompenses physiques lors de conventions :
- Vous pouvez imprimer votre liste de codes de coupon et les distribuer comme goodies lors de conventions.
Communication en dehors du jeu, comme les forums, les notifications Push et l’e-mail.
- Envoyez des codes de coupon directement à vos joueurs, dans le cadre de campagnes de réacquisition ou d’autres actions auprès de la communauté.
Tournois :
- Envoyez des coupons aux joueurs les mieux classés lorsque vous utilisez des classements réinitialisables.

Dans ce cas, vous pouvez également distribuer directement des objets d’inventaire ; choisissez donc l’option la plus pertinente pour votre jeu.

Meilleures pratiques

Avec l’inventaire PlayFab, vous devez conserver des tailles d’inventaire relativement petites, moins de 100 objets au total par joueur. Un lot accordant trop d’objets peut être limité ou soumis à une limitation de débit.

XBOX Services

PlayFab

Coupons et promotions dans Economy (hérité)

Coupons et promotions (Economy hérité)

Configuration requise

Instructions pour générer et utiliser des coupons

Exemple : coupon d’objet d’inventaire

Exemple : coupon de monnaie virtuelle ou coupon de plusieurs objets

Scénarios d’utilisation

Meilleures pratiques

​Coupons et promotions (Economy hérité)

​Configuration requise

​Instructions pour générer et utiliser des coupons

​Exemple : coupon d’objet d’inventaire

​Exemple : coupon de monnaie virtuelle ou coupon de plusieurs objets

​Scénarios d’utilisation

​Meilleures pratiques

Coupons et promotions (Economy hérité)

Configuration requise

Instructions pour générer et utiliser des coupons

Exemple : coupon d’objet d’inventaire

Exemple : coupon de monnaie virtuelle ou coupon de plusieurs objets

Scénarios d’utilisation

Meilleures pratiques