Mitglieder und Punkte importieren

Das Import-Tool von RewardsWP ermöglicht es Ihnen, Mitglieder und Punktestände aus einer CSV-Datei zu importieren. Egal, ob Sie von einem anderen Treue-Plugin migrieren, eine bestehende Kundenliste onboarden oder eine Massengutschrift von Punkten anwenden – der dreistufige Import-Workflow erledigt die Hauptarbeit. Nach dem Lesen dieser Anleitung wissen Sie, wie Sie Ihre CSV vorbereiten, Spalten zuordnen, den Import verarbeiten und Fehler beheben.

Bevor Sie beginnen

Das Import-Tool ist in allen RewardsWP-Tarifen verfügbar. Um darauf zuzugreifen, navigieren Sie zu RewardsWP » Tools in Ihrem WordPress-Adminbereich. Der Tab Import ist standardmäßig ausgewählt.

Stellen Sie vor dem Start sicher, dass Sie Folgendes haben:

• Eine CSV-Datei mit Ihren Mitglieder- und Punktedaten. Wenn Sie noch keine haben, laden Sie im nächsten Schritt eine Vorlage herunter.
• Mindestens ein Identifikator pro Zeile, damit RewardsWP weiß, welches Mitglied gutgeschrieben werden soll. Gültige Identifikatoren sind member_id, user_id oder email.
• Ein Punktewert pro Zeile. Die Spalte points ist für jeden Import erforderlich.

Vorlage herunterladen und CSV vorbereiten

Klicken Sie auf dem Import-Tab auf die Schaltfläche Beispiel-CSV herunterladen, um eine vorformatierte CSV-Datei zu erhalten. Die heruntergeladene Datei heißt rewardswp-points-import-template-{DATE}.csv (wobei {DATE} das heutige Datum ist) und enthält alle 16 verfügbaren Spalten als Header.

Verfügbare Spalten

Spalte	Erforderlich	Beschreibung
Mitglieds-ID	Bedingt	Die RewardsWP-Mitglieder-ID. Verwenden Sie diese beim Aktualisieren bestehender Mitglieder.
Benutzer-ID	Bedingt	Die WordPress-Benutzer-ID. Verknüpft das Mitglied mit einem bestehenden WordPress-Konto oder erstellt ein neues Mitglied, wenn keine Übereinstimmung gefunden wird.
E-Mail-Adresse	Bedingt	Die E-Mail-Adresse des Mitglieds. Gleicht ein bestehendes Mitglied anhand der E-Mail ab oder erstellt ein neues.
Vorname	Nein	Der Vorname des Mitglieds. Empfohlen für neue Mitglieder.
Nachname	Nein	Der Nachname des Mitglieds. Empfohlen für neue Mitglieder.
empfehlungscode	Nein	Ein benutzerdefinierter Empfehlungscode für das Mitglied.
Status	Nein	Der Status des Mitglieds (z. B. aktiv, ausgeschlossen).
Punkte	Ja	Die hinzuzufügende Punktzahl. Jede Zeile erstellt einen separaten Punkteintrag.
Typ	Nein	Die Art der Transaktion.
Quelltyp	Nein	Woher die Punkte stammen (z. B. Kauf, manuell).
Quell-ID	Nein	Eine ID, die die Punkte mit einer bestimmten Quelle verknüpft (z. B. eine Bestell-ID).
Punkte-Status	Nein	Der Status des Punkteintrags (z. B. genehmigt, ausstehend).
erstellt_am	Nein	Das Datum, an dem der Punkteintrag erstellt wurde. Empfohlen für historische Importe.
läuft_ab_am	Nein	Wann die Punkte ablaufen.
Notiz_öffentlich	Nein	Eine Notiz, die für das Mitglied in seinem Aktivitätsprotokoll sichtbar ist. Empfohlen für Klarheit.
Notiz_intern	Nein	Eine Notiz nur für Administratoren. Für Mitglieder nicht sichtbar.

Mindestens eine Identifikatorspalte (Mitglieds_ID, Benutzer_ID oder E-Mail) muss zusammen mit der erforderlichen Spalte Punkte vorhanden sein. Sie können jede Kombination der optionalen Spalten einschließen.

Vorbereitung Ihrer Daten

Öffnen Sie die Vorlage in einer Tabellenkalkulationsanwendung und füllen Sie Ihre Daten ein. Einige Tipps:

• Eine Zeile pro Punkteintrag. Wenn Sie einem Mitglied 500 Punkte als einen einzigen Saldo gutschreiben möchten, verwenden Sie eine Zeile mit Punkte auf 500 gesetzt. Wenn Sie seine vollständige Historie mit mehreren Transaktionen importieren möchten, verwenden Sie eine Zeile pro Transaktion.
• Konsistente Identifikatoren verwenden. Wählen Sie einen Identifikatortyp (E-Mail ist normalerweise am einfachsten) und verwenden Sie ihn durchgängig für alle Zeilen.
• Datumsformat. Verwenden Sie JJJJ-MM-TT oder JJJJ-MM-TT HH:MM:SS für die Spalten erstellt_am und läuft_ab_am.
• Als CSV speichern. Stellen Sie sicher, dass Ihre Tabellenkalkulation als Standard-.csv-Datei (Comma Separated Values) exportiert wird, nicht als .xlsx oder .xls.

