Shopify
Inloggen via je webshop, beloningsregels voor aankopen, bestellingen uit aankopen in de app en FanBase in je webshop.
Shopify koppelen doet drie dingen die los van elkaar staan: fans loggen in met hun webshopaccount, aankopen in je webshop leveren XP, valuta of verzamelobjecten in de app op, en artikelen die in de app met punten worden gekocht, worden echte bestellingen in je Shopify-winkel.
Inloggen
Een fan tikt op Inloggen met Shopify. De fan gaat naar je webshop via een app-proxy-URL, die eruitziet als https://yourstore.com/apps/proxy-redirect. Daar logt de fan in met het account dat er al is, of maakt er een aan, en komt ingelogd terug.
Het werkt met standaard Shopify-accounts en met Shop, de eigen login van Shopify. In beide gevallen komt de fan binnen als één identiteit: de aankopen en de punten horen bij dezelfde persoon.
Eén ding om te weten voordat je support inlicht. Als een fan tijdens deze flow een gloednieuw Shopify-account aanmaakt, stuurt Shopify die fan daarna niet terug naar je app. De fan komt weer in je webshop terecht, logt nog één keer in, en vanaf dan werkt alles. Fans die al een account hebben, zien dit nooit.
Welk account een klant krijgt
De eerste keer dat een klant op deze manier inlogt, wordt die op basis van het e-mailadres aan een fan gekoppeld. Een klant van wie het e-mailadres al bij een fan hoort, krijgt het account van die fan, met de punten en de geschiedenis. Alle anderen krijgen een nieuw account met dat e-mailadres.
Of Shopify naast Google, Discord, X en Twitch staat of ze volledig vervangt, wordt per community ingesteld. Sommige partners gebruiken Shopify als enige ingang, zodat een fanaccount en een klantaccount per definitie hetzelfde zijn.
Installeren
De installatie verloopt via een aangepaste app voor jouw Shopify-winkel. Het gaat dus om een handvol berichten heen en weer, niet om een app die je in een catalogus opzoekt.
Stuur ons je .myshopify.com-domein
Het oorspronkelijke domein, dat eindigt op .myshopify.com.
Je vindt het in je Shopify-beheeromgeving onder Settings, daarna Domains. Het adres op .myshopify.com staat daar ook als een eigen domein je primaire domein is.
Je eigen domein werkt niet. De installatie is gekoppeld aan het oorspronkelijke Shopify-domein, en het verkeerde domein kost je een week in plaats van een middag.
Wij zetten het op de toegestane lijst en sturen je een installatielink
De link is uniek voor jouw Shopify-winkel en verloopt na ongeveer een week. Als hij is verlopen, vraag dan een nieuwe aan.
Log in op het beheerpaneel voordat je erop klikt
Open admin.gamerbase.gg/admin en log eerst in, in dezelfde browser. De installatie eindigt door je terug te sturen naar het beheerpaneel, en dat lukt niet als je daar nog niet bent ingelogd.
Keur de machtigingen goed in Shopify
De link brengt je naar het autorisatiescherm van Shopify. Lees waar de app om vraagt en installeer hem dan.
Keer terug naar het beheerpaneel
Je wordt teruggestuurd en de installatie wordt vanzelf afgerond. Je hoeft verder niets in te vullen.
Controleer het
Ga in het beheerpaneel naar Settings, daarna Automations. Shopify moet daar als verbonden staan. Is dat niet zo, dan is de installatie niet afgerond, en de gebruikelijke oorzaak is stap drie.
De testomgeving (sandbox) en productie zijn aparte apps, en ze lopen niet door elkaar. Een sandbox-app maakt alleen verbinding met een ontwikkelwinkel van Shopify, en de productie-app alleen met je live Shopify-winkel. Maak een ontwikkelwinkel aan om te testen in plaats van de sandbox op je echte Shopify-winkel te richten. Dat is gratis en staat al in de testmodus.
Beloningsregels
Een beloningsregel houdt je Shopify-winkel in de gaten en keert uit wanneer een bestelling eraan voldoet. Je maakt ze aan in het Shopify-gedeelte van het beheerpaneel. Elke regel krijgt een naam, een beschrijving en een herhaling.
| Veld | Wat het doet |
|---|---|
| Naam | Hoe je de regel intern noemt. |
| Beschrijving | Waar de regel voor dient, voor wie hem later overneemt. |
| Herhaling | One time (eenmalig) keert één keer uit aan een bepaalde fan, voor altijd. Recurring (terugkerend) keert uit bij elke bestelling die voldoet. |
| Beloning | Wat de fan krijgt. Zie de opmerking over typen beloning hieronder. |
Er zijn drie typen regels.
Aankoop met tag
Beloont een bestelling met producten die een tag hebben die jij kiest. Je kiest de tags, en je kiest of een bestelling aan minstens één ervan moet voldoen, met any, of aan allemaal, met all.
Zo beloon je een categorie zonder producten op te sommen. Tag de shirts, schrijf één regel, en elk shirt dat je later toevoegt, valt eronder.
Elke aankoop
Beloont elke bestelling, wat er ook is gekocht. De eenvoudigste van de drie, en de juiste voor ‘elke aankoop bij ons levert punten op’.
Besteed bedrag
De beloning groeit mee met het totaalbedrag van de bestelling. Je stelt een tarief in per eenheid van de valuta van je Shopify-winkel, en de uitkering is het tarief maal het totaalbedrag van de bestelling, naar beneden afgerond. Er is op dit moment geen maximum voor één bestelling, dus kies het tarief met een grote bestelling in gedachten.
Typen beloning
XP, je uitgeefbare valuta en verzamelobjecten. Een prijs of een lootbox voor een aankoop is voorlopig een handmatige beloning. Beloningen legt het verschil tussen de typen uit.
Als een aankoop niets oplevert
Een fan zegt iets te hebben gekocht en niets te hebben gekregen. Voor elke bestelling worden zeven dingen gecontroleerd, op volgorde, en het eerste dat niet klopt, is het antwoord.
- OK
- OK
- Stopt hier
- Niet bereikt
- Niet bereikt
- Niet bereikt
- Niet bereikt
Twee ervan verklaren bijna elk geval. De regel is na de bestelling aangemaakt, en bestellingen van vóór een regel worden nooit beloond. Of de fan heeft afgerekend met een ander e-mailadres dan dat van het fanaccount, en het e-mailadres is het enige dat de twee verbindt.
Bij een terugbetaling of een geannuleerde bestelling wordt de beloning niet teruggenomen.
Als je eigen site met de SDK is gebouwd, is het tonen van de punten die een aankoop een fan heeft opgeleverd het enige deel dat je ontwikkelaars zelf schrijven. Aankoopbeloningen in de SDK-documentatie beschrijft dat, met dezelfde zeven controles vanuit hun kant.
Twee dingen om rekening mee te houden
Bestellingen die ontstaan door punten in de app in te wisselen, worden overgeslagen. Als een fan een artikel uit de winkel met punten koopt en het platform de bestelling in je Shopify-winkel plaatst, wordt daarvoor geen regel geactiveerd. Anders zou een fan punten kunnen uitgeven om iets te kopen, punten verdienen met die aankoop, en zo eindeloos doorgaan.
Er is geen melding in de app wanneer een aankoop iets oplevert. Het saldo van de fan gaat omhoog en niets in de app zegt waar dat vandaan komt. Partners lossen dit op door de beloning te noemen in de bevestigingsmail van de Shopify-bestelling die ze toch al versturen. Een melding in de app staat op de lijst.
In je webshop
In ontwikkelingFuncties van FanBase komen beschikbaar als blokken die je in de thema-editor aan je Shopify-thema toevoegt, zonder code: quests, het profiel en de avatar van een fan, en een kleine accountindicator voor je header. Een klant die in je webshop is ingelogd, wordt automatisch ingelogd bij je community, op je eigen pagina's, zonder tweede login.
De eerste release bevat quests, het profiel, de avatar en de indicator. Blokken voor de ranglijst, de winkel, de battlepass, evenementen en de nieuwsfeed volgen.
Daarmee komt er één wijziging in het inloggen. Een klant op basis van het e-mailadres aan een bestaande fan koppelen gebeurt dan alleen nog in Shopify-winkels die de new customer accounts (nieuwe klantaccounts) van Shopify gebruiken, waarbij een klant het adres met een code bewijst. Bij classic customer accounts (klassieke klantaccounts), waarbij een klant een wachtwoord kiest en niets het adres bewijst, krijgt elke klant een eigen fanaccount. Gebruik je klassieke accounts en wil je dat klanten van je webshop en bestaande fans op elkaar aansluiten, dan loont het om in je Shopify-instellingen, onder Settings en daarna Customer accounts, over te stappen op nieuwe klantaccounts voordat de blokken je webshop bereiken.
De uitrol gaat per Shopify-winkel en begint bij pilotcommunity's. Je installeert het via een link, net als de koppeling hierboven, en er worden geen machtigingen op je Shopify-winkel gevraagd. De installatie, de instellingen van elk blok en hoe je ze aan je thema aanpast, staan in Blokken voor de webshop. Vraag je contactpersoon bij FanBase waar jouw Shopify-winkel in de uitrol staat.
Punten uitgeven in Shopify
Een fan koopt in de app een artikel uit de winkel met punten, en er verschijnt een echte bestelling in je Shopify, gekoppeld aan het klantprofiel van die fan, klaar om af te handelen zoals je elke andere bestelling afhandelt. Live sinds 7 oktober 2026.
De fan betaalt nooit met geld. De bestelling komt in Shopify binnen als al betaald, omdat er met punten is betaald.
Aanzetten voor een artikel
Autoriseer je Shopify-winkel voor bestellingen
Voor het aanmaken van bestellingen is een machtiging nodig waar de oorspronkelijke installatie niet om vroeg. Het beheerpaneel toont een banner in het Shopify-gedeelte wanneer je Shopify-winkel opnieuw moet worden geautoriseerd. Het is één goedkeuring in Shopify, die je één keer geeft.
Zet Fulfil via Shopify aan
Zet bij het artikel Fulfil via Shopify (afhandelen via Shopify) aan. De schakelaar blijft uit totdat er een Shopify-winkel is gekoppeld, en geeft dat ook aan.
Kies het product en de variant
Kies het product uit je Shopify-catalogus en daarna de variant. Het paneel vult de producttitel en de SKU in, zodat je kunt controleren of je de juiste hebt gekozen.
Sla op
Als je de afhandeling aanzet, worden een e-mailadres en een verzendadres toegevoegd aan wat het artikel bij het afrekenen van een fan vraagt. Die voeg je niet zelf toe.
Wat de fan doet
De fan koopt het artikel met punten, net als elk ander artikel. Voordat de aankoop doorgaat, wordt om een e-mailadres en een verzendadres gevraagd, met een naam voor de zending. Als de fan die eerder heeft opgegeven, zijn ze al ingevuld.
Wat er in Shopify binnenkomt
| Op de bestelling | Waarde |
|---|---|
| Klant | De fan, gevonden of aangemaakt op basis van het e-mailadres |
| Verzendadres | Het adres dat de fan heeft ingevuld |
| Betaalstatus | Betaald |
| Tag | fanbase-redemption |
Aan de tag herken je deze bestellingen in je Shopify-beheeromgeving, en zo weet FanBase dat er geen beloningsregels op moeten worden toegepast.
Een bestelling volgen
Elke aankoop op het distributietabblad van de winkel toont de bijbehorende Shopify-bestelling en de status ervan. Als het aanmaken van een bestelling mislukt, bijvoorbeeld omdat Shopify onbereikbaar was, probeert FanBase het vanzelf opnieuw, en je kunt het ook zelf opnieuw proberen vanaf hetzelfde tabblad. Een fan die met punten heeft betaald, raakt het artikel niet kwijt door een mislukte poging.
Drie beperkingen om rekening mee te houden
- Eén artikel is één variant. Een medium en een large zijn twee artikelen, elk gekoppeld aan een eigen variant. Varianten op één artikel zijn in ontwikkeling.
- Alleen aankopen in de winkel. Een fysieke prijs die is gewonnen met een quest, een evenement of een lootbox, wordt niet naar Shopify gestuurd. Die handel je met de hand af, zoals voorheen. Zie Aangepaste beloningen.
- Het artikel heeft een eigen voorraad. Het aantal dat je bij het artikel instelt, begrenst de verkoop in de app. Stel het in op wat je echt kunt verzenden.
Combineer dit met een aankooplimiet op alles wat schaars is, zodat één fan met een groot saldo niet alles kan meenemen.
Codes uitdelen
In ontwikkelingKortingscodes en cadeaucodes die als beloning worden uitgedeeld. Zie Aangepaste beloningen.