Offre unique du catalogue

Comment ça marche

L’offre de catalogue unique est une fonctionnalité qui permet aux utilisateurs de voir des objets masqués du catalogue après la saisie d’un code d’offre unique. Si le code n’est pas saisi, les objets restent invisibles.

Fonctionnalités principales :

• configuration de la liste des objets qui s’affichent après la saisie du code ;
• configuration des promotions pour les objets qui s’affichent après la saisie du code ;
• configuration du nombre total d’échanges de codes dans le cadre de la campagne ;
• configuration du nombre d’échanges de codes par utilisateur dans le cadre de la campagne ;
• définition de restrictions régionales sur demande ;

• génération de codes multiples.

• L’utilisateur doit être autorisé pour utiliser le code.
• Si le code est associé à un objet soumis à des restrictions régionales, les utilisateurs des régions où l’objet n’est pas disponible ne peuvent pas voir les offres uniques associées à ce code.
  Exemple : Après la saisie du code, le Legendary Starter Pack doit s’afficher. Le Legendary Starter Pack est soumis à une restriction régionale et n’est disponible qu’aux États-Unis. Si un utilisateur en dehors des États-Unis saisit le code, une erreur est renvoyée en réponse à la méthode Vérifier un code promotionnel et l’utilisateur ne peut pas voir ou acheter le Legendary Starter Pack.

Flux utilisateur

1. L’utilisateur autorisé ouvre le catalogue des objets et voit tous les objets à l’exception des offres uniques.
2. L’utilisateur active le code après la saisie de celui-ci dans le champ dédié du catalogue.
3. L’utilisateur voit des objets uniques disponibles à l’achat.
4. L’utilisateur achète un objet unique, après quoi le code est considéré comme échangé.

Flux d'intégration

1. Configurez une promotion avec des offres de catalogue uniques.
2. Implémentez l’affichage du catalogue à l’utilisateur. Pour ce faire, utilisez les méthodes de la sous-section Catalog du groupe de méthodes Virtual Items & Currency pour construire le catalogue.
3. Implémentez l’affichage d’un champ dans le catalogue où l’utilisateur saisit le code.
4. Utilisez la méthode Vérifier un code promotionnel pour valider le code.
5. Implémentez l’affichage du catalogue des objets en prenant en compte le code. Pour ce faire, passez la valeur du code dans le paramètre promo_code lors de l’appel aux méthodes de la sous-section Catalog du groupe de méthodes Virtual Items & Currency pour la construction du catalogue.
6. Pour créer une commande avec un objet unique, utilisez la méthode Create order with specified item. Passez la valeur du code dans le paramètre promo_code dans le corps de la requête. Si vous voulez utiliser le panier, passez la valeur du code dans le paramètre promo_code dans le corps de la requête lors de la création du panier et de la création de la commande.

Comment configurer

Prérequis

1. Enregistrez un Compte éditeur.
2. Connectez Store et configurez les modules Virtual Items, Virtual Currency ou Bundles.

Configurer une promotion avec des offres de catalogue uniques

1. Créez une promotion avec une offre de catalogue unique en utilisant la méthode Create unique catalog offer promotion. Dans le tableau des objets, passez les UGS des objets qui sont affichés après l’activation du code. Vous pouvez également spécifier :
   • La période de promotion en passant :
     • la date de début dans le paramètre date_start ;
     • la date de fin dans le paramètre date_end. Si la date de fin n’est pas spécifiée, la promotion est indéfinie.
   • Limites :
     • le nombre de fois que la promotion peut être utilisée par un utilisateur spécifique dans le paramètre redeem_user_limit ;
     • le nombre de fois que le code peut être échangé dans le paramètre redeem_code_limit ;
     • le nombre total de fois que la promotion peut être utilisée dans le paramètre redeem_total_limit.
2. Générez des codes pour la promotion créée à l’aide de la méthode Generate unique catalog offer codes ou créez un code en utilisant la méthode Create unique catalog offer code. Vous pouvez générer des codes supplémentaires si nécessaire. Pour récupérer les codes générés, utilisez la méthode Get unique catalog offer codes.
3. Activez la promotion à l’aide du bouton Activate unique catalog offer promotion.

Pour gérer la promotion, utilisez les méthodes suivantes :

• Update unique catalog offer promotion ;
• Deactivate unique catalog offer promotion.

Pour obtenir des informations sur les offres uniques du catalogue, utilisez les méthodes suivantes :

• Get list of unique catalog offer promotions ;
• Get unique catalog offer promotion.