Programme de parrainage

Comment ça marche

Un programme de parrainage est un outil permettant d’attirer de nouveaux utilisateurs grâce aux invitations envoyées par des utilisateurs existants via un lien de parrainage. Le programme peut être intégré à un site web ou à un jeu. Tous les participants au programme reçoivent des récompenses :

• Le filleul reçoit une récompense seulement une seule fois après son premier achat.
• Le parrain reçoit une récompense pour chaque filleul ayant effectué un achat dans le magasin.

• tout site web, y compris les sites web créés à l’aide du constructeur de site Xsolla ;
• un jeu.

Quel que soit l’endroit où le programme de parrainage est utilisé, sur un site web ou dans un jeu, son fonctionnement et ses conditions de récompense restent identiques.

La configuration d’un programme de parrainage est disponible dans les scénarios suivants :

• vente d’objets dans le jeu : objets virtuels, package de monnaie virtuelle et lots ;
• vente de jeux et de DLC via des clés de jeu.

• Offrir en récompense un ou plusieurs des types d’objets suivants :
  • monnaie virtuelle ;
  • objet virtuel ;
  • lot d’objets.
• Personnalisation du widget du programme de parrainage.
• Génération de liens de parrainage.
• Possibilité pour un utilisateur de changer de programme de parrainage avant d’effectuer son premier achat.

• Un seul programme de parrainage à la fois peut être actif dans le projet.
• Les utilisateurs ne peuvent pas s’inviter eux-mêmes.

Flux utilisateur

Flux du parrain

1. L’utilisateur se connecte ou s’inscrit sur le site ou dans le jeu.
2. L’utilisateur ouvre le widget du programme de parrainage et lit les conditions du programme.
3. L’utilisateur reçoit le lien de parrainage dans le widget.
4. L’utilisateur partage le lien de parrainage avec un autre utilisateur.
5. L’utilisateur ouvre le widget du programme de parrainage et reçoit une récompense si le filleul a suivi le lien de parrainage et rempli les conditions du programme.

Flux du filleul

1. L’utilisateur reçoit un lien de parrainage décrivant les conditions et les récompenses du programme.
2. L’utilisateur suit le lien de parrainage.
3. L’utilisateur s’inscrit sur le site web ou dans le jeu.
4. L’utilisateur effectue son premier achat.
5. L’utilisateur reçoit la récompense.

Comment configurer

Créez un programme de parrainage

1. Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Referral program.

2. Appuyez sur Create referral program.
3. Définissez les paramètres nécessaires :
   • Spécifiez le nom du programme de parrainage ;
   • Entrez la description.

4. Appuyez sur Next.
5. Ajoutez les récompenses que les utilisateurs recevront :

• Pour ajouter une récompense pour le parrain, accédez à la section Reward for inviting players, indiquez les UGS des objets et leur quantité.

• Pour ajouter une récompense pour les filleuls, accédez à la section Reward for invitees, indiquez les UGS des objets et leur quantité.

6. Appuyez sur Next.
7. Vérifiez les paramètres du programme de parrainage et appuyez sur Create.

Modifiez le programme de parrainage

Vous pouvez apporter des modifications au programme de parrainage actif :

• modifier la liste des objets offerts en récompense ;
• modifier les conditions.

1. Accédez au programme de parrainage créé.
2. Cliquez sur Edit.

3. Mettez à jour le texte et/ou la liste des objets des utilisateurs.
4. Appuyez sur Next.
5. Vérifiez les paramètres du programme de parrainage et appuyez sur Create.

Le programme de parrainage modifié est activé par défaut et s’affiche dans la section Referral program. Une fois les modifications enregistrées, les utilisateurs voient les conditions mises à jour du programme et reçoivent les nouvelles récompenses.

Les récompenses que les utilisateurs ont déjà reçues avant la mise à jour des conditions resteront inchangées.

La republication du widget n’est pas requise après la mise à jour des conditions.

Comment afficher

Le programme de parrainage est accessible via un widget. Ajoutez-le à votre site web ou à votre jeu afin de permettre aux utilisateurs de consulter les conditions du programme et d’y participer.

Configurez un widget

1. Sur la page du programme de parrainage créé, appuyez sur Go to customizer.

2. Configurez les composants du widget pour chaque statut. Pour harmoniser le widget avec le design du jeu et du site, personnalisez les fonctionnalités suivantes :
   • l’ensemble d’éléments d’interface ;
   • les couleurs des éléments d’interface ;
   • les textes des boutons et les en-têtes en tenant compte de la localisation ;
   • le type, la couleur et la taille de la police.

3. Configurez la localisation. Tous les textes du widget sont traduits dans les langues du projet spécifiées dans le Compte éditeur dans la section Project settings > General settings > Project languages. Pour modifier les traductions par défaut, cliquez deux fois sur le texte et saisissez vos propres textes.
4. Publiez les modifications
5. Copiez le code du widget dans la fenêtre ouverte et ajoutez-le à votre site web.

Après la publication du widget, vous pouvez revenir à tout moment dans ses paramètres pour y apporter des modifications. Pour les appliquer, republiez le widget.

Ajoutez le code du widget à votre site via le constructeur de site Xsolla.

Si vous implémentez votre propre interface de site, ajoutez le code du widget dans le code de votre site. Si vous utilisez le constructeur de site Xsolla, suivez les étapes suivantes pour ajouter un widget de programme de parrainage à votre site :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.
2. Dans la section Sites, sélectionnez votre site et cliquez sur Open Site Builder.
3. Appuyez sur Add Block.
4. Sélectionnez le bloc Custom code.
5. Ajoutez le code du widget du programme de parrainage.
6. Pour appliquer les modifications, publiez le site web :

