Import & Export
Übernimm Mitglieder aus einer anderen Loyalty-App per CSV oder exportiere deine aktuellen Mitglieder als Backup. Beides findest du in den Einstellungen unter Mitglieder-Import & -Export.
Mitglieder-Import & -Export
Mitglieder exportieren
Klicke auf Mitglieder als CSV exportieren, um jedes angemeldete Mitglied als CSV-Datei herunterzuladen. Nutze sie als Backup, um Guthaben in einer Tabelle zu prüfen, oder als Ausgangsvorlage für einen Import — die Exportspalten sind eine Obermenge dessen, was der Importer liest, sodass eine exportierte Datei bearbeitet und unverändert wieder importiert werden kann.
CSV-Format
Der Importer benötigt nur drei Spalten. Zusätzliche Spalten aus einem Export werden ignoriert. Die Kopfzeile ist erforderlich und die Spaltennamen sind nicht case-sensitiv.
| Spalte | Erforderlich | Was es ist |
|---|---|---|
email | Ja | Die E-Mail des Mitglieds. Wird verwendet, um die passende Shopify-Kundin oder den passenden Shopify-Kunden zu finden. |
points | Ja | Eine ganze Zahl ≥ 0. Wird zum Punkteguthaben des Mitglieds (und zur Gesamtbasis). |
tier | Nein | Ein Tier-slug (z. B. gold). Leer lassen, damit die Punkte das Tier bestimmen. |
Der tier-Wert muss ein Tier-slug sein, nicht der Anzeigename — zum Beispiel vip-member, nicht "VIP-Mitglied". Ein Export verwendet bereits slugs, sodass Hin- und Rück-Importe sicher sind.
Eine minimale Importdatei sieht so aus:
email,points,tier
alice@example.com,1200,gold
bob@example.com,350,silver
carol@example.com,0,Was ein Import bewirkt
Für jede Zeile, deren E-Mail zu einer bestehenden Shopify-Kundin oder einem bestehenden Shopify-Kunden passt, wird beim Import:
- Das Mitglied angemeldet — ohne Anmeldebonus, unabhängig von deiner Einstellung für den Anmeldebonus.
- Die Punkte gesetzt auf den CSV-Wert (das ist ein Setzen, kein Hinzufügen).
- Das Tier zugewiesen aus der Spalte
tieroder anhand der Punkte ermittelt, wenn die Spalte leer ist. - Die Punkte auf den Importtag datiert — wenn du also einen rollierenden Verfall (FIFO) nutzt, startet die Uhr ab dem Tag des Imports neu.
Ein Import ist ein vollständiges Ersetzen. Für jede E-Mail, die zu einem bestehenden Mitglied passt, überschreibt der Import dessen aktuelles Guthaben und löscht die bisherige Punkte-Historie (nur als stornierte Zeilen zur Prüfung aufbewahrt). Bereits ausgestellte Rabattcodes sind nicht betroffen. Dies kann nicht rückgängig gemacht werden — importiere für eine einmalige Migration daher, bevor Mitglieder anfangen zu sammeln.
So funktioniert der Abgleich
Mitglieder werden über die E-Mail mit Shopify-Kundinnen und -Kunden abgeglichen. Hat eine E-Mail keine passende Shopify-Kundin oder keinen passenden Shopify-Kunden, wird diese Zeile übersprungen und im Ergebnis aufgeführt — der Import erstellt niemals neue Shopify-Kundinnen oder -Kunden. Die übersprungenen E-Mails werden nach Abschluss des Imports angezeigt, sodass du diese Kundinnen und Kunden in Shopify anlegen und den Import bei Bedarf erneut ausführen kannst.
Tiers nach dem Import
Ein Tier aus der CSV wird sofort angewendet. Gibbond prüft außerdem einmal täglich das Tier jedes Mitglieds anhand deiner Tier-Schwellen, sodass ein Tier letztlich von den Punkten des Mitglieds bestimmt wird. Wenn du ein Tier importierst, für das die Punkte nicht ausreichen, wird es beim nächsten täglichen Lauf mit dem punktebasierten Tier abgeglichen. Damit importierte Tiers stabil bleiben, stelle sicher, dass deine Tier-Schwellen zu den importierten Punkten passen.
Einen Import ausführen
Importe laufen im Hintergrund, sodass du die Seite verlassen kannst, während einer läuft. Ein Status-Banner zeigt den Live-Fortschritt und eine Zusammenfassung nach Abschluss (importiert, übersprungen und etwaige Fehler). Nachdem die Daten geschrieben wurden, aktualisiert Gibbond automatisch das Storefront-Punkteguthaben und das Tier jedes Mitglieds.
| Limit | Wert |
|---|---|
| Maximale Dateigröße | 5 MB |
| Maximale Zeilen pro Import | 10.000 |
| Doppelte E-Mails in einer Datei | Die letzte Zeile für eine E-Mail gewinnt |
Dieselbe Datei erneut auszuführen ist sicher: Da jeder Import ein vollständiges Ersetzen ist, setzt ein erneuter Import die Mitglieder einfach wieder auf die Werte der Datei, statt Punkte aufzustapeln.