Integrationen

Shopify

Anmeldung über deinen Shopify-Shop, Belohnungsregeln für Käufe, Bestellungen aus Käufen in der App und FanBase in deiner Storefront.

Shopify zu verbinden bewirkt drei voneinander unabhängige Dinge: Fans melden sich mit ihrem Kundenkonto aus deinem Shopify-Shop an, Käufe dort bringen in der App XP, Währung oder Sammelobjekte, und Artikel, die in der App mit Punkten gekauft werden, werden zu echten Bestellungen in deinem Shopify-Shop.

Anmeldung

Ein Fan tippt auf Mit Shopify anmelden. Er gelangt über eine App-Proxy-URL zu deinem Shopify-Shop, die so aussieht: https://yourstore.com/apps/proxy-redirect. Er authentifiziert sich mit dem Konto, das er schon hat, oder legt eins an, und kommt angemeldet zurück.

Das funktioniert mit normalen Shopify-Konten und mit Shop, dem eigenen Login von Shopify. In beiden Fällen kommt der Fan als eine einzige Identität an: Seine Käufe und seine Punkte gehören zu derselben Person.

Eine Sache solltest du wissen, bevor du deinen Support einweist. Wenn ein Fan in diesem Ablauf ein ganz neues Shopify-Konto anlegt, bringt Shopify ihn danach nicht in deine App zurück. Er landet wieder in deinem Shopify-Shop, meldet sich noch einmal an, und ab dann funktioniert alles. Fans, die schon ein Konto haben, bekommen davon nichts mit.

Wessen Konto ein Kunde bekommt

Wenn sich ein Kunde zum ersten Mal auf diesem Weg anmeldet, wird er über die E-Mail-Adresse einem Fan zugeordnet. Ein Kunde, dessen E-Mail-Adresse schon zu einem Fan gehört, bekommt das Konto dieses Fans mit dessen Punkten und Verlauf. Alle anderen bekommen ein neues Konto mit dieser E-Mail-Adresse.

Ob Shopify neben Google, Discord, X und Twitch erscheint oder sie ganz ersetzt, ist eine Einstellung pro Community. Manche Partner nutzen Shopify als einzigen Weg in die App, sodass ein Fan-Konto und ein Kundenkonto von vornherein dasselbe sind.

Installation

Die Installation ist eine benutzerdefinierte Shopify-App für deinen Shopify-Shop. Sie besteht deshalb aus einer Handvoll Nachrichten und nicht aus einem Eintrag im App Store, nach dem du suchst.

Schick uns deine .myshopify.com-Domain

Die ursprüngliche Domain, die auf .myshopify.com endet.

Du findest sie in deinem Shopify-Adminbereich unter Settings, dann Domains. Die .myshopify.com-Adresse ist dort auch dann aufgeführt, wenn eine eigene Domain deine primäre ist.

Deine eigene Domain funktioniert nicht. Die Installation ist an die ursprüngliche Shopify-Domain gebunden, und die falsche kostet eine Woche statt eines Nachmittags.

Der Link gilt nur für deinen Shopify-Shop und läuft nach etwa einer Woche ab. Wenn er abgelaufen ist, frag nach einem neuen.

Melde dich im Admin-Panel an, bevor du darauf klickst

Öffne admin.gamerbase.gg/admin und melde dich zuerst an, im selben Browser. Die Installation endet damit, dass du zurück ins Admin-Panel geleitet wirst, und das geht nicht, wenn du dort nicht schon angemeldet bist.

Genehmige die Berechtigungen in Shopify

Der Link führt dich zum Autorisierungsbildschirm von Shopify. Lies, was die App anfordert, und installiere sie dann.

Du landest wieder im Admin-Panel

Du wirst zurückgeleitet, und die Installation wird von selbst abgeschlossen. Mehr musst du nicht ausfüllen.

Prüfe die Verbindung

Geh im Admin-Panel zu Settings, dann Automations. Shopify sollte als verbunden angezeigt werden. Wenn nicht, wurde die Installation nicht abgeschlossen, und die übliche Ursache ist Schritt drei.

Sandbox und Produktion sind getrennte Apps, und sie überschneiden sich nicht. Eine Sandbox-App verbindet sich nur mit einem Shopify-Entwicklungsshop, und die Produktions-App verbindet sich nur mit deinem Live-Shop. Lege zum Testen einen Entwicklungsshop an, statt die Sandbox mit deinem echten Shopify-Shop zu verbinden. Er ist kostenlos und schon im Testmodus.

Belohnungsregeln

Eine Belohnungsregel beobachtet deinen Shopify-Shop und vergibt eine Belohnung, wenn eine Bestellung zu ihr passt. Du erstellst sie im Shopify-Bereich des Admin-Panels. Jede Regel hat einen Namen, eine Beschreibung und eine Wiederholung.

FeldWas es bewirkt
NameWie du die Regel intern nennst.
BeschreibungWofür die Regel da ist, für alle, die sie später übernehmen.
WiederholungOne time (einmalig) belohnt einen bestimmten Fan ein einziges Mal, für immer. Recurring (wiederkehrend) belohnt bei jeder passenden Bestellung.
BelohnungWas der Fan bekommt. Siehe den Hinweis zu den Belohnungstypen unten.

