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_idoderemail. - Ein Punktewert pro Zeile. Die Spalte
pointsist 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 |
|---|---|---|
member_id | Bedingt | Die RewardsWP-Mitglieder-ID. Verwenden Sie diese beim Aktualisieren bestehender Mitglieder. |
user_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. |
email | Bedingt | Die E-Mail-Adresse des Mitglieds. Gleicht ein bestehendes Mitglied anhand der E-Mail ab oder erstellt ein neues. |
first_name | Nein | Der Vorname des Mitglieds. Empfohlen für neue Mitglieder. |
last_name | 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
Punkteauf500gesetzt. 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-TToderJJJJ-MM-TT HH:MM:SSfür die Spaltenerstellt_amundläuft_ab_am. - Als CSV speichern. Stellen Sie sicher, dass Ihre Tabellenkalkulation als Standard-
.csv-Datei (Comma Separated Values) exportiert wird, nicht als.xlsxoder.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 |
|---|---|
member_id | Aktualisiert das vorhandene Mitglied mit dieser ID. Wenn kein Mitglied gefunden wird, wird die Zeile übersprungen und als Fehler protokolliert. |
user_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. |
email | 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_idoderemail) in der Zeile member_idstimmt mit keinem vorhandenen Mitglied überein- Ungültiges Datumsformat in
created_atoderexpires_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
Kann ich Mitglieder aus einem anderen Treue-Plugin importieren?
Ja. Exportieren Sie Ihre Daten aus dem anderen Plugin als CSV, formatieren Sie dann die Spalten neu, damit sie der RewardsWP-Vorlage entsprechen. Die wichtigste Anforderung ist, dass jede Zeile mindestens eine Kennung (E-Mail ist normalerweise am einfachsten abzugleichen) und einen Punkte -Wert enthält.
Was passiert, wenn ich eine Zeile mit einer E-Mail importiere, die bereits vorhanden ist?
RewardsWP gleicht die Zeile mit dem vorhandenen Mitglied mit dieser E-Mail-Adresse ab und fügt die Punkte als neuen Eintrag in dessen Verlauf hinzu. Es wird kein doppeltes Mitglied erstellt.
Gibt es eine maximale Dateigröße für den Import?
Das Dateigrößenlimit hängt von der PHP-Konfiguration Ihres Servers ab (insbesondere von den Einstellungen upload_max_filesize und post_max_size). Die meisten Hosting-Umgebungen erlauben mindestens 2 MB, was für Zehntausende von Zeilen ausreicht. Wenn Ihre Datei zu groß ist, versuchen Sie, sie in kleinere Stapel aufzuteilen.
Das ist alles! Das Import-Tool macht es einfach, Mitglieder und Punktestände aus jeder Quelle zu importieren.