1. 1. Dans le coin supérieur droit du constructeur de site, appuyez sur Publish.

1. 2. Sélectionnez les cases à côté des pages que vous souhaitez publier.

1. 3. Vérifiez que le site web est prêt pour la publication, puis cliquez sur Publish.

Intégration dans le jeu ou votre propre site

Pour intégrer le programme de parrainage dans un jeu ou un site web créé sans le constructeur de sites Xsolla, procédez comme suit :

1. Implémentez l’authentification utilisateurs côté widget. L’authentification dans le widget du programme de parrainage repose sur celle du site web dans lequel il est intégré. Deux scénarios sont possibles : l’authentification sur le site web ou directement dans le widget :

1. • Si l'utilisateur se connecte sur le site, passez le jeton d'autorisation utilisateur au widget à l'aide de la méthode onTokenChange(). Lorsque l'utilisateur se déconnecte du système, passez null comme paramètre de la méthode.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant User as Utilisateur
    participant WebShop as Web Shop
    participant Widget as Widget
    User ->> WebShop: Connexion
    activate WebShop
    WebShop ->> Widget: Notification avec jeton
    deactivate WebShop

1. • Si l'utilisateur se connecte via le widget, celui-ci appelle la fonction requestAuth transmise lors de l'initialisation. En réponse, le site doit renvoyer le jeton d'autorisation de l'utilisateur.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant User as Utilisateur
    participant WebShop as Web Shop
    participant Widget as Widget
    User ->> Widget: Connexion
    activate Widget
    Widget ->> WebShop: Demande de connexion
    deactivate Widget
    activate WebShop
    WebShop ->> Widget: token
    deactivate WebShop

Exemple de code pour initialiser le widget :

1window.XESApi.init({
2requestAuth: requestAuth,
3token: getToken()
4})

2. Assurez-vous que les données de référence sont passées correctement.
3. Intégrez le code du widget du programme de parrainage dans l’interface du jeu ou du site web.

Widget API

L’API du widget fournit plusieurs fonctions et méthodes pour authentifier un utilisateur dans le widget :

Statuts du widget

Le widget du programme de parrainage peut afficher différents statuts selon le type d’utilisateur (parrain ou filleul), son statut d’autorisation et le respect des conditions du programme.

L’ensemble des composants du widget comprend des éléments d’interface pour différents statuts. Vous pouvez définir les composants lors de la configuration du widget.

Bouton pour ouvrir le widget :

Statut	Description	À qui s’affiche-t-il	Composants pouvant être modifiés	Image
Voir les détails	Inciter l’utilisateur à participer au programme.	Utilisateurs autorisés ne participant pas encore au programme.	Couleurs de l’arrière-plan et du texte. Texte du bouton d’ouverture du widget et du bouton d’affichage des détails.
En attente d’autorisation	Encourager l’utilisateur à se connecter via le widget.	Utilisateurs non autorisés ayant suivi le lien de parrainage.	Couleurs de l’arrière-plan et du texte. Textes des boutons.
En attente du premier achat	Encourager l’utilisateur à effectuer le premier achat.	Utilisateurs ayant suivi le lien de référence et s’étant connectés au site.	Couleurs de l’arrière-plan et du texte. Textes des boutons.
Réception de la récompense	Encourager l’utilisateur à recevoir sa récompense.	Parrains pouvant recevoir une récompense, car ses filleuls ont rempli les conditions du programme.	Couleurs de l’arrière-plan et du texte. Textes des boutons.
Fermeture du widget	Le widget est ouvert, le bouton s’affiche sous la forme de l’icône ×.	Utilisateurs autorisés ayant ouvert les détails du widget.	Couleurs de l’arrière-plan et du texte. Couleur des boutons.
Par défaut	Le widget est fermé.	Utilisateurs ayant fermé le widget.	Couleurs de l’arrière-plan et du texte. Texte du bouton.

Page du widget pour le parrain :

Description	À qui s’affiche-t-il	Composants pouvant être modifiés	Image
Détails du programme de parrainage. Bouton pour envoyer le lien de parrainage. Liste des récompenses avec statuts : Claimed — le filleul a reçu la récompense ; In progress — le filleul s’est connecté au site, mais n’a pas encore effectué d’achat ; Claim — le filleul s’est connecté au site et a effectué son premier achat. Le parrain peut recevoir une récompense.	Parrain autorisé, dont le filleul a suivi le lien de parrainage et s’est connecté au site.	Couleurs de l’arrière-plan et du texte. Texte du widget, textes des boutons.
Section FAQ	Parrain autorisé ayant cliqué sur le bouton d’informations du programme.	Ajout et suppression de blocs avec des questions. Couleurs de l’arrière-plan et du texte. Contenu des questions et des réponses.

Page du widget pour le filleul :

Description	À qui s’affiche-t-il	Composants pouvant être modifiés	Image
Le texte du widget incite l’utilisateur à effectuer un achat sur le site. Une fois l’achat effectué, l’utilisateur reçoit une notification l’informant qu’il a reçu un bonus.	Utilisateurs ayant suivi le lien de parrainage et s’étant connectés.	Couleurs de l’arrière-plan et du texte. Texte du widget, textes des boutons.