Coupons et promotions (Economy hérité)

Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement 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 permettre à vos clients d’obtenir des articles d’inventaire dans leur jeu. Combinés à des ensembles ou à CloudScript, ces coupons peuvent servir à déclencher pratiquement n’importe quelle fonctionnalité de votre jeu.

Exigences

Connaissance des catalogues, des ensembles et des conteneurs.
Connaissance de Game Manager.
Connaissance de l’inventaire des joueurs.

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 Title.
Sélectionnez Economy dans le menu de gauche.
Allez à 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 article de la section. Si vous souhaitez créer des coupons pour un article précis :

Sélectionnez Coupons dans l’onglet Items.
Les Coupons d’ensembles se trouvent sous Bundles, et les Coupons de conteneurs, sous Containers.

La fenêtre contextuelle ressemble à celle présentée ci-dessous. (Votre liste d’articles devrait correspondre à votre titre. Les articles affichés sont décrits dans notre tutoriel sur les 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 ensuite ê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 lui fournissez une interface graphique qui lui permet d’entrer 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’article d’inventaire

La façon la plus simple d’utiliser les coupons consiste à offrir un article d’inventaire. Une fois votre catalogue créé, vous pouvez générer des coupons pour des articles ordinaires 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 d’articles multiples

Les coupons ne peuvent pas accorder directement de la monnaie virtuelle, et ils ne peuvent accorder qu’un seul article. Toutefois, les ensembles peuvent servir à convertir de façon transparente des articles d’inventaire en groupes d’articles ou en monnaie virtuelle. Dans l’exemple de la monnaie virtuelle (MV), vous devez créer un nouvel article de type ensemble dont le contenu est de la MV. Configurez l’ensemble pour qu’il expire dans 15 secondes. Ainsi, le joueur verra immédiatement la MV dès qu’il ouvrira l’ensemble, et il ne verra pas l’article intermédiaire.

Game Manager - Economy - Modifier un ensemble de catalogue

Les articles multiples fonctionnent de la même façon :

Créez un ensemble contenant plusieurs articles, ou même des tables de butin.
Configurez-le pour qu’il expire dans 15 secondes.
Le coupon peut générer l’ensemble.
L’ensemble est ensuite converti en plusieurs articles.
L’article d’ensemble intermédiaire disparaît.

Scénarios d’utilisation

Récompenses physiques lors de congrès :
- Vous pouvez imprimer votre liste de codes de coupon et les distribuer comme articles promotionnels lors de congrès.
Communications hors jeu, comme les forums, les notifications Push et les courriels.
- Envoyez des codes de coupon directement à vos joueurs, dans le cadre de campagnes de reconquête ou d’autres initiatives communautaires.
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 articles d’inventaire; choisissez l’option la plus pertinente pour votre jeu.

Meilleures pratiques

Lorsque vous utilisez l’inventaire PlayFab, vous devriez garder la taille des inventaires relativement petite, soit moins de 100 articles au total par joueur. Un ensemble qui accorde trop d’articles pourrait être limité ou soumis à une limite de débit.

XBOX Services

PlayFab

Coupons et promotions dans Economy (hérité)

Coupons et promotions (Economy hérité)

Exigences

Instructions pour générer et utiliser des coupons

Exemple : coupon d’article d’inventaire

Exemple : coupon de monnaie virtuelle ou coupon d’articles multiples

Scénarios d’utilisation

Meilleures pratiques

​Coupons et promotions (Economy hérité)

​Exigences

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

​Exemple : coupon d’article d’inventaire

​Exemple : coupon de monnaie virtuelle ou coupon d’articles multiples

​Scénarios d’utilisation

​Meilleures pratiques

Coupons et promotions (Economy hérité)

Exigences

Instructions pour générer et utiliser des coupons

Exemple : coupon d’article d’inventaire

Exemple : coupon de monnaie virtuelle ou coupon d’articles multiples

Scénarios d’utilisation

Meilleures pratiques