Spalten hochladen und zuordnen

Laden Sie auf der Registerkarte „Import“ Ihre CSV-Datei über die Dateiauswahl oder den Drag-and-Drop-Bereich hoch. RewardsWP validiert die Datei (CSV-Format erforderlich) und liest die Spaltenüberschriften.

Spaltenzuordnung

Nach dem Hochladen erscheint eine Schnittstelle zur Spaltenzuordnung. RewardsWP erkennt automatisch, welche CSV-Spalten welchen Importfeldern entsprechen, anhand der Spaltenüberschriften. Jede Zuordnung zeigt einen Konfidenzgrad an:

Konfidenz	Bedeutung
Sicher	Die Spaltenüberschrift ist eine exakte oder nahezu exakte Übereinstimmung. Keine Aktion erforderlich.
Mittelmäßig	Die Überschrift ist eine teilweise Übereinstimmung. Überprüfen Sie die Zuordnung, um sicherzustellen, dass sie korrekt ist.
Niedrig	RewardsWP konnte diese Spalte nicht sicher zuordnen. Sie müssen sie manuell über das Dropdown-Menü zuordnen.

Überprüfen Sie jede Zuordnung und verwenden Sie die Dropdown-Menüs, um falsche Zuordnungen zu korrigieren. Nicht zugeordnete Spalten werden beim Import übersprungen.

Vorschau Ihrer Daten

Nach der Zuordnung zeigt ein Vorschaufenster eine Stichprobe Ihrer Daten mit den angewendeten Zuordnungen an. Überprüfen Sie die Vorschau, um sicherzustellen, dass die Werte in den richtigen Spalten gelandet sind, bevor Sie fortfahren.

Import überprüfen und verarbeiten

Wenn Sie mit der Spaltenzuordnung und der Vorschau zufrieden sind, klicken Sie auf die Schaltfläche, um den Import zu starten. RewardsWP verarbeitet die Datei in Stapeln von 50 Datensätzen pro Anfrage, sodass Sie eine Fortschrittsanzeige sehen, die die Anzahl verfolgt, während die Datei verarbeitet wird.

Wie RewardsWP jede Zeile behandelt

Die Importlogik hängt davon ab, welchen Identifikator Sie angegeben haben:

Identifikator angegeben	Was passiert
Mitglieds-ID	Aktualisiert das vorhandene Mitglied mit dieser ID. Wenn kein Mitglied gefunden wird, wird die Zeile übersprungen und als Fehler protokolliert.
Benutzer-ID	Sucht nach einem Mitglied, das mit diesem WordPress-Benutzer verknüpft ist. Wenn gefunden, wird dieses Mitglied aktualisiert. Wenn nicht gefunden, wird ein neues Mitglied erstellt, das mit dem Benutzer verknüpft ist.
E-Mail-Adresse	Sucht nach einem Mitglied mit dieser E-Mail-Adresse. Wenn gefunden, wird dieses Mitglied aktualisiert. Wenn nicht gefunden, wird ein neues Mitglied mit dieser E-Mail erstellt.

Wenn mehrere Identifikatoren in einer einzelnen Zeile vorhanden sind, hat member_id Priorität, gefolgt von user_id, dann email.

Jede Zeile in der CSV erstellt einen separaten Punkteintrag in der Historie des Mitglieds. Wenn eine Zeile optionale Felder wie first_name, last_name oder referral_code enthält, werden diese Werte auch auf den Mitgliedsdatensatz angewendet.

Nach dem Import

Wenn der Import abgeschlossen ist, sehen Sie eine Zusammenfassung, die die Gesamtzahl der verarbeiteten Datensätze, die Anzahl der Erfolge und die Anzahl der Fehler anzeigt.

Wenn Zeilen fehlgeschlagen sind, klicken Sie auf Fehlerbericht herunterladen, um eine CSV-Datei mit jeder fehlgeschlagenen Zeile und dem Grund für die Überspringung zu erhalten. Häufige Gründe sind:

• Fehlender Wert in der erforderlichen Spalte points
• Kein gültiger Identifikator (member_id, user_id oder email) in der Zeile
• member_id stimmt mit keinem vorhandenen Mitglied überein
• Ungültiges Datumsformat in created_at oder expires_at

Sie können die Probleme im Fehlerbericht-CSV beheben und nur die fehlgeschlagenen Zeilen erneut importieren.

Nach einem erfolgreichen Import navigieren Sie zu RewardsWP » Mitglieder, um zu überprüfen, ob Ihre importierten Mitglieder und Punktestände korrekt angezeigt werden.

Häufig gestellte Fragen

---

Das ist alles! Das Import-Tool macht es einfach, Mitglieder und Punktestände aus jeder Quelle zu importieren.