Programme de parrainage

Un programme de parrainage permet d’attirer de nouveaux utilisateurs en incitant les utilisateurs existants à inviter leurs amis à se rendre sur le Web Shop via un lien spécial. Chaque participant au programme reçoit des récompenses, ce qui renforce leur fidélité et leur motivation à continuer d’interagir avec le Web Shop.

Le programme de parrainage permet aux influenceurs et aux chefs de clan de promouvoir le Web Shop pour leur bénéfice et celui de leurs abonnés. Les filleuls reçoivent une récompense pour leur premier achat, ce qui augmente le nombre d’utilisateurs engagés effectuant des achats dans le Web Shop.

• Offrir en récompense un ou plusieurs des types de biens suivants :
  • monnaie virtuelle ;
  • objet virtuel ;
  • lot d’objets.
• Personnalisation du widget du programme de parrainage.
• Génération de liens de parrainage.
• Possibilité pour le filleul 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 du parrain

1. Le parrain se rend dans le Web Shop.
2. Le parrain se connecte ou s’inscrit sur le site.
3. Le parrain ouvre le widget du programme de parrainage et lit les conditions du programme.
4. Le parrain reçoit le lien de parrainage dans le widget.
5. Le parrain partage le lien avec le filleul.
6. Le filleul suit le lien et remplit les conditions du programme.
7. Le parrain ouvre le widget du programme de parrainage et clique sur le bouton pour recevoir la récompense.

Flux du filleul

1. Le filleul reçoit un lien de parrainage décrivant les conditions et les récompenses du programme.
2. Le filleul se rend sur le Web Shop via le lien de parrainage.
3. Le filleul s’inscrit dans le Web Shop.
4. Le filleul effectue son premier achat dans le Web Shop.
5. Le filleul reçoit la récompense.

Comment configurer

Créer un programme de parrainage

1. Ouvrez votre projet dans le Compte éditeur.
2. Cliquez sur Store dans le menu latéral.
3. Dans le volet Live-ops and promotion tools, cliquez sur :
   • Connect — si vous n’avez pas encore de promotions ou de récompenses ;
   • Configure — si vous avez déjà connecté des promotions ou des récompenses.

4. Dans l’onglet Referral program, cliquez sur Create referral program.
5. Définissez les paramètres nécessaires :
   • Spécifiez le nom du programme de parrainage ;
   • Entrez la description.

6. Cliquez sur Next.
7. Ajoutez les récompenses que le parrain et le filleul recevront :
   • Pour ajouter une récompense pour le parrain, dans la section Reward for inviting players, indiquez les UGS des objets et leur quantité ;
   • Pour ajouter une récompense pour le filleul, dans la section Reward for invitees, indiquez les UGS des objets et leur quantité.

8. Cliquez sur Next.
9. Vérifiez la description du programme de parrainage et cliquez sur Create.

10. Pour activer le programme de parrainage, réglez la bascule Referral program sur On.

Après la mise en place du programme de parrainage, créez et personnalisez le widget.

Configuration du widget

1. Sur la page du programme de parrainage, cliquez sur Go to customizer.

2. Configurez les composants du widget pour un ensemble de statuts. Pour harmoniser le widget avec le design du jeu et du site, personnalisez les caractéristiques 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.

Dans les paramètres du widget, vous pouvez également personnaliser le contenu de la section FAQ du programme de parrainage en fonction des particularités de votre jeu.

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 traductions.
4. Cliquez sur Publish.
5. Copiez le code du widget dans la fenêtre ouverte et ajoutez-le à votre site Web.

Après l’ajout du code du widget au site, le bouton d’ouverture du widget s’affiche sur la page :

Ajouter un code de widget au site

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Site Builder.
3. Dans la section Sites, sélectionnez votre site et cliquez sur Open Site Builder.
4. Cliquez sur Add Block.
5. Sélectionnez le bloc Custom code.
6. Ajoutez le code du widget du programme de parrainage.

Configuration de l'autorisation

Si vous utilisez votre propre interface de site, implémentez la fonctionnalité d’autorisation utilisateur dans le widget de votre côté.

L’autorisation dans le widget s’effectue par le biais de l’autorisation sur le site où il est intégré.

Il existe deux scénarios selon l’endroit où l’utilisateur s’authentifie, sur le site ou dans le widget :

• Si l’utilisateur s’autorise 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, passeznull comme paramètre de la méthode.

• Si l’utilisateur s’autorise via le widget, ce dernier appellera la fonction requestAuth, fournie lors de son initialisation. En réponse, le site doit retourner le jeton d’autorisation utilisateur.

window.XESApi.init({
requestAuth: requestAuth,
token: getToken()
})

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

Comment apporter des modifications

Modifier les paramètres du programme de parrainage

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

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

3. Mettez à jour le texte ou les UGS des objets.
4. Cliquez sur Save.

Une fois les modifications enregistrées, les utilisateurs verront les conditions mises à jour du programme et recevront 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.

Modifier les paramètres du widget

1. Accédez aux paramètres du widget.
2. Apportez les modifications nécessaires.
3. Cliquez sur Publish.

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’est transformé en 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 des questions fréquemment posées	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.