Es gibt drei Regeltypen.

Kauf mit Tag

Belohnt eine Bestellung, die Produkte mit einem Tag enthält, das du auswählst. Du wählst die Tags und legst fest, ob eine Bestellung mit any mindestens eines davon oder mit all alle enthalten muss.

So belohnst du eine Kategorie, ohne Produkte aufzulisten. Versieh die Trikots mit einem Tag, schreib eine Regel, und jedes Trikot, das du später hinzufügst, ist abgedeckt.

Jeder Kauf

Belohnt jede Bestellung, egal was gekauft wurde. Der einfachste der drei Typen und der richtige für „Jeder Einkauf bei uns bringt Punkte“.

Ausgegebener Betrag

Die Belohnung wächst mit der Bestellsumme. Du legst einen Satz pro Einheit der Währung deines Shopify-Shops fest, und die Belohnung ist der Satz multipliziert mit der Bestellsumme, abgerundet. Für eine einzelne Bestellung gibt es heute keine Obergrenze, also wähle den Satz mit einer großen Bestellung im Hinterkopf.

Belohnungstypen

XP, deine ausgebbare Währung und Sammelobjekte. Ein Preis oder eine Lootbox für einen Kauf ist vorerst eine manuelle Belohnung. Belohnungen erklärt den Unterschied zwischen den Typen.

Wenn ein Kauf nichts bringt

Ein Fan sagt, er habe etwas gekauft und nichts bekommen. Bei jeder Bestellung werden sieben Dinge der Reihe nach geprüft, und das erste, das fehlschlägt, ist die Antwort.

Warum hat dieser Kauf nichts eingebracht?Probier es aus
  1. OK
  2. OK
  3. Stoppt hier
  4. Nicht erreicht
  5. Nicht erreicht
  6. Nicht erreicht
  7. Nicht erreicht
Keine Belohnung. Bei Schritt 3 war Schluss. Wer es behebt: Der Fan: mit der E-Mail-Adresse einkaufen, mit der er spielt.
Klicke auf einen Schritt, um ihn fehlschlagen zu lassen oder zu reparieren. Nur der erste Fehler zählt: Danach wird nichts mehr geprüft.

Zwei davon erklären fast jeden Fall. Die Regel wurde nach der Bestellung erstellt, und Bestellungen aus der Zeit vor einer Regel werden nie belohnt. Oder der Fan hat beim Checkout eine andere E-Mail-Adresse verwendet als die in seinem Fan-Konto, und die E-Mail-Adresse ist das Einzige, was beide verbindet.

Eine Erstattung oder eine stornierte Bestellung nimmt die Belohnung nicht zurück.

Wenn deine eigene Website mit dem SDK gebaut ist, ist die Anzeige der Punkte, die ein Kauf einem Fan gebracht hat, der eine Teil, den deine Entwickler selbst schreiben. Kaufbelohnungen in der SDK-Dokumentation beschreibt das, mit denselben sieben Prüfschritten aus ihrer Sicht.

Zwei Dinge, die du einplanen solltest

Bestellungen, die durch Einlösungen in der App entstehen, werden übersprungen. Wenn ein Fan im Shop der App einen Artikel mit Punkten kauft und die Plattform die Bestellung in deinem Shopify-Shop anlegt, greift dafür keine Regel. Sonst könnte ein Fan Punkte ausgeben, um etwas zu kaufen, für den Kauf Punkte verdienen und das endlos wiederholen.

In der App gibt es keine Benachrichtigung, wenn ein Kauf belohnt wird. Das Guthaben des Fans steigt, und nichts in der App sagt, woher es kommt. Partner lösen das, indem sie die Belohnung in der Bestellbestätigung von Shopify erwähnen, die sie ohnehin per E-Mail verschicken. Eine Benachrichtigung in der App steht auf der Liste.

In deiner Storefront

In Entwicklung

FanBase-Funktionen wird es als Blöcke geben, die du im Theme-Editor ohne Code zu deinem Shopify-Theme hinzufügst: Quests, Profil und Avatar eines Fans und eine kleine Kontoanzeige für deinen Header. Ein Kunde, der in deinem Shopify-Shop angemeldet ist, wird automatisch auch in deiner Community angemeldet, auf deinen eigenen Seiten, ohne zweite Anmeldung.

Die erste Version umfasst Quests, das Profil, den Avatar und die Kontoanzeige. Blöcke für die Rangliste, den Shop, den Battlepass, Events und den Newsfeed folgen.

