Mit einer CSV- oder XLSX-Datei können Sie mehrere Produkte auf einmal in Positive User importieren. Das ist eine praktische Möglichkeit, Ihre Produktdaten schneller in die Plattform zu übertragen und von Anfang an alles übersichtlich zu halten. In diesem Artikel erfahren Sie, wie Sie Ihre Datei korrekt formatieren und den Import problemlos abschließen.
Wenn Sie mehr über Produkte in Positive User erfahren möchten, lesen Sie diesen Artikel.
Bevor Sie beginnen, stellen Sie sicher, dass Ihre Datei korrekt strukturiert ist und Sie verstehen, wie Daten in Positive User gespeichert werden. Die Plattform verwendet sowohl Standard-Attribute (integrierte Felder wie E-Mail-Adresse oder Telefonnummer) als auch benutzerdefinierte Attribute (Felder, die Sie selbst erstellen).
Standard-Attribute abgleichen: Wenn die Spalten Ihrer Tabelle mit den Standard-Attributen übereinstimmen, können Sie die Datei sofort importieren.
Benutzerdefinierte Attribute erstellen: Wenn Sie zusätzliche Informationen einbeziehen möchten, die standardmäßig nicht unterstützt werden, müssen Sie zunächst die entsprechenden benutzerdefinierten Attribute anlegen. Folgen Sie den Schritten in „Wie man ein benutzerdefiniertes Attribut erstellt".
Datentypen prüfen: Stellen Sie sicher, dass jede Spalte den richtigen Attributwerttyp besitzt. Wenn Sie beispielsweise „Scoring" importieren möchten, muss Ihr Attribut vom Typ Integer sein. Wenn Sie ein „Datum" importieren möchten, legen Sie das Attribut als datetime fest. Weitere Informationen zu den einzelnen Datentypen finden Sie unter „Was ist ein Attribut".
Stellen Sie vor dem Hochladen sicher, dass Ihre Datei korrekt formatiert ist. Falls Sie unsicher sind, wie Ihre Datei aussehen sollte, können Sie eine gebrauchsfertige Vorlage direkt aus der App herunterladen, indem Sie im Bereich „Daten" → „Import" auf die Schaltfläche „xlsx" oder „csv" klicken.
Weitere Tipps zur Datenformatierung finden Sie in unserem dedizierten Artikel.
Pflichtfelder
Für jedes Produkt ist eine eindeutige Kennung erforderlich. Dies kann entweder ein Name oder eine Custom ID sein. Sie können mehrere Produkte mit demselben Namen haben, sofern sie unterschiedliche Custom IDs besitzen.
Das Feld „custom_id" sollte niemals eine einfache Ganzzahl sein. Wir empfehlen dringend, es zu codieren.
Spaltenüberschriften
Fügen Sie in der ersten Zeile Ihrer Datei stets Spaltenüberschriften ein. Versuchen Sie, Ihren Spalten genau die gleichen Namen zu geben wie den bereits in Positive User vorhandenen Attributen. Wenn der Spaltenname mit dem Attributnamen identisch ist, wird das System die Zuordnung während des Imports automatisch vornehmen.
Kodierung
Was ist Kodierung? Die Kodierung teilt dem Computer mit, wie die Textzeichen in Ihrer Datei zu interpretieren sind. Das Standardformat und das am dringendsten empfohlene Format ist UTF-8. Mit UTF-8 stellen Sie sicher, dass Sonderzeichen, Akzente und Symbole korrekt importiert werden und sich nicht in unleserliche Zeichen verwandeln.
Trennzeichen
Was ist ein Trennzeichen? In CSV-Dateien (Comma Separated Values) ist ein Trennzeichen das Satzzeichen, das Ihren Text in einzelne Tabellenspalten unterteilt. Gängige Trennzeichen sind Kommas (,) oder Semikolons (;).
Prüfen Sie, wie Ihre Tabellenkalkulationssoftware die Datei exportiert hat, und stellen Sie sicher, dass Sie wissen, welches Zeichen Ihre Daten trennt.
Felder mit mehreren Werten
Wenn eine Spalte mehrere Werte enthält (z. B. „Tags" oder ein Attribut vom Typ „Feste Auswahl" mit erlaubter Mehrfachauswahl), trennen Sie diese mit dem Pipe-Zeichen: „|"
Beispiel: tag1|tag2|tag3
Wenn Sie aus Excel exportieren, achten Sie darauf, dass Sie für jede Zelle das richtige Datenformat festlegen.
Gehen Sie zu „Daten" → „Importers" und wählen Sie „Import Products".
ODER
Alternativ können Sie den Weg „Daten" → „Produkte" → „Produkte hinzufügen" → „Produkte importieren" wählen.
Laden Sie die Datei hoch oder ziehen Sie sie per drag & drop hinein.
Wählen Sie die passende Kodierung für Ihre Datei aus. (UTF-8 ist die Standardkodierung.)
Wählen Sie das in Ihrer Datei verwendete Trennzeichen aus.
Fügen Sie Tags hinzu, wenn diese auf die Produkte angewendet werden sollen.
In diesem Schritt geht es darum, die Spaltenüberschriften aus Ihrer Datei den vorhandenen Attributen in Positive User zuzuordnen.
Automatische Zuordnung: Wenn der Name der Spalte in Ihrer Datei exakt mit dem Attributnamen im System übereinstimmt, werden sie automatisch zugeordnet.
Manuelle Zuordnung: Für nicht automatisch zugeordnete Spalten wählen Sie einfach das richtige vorhandene Attribut aus dem Dropdown-Menü aus, um sie zu verknüpfen.
Achten Sie darauf, alle Spaltenüberschriften mit Attributen zu verknüpfen! Nicht zugeordnete Spalten werden nicht importiert!
Sobald alle Spalten aus Ihrer Datei mit Attributen abgeglichen sind, klicken Sie auf „Weiter". Sie werden zum Schritt „Bestätigung" weitergeleitet.
Im Schritt „Bestätigung" überprüfen Sie die Zusammenfassung des Imports und bestätigen den Vorgang. Nach der Bestätigung beginnt das System mit der Verarbeitung Ihrer Datei.
Sie können den Importprozess verfolgen und die Endergebnisse im Bereich „Importergebnisse" einsehen, in den Sie automatisch weitergeleitet werden.
Sie können diesen Bereich jederzeit über den Pfad „Daten" → „Importers" → „Importergebnisse" aufrufen.
Hier sehen Sie:
Importstatus (Gestartet/Ausstehend/Abgeschlossen/Archiviert)
Erstellungsdatum
Abgeschlossen am
Typ (welche Art von Daten importiert wurde)
Erstellt von (Nutzer, der die Datei hochgeladen hat)
Dateiname
Zeilen insgesamt (aus Ihrer Datei)
Erfolgreich (endgültige Anzahl der importierten Zeilen)
Fehlgeschlagen (Anzahl der Fehler)
Falls beim Import etwas schiefgeht, klicken Sie auf den Dateinamen, um einen detaillierten Fehlerbericht anzuzeigen.
Um die neu importierten Profile anzusehen, gehen Sie zu „Daten" → „Produkte". Sie können Ihre Datenbank nach bestimmten Attributen oder nach dem beim Import angehängten Tag filtern, um die importierten Daten leicht zu überprüfen.
Sie können denselben Importvorgang nutzen, um bestehende Produkte zu aktualisieren. Damit ein Produkt aktualisiert werden kann, muss das System es anhand des Attributs „custom_id" erkennen.
Denken Sie daran, dass Produkte auch über Produkt Events und Produkt Feed aktualisiert werden können.
