Shopify
Connexion par la boutique, règles de récompense sur les achats, commandes issues des achats dans l'application, et FanBase sur votre vitrine.
Connecter Shopify fait trois choses indépendantes : les fans se connectent avec leur compte de boutique, les achats dans votre boutique rapportent de l'XP, de la monnaie ou des objets de collection dans l'application, et les articles achetés avec des points dans l'application deviennent de vraies commandes dans votre boutique.
Connexion
Un fan appuie sur Se connecter avec Shopify. Il est dirigé vers votre boutique par une URL de proxy d'application, qui ressemble à https://yourstore.com/apps/proxy-redirect. Il s'authentifie avec le compte qu'il possède déjà, ou en crée un, puis revient connecté.
Cela fonctionne avec les comptes Shopify standard et avec Shop, la connexion propre à Shopify. Dans les deux cas, le fan arrive sous une seule identité : ses achats et ses points appartiennent à la même personne.
Un point à connaître avant de briefer votre support. Quand un fan crée un tout nouveau compte Shopify pendant ce parcours, Shopify ne le renvoie pas vers votre application ensuite. Il revient sur votre boutique, se connecte une nouvelle fois, et tout fonctionne à partir de là. Les fans qui ont déjà un compte ne voient jamais cela.
Quel compte reçoit un client
La première fois qu'un client se connecte de cette façon, il est associé à un fan par son adresse e-mail. Un client dont l'e-mail appartient déjà à un fan reçoit le compte de ce fan, avec ses points et son historique. Tous les autres reçoivent un nouveau compte, avec cet e-mail.
Que Shopify apparaisse aux côtés de Google, Discord, X et Twitch, ou qu'il les remplace entièrement, se règle communauté par communauté. Certains partenaires font de Shopify le seul moyen d'entrer, de sorte qu'un compte fan et un compte client sont la même chose par construction.
Installation
L'installation passe par une application Shopify personnalisée pour votre boutique : elle tient donc en quelques messages échangés, pas en une fiche à chercher dans un catalogue.
Envoyez-nous votre domaine .myshopify.com
Le domaine d'origine, celui qui se termine par .myshopify.com.
Vous le trouvez dans votre interface d'administration Shopify, sous Settings, puis Domains. L'adresse en .myshopify.com y figure même quand un domaine personnalisé est votre domaine principal.
Votre domaine personnalisé ne fonctionnera pas. L'installation est liée au domaine Shopify d'origine, et se tromper de domaine coûte une semaine plutôt qu'un après-midi.
Nous l'ajoutons à la liste d'autorisation et vous envoyons un lien d'installation
Le lien est propre à votre boutique et expire au bout d'une semaine environ. S'il expire, demandez-en un autre.
Connectez-vous au panneau d'administration avant de cliquer dessus
Ouvrez admin.gamerbase.gg/admin et connectez-vous d'abord, dans le même navigateur. L'installation se termine en vous renvoyant vers le panneau d'administration, ce qui est impossible si vous n'y êtes pas déjà authentifié.
Approuvez les autorisations dans Shopify
Le lien vous amène à l'écran d'autorisation de Shopify. Lisez ce que l'application demande, puis installez-la.
Revenez dans le panneau d'administration
Vous êtes redirigé et l'installation se termine d'elle-même. Rien d'autre à remplir.
Vérifiez
Dans le panneau d'administration, allez dans Settings, puis Automations. Shopify doit apparaître comme connecté. Si ce n'est pas le cas, l'installation n'est pas allée au bout, et la cause habituelle est l'étape trois.
L'environnement de test (sandbox) et la production sont des applications distinctes, et elles ne se croisent pas. Une application sandbox se connecte uniquement à une boutique de développement Shopify, et l'application de production uniquement à votre boutique réelle. Créez une boutique de développement pour vos tests plutôt que de pointer le sandbox vers votre vraie boutique. C'est gratuit et déjà en mode test.
Règles de récompense
Une règle de récompense surveille votre boutique et verse une récompense quand une commande lui correspond. Créez-les dans la section Shopify du panneau d'administration. Chaque règle prend un nom, une description et une récurrence.
| Champ | Ce qu'il fait |
|---|---|
| Nom | Le nom que vous donnez à la règle en interne. |
| Description | À quoi sert la règle, pour la personne qui en héritera. |
| Récurrence | One time (une fois) verse la récompense à un fan donné une seule fois, définitivement. Recurring (récurrent) la verse à chaque commande qui correspond. |
| Récompense | Ce que le fan reçoit. Voir la note sur les types de récompense ci-dessous. |
Il existe trois types de règles.
Achat avec tag
Récompense une commande qui contient des produits portant un tag que vous choisissez. Vous choisissez les tags, et vous choisissez si une commande doit en contenir au moins un, avec any, ou tous, avec all.
C'est ainsi que vous récompensez une catégorie sans lister de produits. Taguez les maillots, écrivez une règle, et chaque maillot que vous ajouterez ensuite sera couvert.
Tout achat
Récompense chaque commande, quel que soit ce qui a été acheté. Le plus simple des trois types, et le bon choix pour « tout achat chez nous rapporte des points ».
Montant dépensé
La récompense est proportionnelle au total de la commande. Vous fixez un taux par unité de la devise de votre boutique, et le versement est égal au taux multiplié par le total de la commande, arrondi à l'entier inférieur. Il n'y a pas de plafond pour une commande aujourd'hui, alors choisissez le taux en pensant à une grosse commande.
Types de récompense
L'XP, votre monnaie dépensable et les objets de collection. Un prix ou une lootbox pour un achat reste une récompense manuelle pour l'instant. Récompenses explique la différence entre les types.
Quand un achat ne rapporte rien
Un fan dit qu'il a acheté quelque chose et n'a rien reçu. Sept points sont vérifiés pour chaque commande, dans l'ordre, et le premier qui échoue est la réponse.
- OK
- OK
- S'arrête ici
- Non atteinte
- Non atteinte
- Non atteinte
- Non atteinte
Deux d'entre eux expliquent presque tous les cas. Soit la règle a été créée après la commande, et les commandes antérieures à une règle ne sont jamais récompensées. Soit le fan a commandé avec un e-mail différent de celui de son compte fan, et l'e-mail est le seul lien entre les deux.
Un remboursement ou une commande annulée ne reprend pas la récompense.
Si votre propre site est construit avec le SDK, afficher à un fan les points qu'un achat lui a rapportés est la seule partie que vos développeurs écrivent. Les récompenses d'achat dans la documentation du SDK décrit cette partie, avec les sept mêmes vérifications vues de leur côté.
Deux points à prévoir
Les commandes créées par des échanges de points dans l'application sont ignorées. Quand un fan achète un article de la boutique avec des points et que la plateforme passe la commande dans votre boutique Shopify, aucune règle ne se déclenche dessus. Sans cela, un fan pourrait dépenser des points pour acheter quelque chose, gagner des points pour cet achat, et recommencer en boucle.
Il n'y a pas de notification dans l'application quand un achat rapporte une récompense. Le solde du fan augmente et rien dans l'application ne dit d'où cela vient. Les partenaires compensent en mentionnant la récompense dans l'e-mail de confirmation de commande Shopify qu'ils envoient déjà. Une notification dans l'application figure sur notre liste.
Sur votre vitrine
En développementLes fonctionnalités FanBase seront disponibles sous forme de blocs que vous ajoutez à votre thème Shopify dans l'éditeur de thème, sans code : les quêtes, le profil et l'avatar d'un fan, et un petit indicateur de compte pour votre en-tête. Un client connecté à votre boutique sera connecté automatiquement à votre communauté, sur vos propres pages, sans seconde connexion.
La première version couvre les quêtes, le profil, l'avatar et l'indicateur. Les blocs pour le classement, la boutique, le battlepass, les événements et le fil d'actualité suivront.
Un changement de la connexion arrive avec elle. L'association d'un client à un fan existant par e-mail ne s'appliquera que sur les boutiques qui utilisent les new customer accounts (nouveaux comptes clients) de Shopify, où un client prouve son adresse avec un code. Avec les classic customer accounts (comptes clients classiques), où un client choisit un mot de passe et où rien ne prouve l'adresse, chaque client recevra son propre compte fan. Si vous utilisez les comptes classiques et voulez que les clients de la boutique et les fans existants coïncident, il vaut la peine de passer aux nouveaux comptes clients dans vos paramètres Shopify, sous Settings puis Customer accounts, avant que les blocs n'arrivent sur votre boutique.
Le déploiement se fait boutique par boutique, en commençant par les communautés pilotes. L'installation se fait depuis un lien, comme la connexion ci-dessus, et ne demande aucune autorisation sur votre boutique. La configuration, les réglages de chaque bloc et la façon de les adapter à votre thème sont dans Blocs pour la vitrine. Demandez à votre contact FanBase où en est votre boutique dans le déploiement.
Dépenser des points dans Shopify
Un fan achète un article de la boutique avec des points dans l'application, et une vraie commande apparaît dans votre Shopify, rattachée à sa fiche client, prête à être traitée comme n'importe quelle autre commande. En ligne depuis le 7 octobre 2026.
Le fan ne paie jamais en argent. La commande arrive dans Shopify déjà marquée comme payée, puisqu'il a payé en points.
Activer la fonction pour un article
Autorisez votre boutique pour les commandes
Créer des commandes demande une autorisation que l'installation d'origine ne demandait pas. Le panneau d'administration affiche un bandeau dans la section Shopify quand votre boutique doit être autorisée à nouveau. C'est une seule approbation dans Shopify, à faire une fois.
Activez Fulfil via Shopify
Sur l'article, activez Fulfil via Shopify (traitement par Shopify). L'interrupteur reste désactivé tant qu'aucune boutique n'est connectée, et il l'indique.
Choisissez le produit et la variante
Choisissez le produit dans votre catalogue Shopify, puis la variante. Le panneau renseigne le titre du produit et le SKU pour que vous puissiez vérifier que vous avez choisi le bon.
Enregistrez
Activer le traitement par Shopify ajoute un e-mail et une adresse de livraison à ce que l'article demande au fan au moment de l'achat. Vous n'avez pas à les ajouter vous-même.
Ce que fait le fan
Il achète l'article avec des points, comme n'importe quel autre. Avant que l'achat soit validé, on lui demande un e-mail et une adresse de livraison, avec un nom pour le colis. S'il les a déjà fournis, ils sont préremplis.
Ce qui arrive dans Shopify
| Sur la commande | Valeur |
|---|---|
| Client | Le fan, retrouvé ou créé à partir de son e-mail |
| Adresse de livraison | L'adresse qu'il a saisie |
| Statut du paiement | Payée |
| Tag | fanbase-redemption |
Le tag vous permet de distinguer ces commandes dans votre interface d'administration Shopify, et il indique à FanBase de ne pas leur appliquer les règles de récompense.
Suivre une commande
Chaque achat dans l'onglet de distribution de la boutique affiche sa commande Shopify et où elle en est. Si la création d'une commande échoue, par exemple parce que Shopify était injoignable, FanBase réessaie de lui-même, et vous pouvez relancer depuis le même onglet. Un fan qui a payé en points ne perd pas l'article à cause d'une tentative échouée.
Trois limites à prévoir
- Un article correspond à une seule variante. Une taille M et une taille L sont deux articles, chacun associé à sa propre variante. Les variantes sur un même article sont en développement.
- Achats en boutique uniquement. Un prix physique gagné dans une quête, un événement ou une lootbox n'est pas envoyé à Shopify. Vous traitez ces envois à la main, comme avant. Voir Prix.
- L'article a son propre stock. La quantité que vous fixez sur l'article est ce qui limite les ventes dans l'application. Fixez-la à ce que vous pouvez réellement expédier.
Combinez cette fonction avec une limite d'achat sur tout ce qui est rare, pour qu'un fan avec un gros solde ne puisse pas tout prendre.
Distribution de codes
En développementDes codes de réduction et des codes cadeaux distribués comme récompense. Voir Récompenses.