Damit kommt eine Änderung bei der Anmeldung. Die Zuordnung eines Kunden zu einem bestehenden Fan über die E-Mail-Adresse gilt dann nur noch in Shopify-Shops, die die new customer accounts (neue Kundenkonten) von Shopify nutzen, bei denen ein Kunde seine Adresse mit einem Code nachweist. Bei classic customer accounts (klassische Kundenkonten), bei denen ein Kunde ein Passwort wählt und nichts die Adresse nachweist, bekommt jeder Kunde ein eigenes Fan-Konto. Wenn du klassische Konten nutzt und willst, dass die Kunden deines Shopify-Shops und bestehende Fans zusammenpassen, lohnt es sich, in deinen Shopify-Einstellungen unter Settings, dann Customer accounts auf die neuen Kundenkonten umzustellen, bevor die Blöcke deinen Shopify-Shop erreichen.

Die Einführung läuft schrittweise, ein Shopify-Shop nach dem anderen, und beginnt mit Pilot-Communitys. Die Installation erfolgt über einen Link, wie bei der Verbindung oben, und verlangt keine Berechtigungen für deinen Shopify-Shop. Die Einrichtung, die Einstellungen jedes Blocks und wie du die Blöcke an dein Theme anpasst, findest du unter Storefront-Blöcke. Frag deine Ansprechperson bei FanBase, wo dein Shopify-Shop in der Einführung steht.

Punkte in Shopify ausgeben

Ein Fan kauft in der App einen Artikel mit Punkten, und in deinem Shopify erscheint eine echte Bestellung, die seinem Kundendatensatz zugeordnet ist und die du so abwickeln kannst wie jede andere Bestellung. Live seit dem 7. Oktober 2026.

Dem Fan wird nie Geld berechnet. Die Bestellung kommt in Shopify schon als bezahlt markiert an, weil er mit Punkten bezahlt hat.

Für einen Artikel aktivieren

Autorisiere deinen Shopify-Shop für Bestellungen

Das Anlegen von Bestellungen braucht eine Berechtigung, die bei der ursprünglichen Installation nicht angefragt wurde. Das Admin-Panel zeigt im Shopify-Bereich ein Banner, wenn dein Shopify-Shop neu autorisiert werden muss. Es ist eine einzige Freigabe in Shopify, die du einmal erteilst.

Schalte Fulfil via Shopify ein

Schalte am Artikel Fulfil via Shopify (Abwicklung über Shopify) ein. Der Schalter bleibt aus, bis ein Shopify-Shop verbunden ist, und weist darauf hin.

Wähle Produkt und Variante

Wähle das Produkt aus deinem Shopify-Katalog, dann die Variante. Das Panel trägt Produkttitel und SKU ein, damit du prüfen kannst, ob du das richtige gewählt hast.

Speichern

Wenn du die Abwicklung einschaltest, fragt der Artikel den Fan beim Checkout zusätzlich nach einer E-Mail-Adresse und einer Lieferadresse. Diese Felder fügst du nicht selbst hinzu.

Was der Fan tut

Er kauft den Artikel mit Punkten, wie jeden anderen auch. Bevor der Kauf abgeschlossen wird, wird er nach einer E-Mail-Adresse und einer Lieferadresse gefragt, mit einem Namen für das Paket. Hat er diese Angaben schon einmal gemacht, sind sie bereits ausgefüllt.

Was in Shopify ankommt

In der BestellungWert
KundeDer Fan, über seine E-Mail-Adresse zugeordnet oder neu angelegt
LieferadresseDie Adresse, die er eingegeben hat
ZahlungsstatusBezahlt
Tagfanbase-redemption

An dem Tag erkennst du diese Bestellungen in deinem Shopify-Adminbereich, und daran erkennt FanBase, dass dafür keine Belohnungsregeln laufen sollen.

Eine Bestellung verfolgen

Jeder Kauf im Verteilungs-Tab des Shops zeigt seine Shopify-Bestellung und deren Stand. Schlägt das Anlegen einer Bestellung fehl, zum Beispiel weil Shopify nicht erreichbar war, versucht FanBase es von selbst erneut, und du kannst es im selben Tab noch einmal anstoßen. Ein Fan, der mit Punkten bezahlt hat, verliert den Artikel nicht wegen eines fehlgeschlagenen Versuchs.

Drei Grenzen, die du einplanen solltest

  • Ein Artikel ist eine Variante. Größe M und Größe L sind zwei Artikel, jeder seiner eigenen Variante zugeordnet. Varianten an einem einzelnen Artikel sind in Entwicklung.
  • Nur Käufe im Shop der App. Ein physischer Preis, der in einer Quest, einem Event oder einer Lootbox gewonnen wurde, wird nicht an Shopify gesendet. Solche Preise verschickst du wie bisher von Hand. Siehe Individuelle Belohnungen.
  • Der Artikel hat seinen eigenen Bestand. Die Menge, die du am Artikel einstellst, begrenzt die Verkäufe in der App. Stell sie auf das ein, was du tatsächlich versenden kannst.

Kombiniere das bei allem, was knapp ist, mit einem Kauflimit, damit ein einzelner Fan mit großem Guthaben nicht alles abräumen kann.

Code-Verteilung

In Entwicklung

Rabatt- und Geschenkcodes, die als Belohnung vergeben werden. Siehe Individuelle Belohnungen.

Auf dieser Seite