Daten per Datei, URL-Feed, SFTP oder API einspeisen – Vorlagen, Formatregeln, Spaltenzuordnung, SFTP-Dateiablage und Fehlerbehebung.
27 min readUpdated 41 Minuten ago
Daten in Personyze einspeisen
Wo Daten jetzt liegen. Jede Art von Daten hat im Panel ihren eigenen Bildschirm, und jeder davon öffnet denselben Assistenten Daten aus einer Datei oder einem Feed importieren (die Katalogbildschirme zeigen ihn als Abschnitt Inbound pipelines). Gehen Sie zum Bildschirm für das, was Sie laden:
Was Sie hochladen
Wo Sie es hochladen
Produktkatalog (für Produktempfehlungen) — einschließlich Produktinteressen / Affinitäts-Tags als Spalten
Die Bildschirme unter Empfehlungen erscheinen, sobald in Ihrem Konto Produkte oder Artikel aktiviert sind. Assistent, Übertragungswege und Formatregeln sind auf jedem Bildschirm identisch — diese Seite ist die gemeinsame Referenz; nur die Spalten unterscheiden sich.
Der Assistent Daten aus einer Datei oder einem Feed importieren (Schritt 1, Upload-Quelle): Wählen Sie eine Datei, einen URL-Feed, SFTP oder die JSON-API. Auf jedem Datenbildschirm ist es derselbe Assistent. Zum Vergrößern klicken.
Fast alles, worauf Personyze personalisiert, lässt sich als Datendatei einspeisen — ein Produktkatalog für Empfehlungen, ein Inhaltskatalog für Artikelempfehlungen, Produktinteressen für Cross-Selling und Affinitäts-Targeting, Nutzerlisten aus Ihrem CRM und mehr. Alle laufen durch denselben Assistenten Daten aus einer Datei oder einem Feed importieren; nur die Spalten unterscheiden sich.
Diese Seite behandelt, wie die Datei hineinkommt — die Übertragungswege, die Formatregeln, über die man stolpert, und den Zuordnungsschritt —, mit echten, praxiserprobten Beispielen.
Eine Vorlagendatei herunterladen
Beginnen Sie mit einer fertigen Datei statt mit einer leeren Seite. Jede Vorlage hat die richtigen Kopfzeilen, die richtige Anführungszeichensetzung und einige Beispielzeilen genau im Format, das der Importer erwartet — ersetzen Sie die Beispielzeilen durch Ihre eigenen Daten und laden Sie hoch. Alle nutzen Platzhalter-URLs example.com und allgemeine Demoprodukte.
Feed
Spalten
Download
Produktkatalog Für Produktempfehlungen — die Kernspalten.
Internal ID, SKU, Title, Product Page URL, Main Image URL, Price, Sale Price, Is in Stock, Rating, Category, Brand
Die .tsv -Vorlage wird als .txt heruntergeladen (Tabs bleiben erhalten) — benennen Sie sie in .tsv um, wenn Ihre Tools das erwarten, oder laden Sie sie unverändert hoch.
Lieber durchklicken? Hier ist der ganze Ablauf — Quelle wählen, Datei formatieren, Spalten zuordnen, importieren. Die ausführliche Referenz folgt unten.
Einen Feed hochladen
Wählen, wie die Daten ankommen
Gehen Sie zum Bildschirm für das, was Sie laden — Einstellungen → Empfehlungen → Produktkatalog / Artikelkatalog / Produkt-Tracking oder Einstellungen → Besucherattribute —, und öffnen Sie Daten aus einer Datei oder einem Feed importieren. Wählen Sie eine Quelle: eine Datei hochladen (einmalig), einen URL-/RSS-/Atom-Feed oder SFTP (laufend synchronisiert) oder die JSON-API (Echtzeit). Überall derselbe Assistent — nur die Felder unterscheiden sich.
💡 Eine Datei ist eine Momentaufnahme; ein URL-/SFTP-/API-Feed synchronisiert nach Zeitplan immer wieder neu.
Die Datei formatieren
Der Importer ist kommagetrennt. Jede Zelle, die selbst ein Komma enthält — eine Liste von Interessen, mehrere Kategorien —, muss in doppelte Anführungszeichen gesetzt werden, sonst zerfällt sie in zusätzliche Spalten. Alles andere ist einfaches CSV.
💡 Die Zahl „Detected N columns“ im nächsten Schritt ist Ihre Kontrolle des Parsens — vertrauen Sie ihr mehr als dem Aussehen der Datei in Excel.
Die Spalten zuordnen
Ordnen Sie jede erkannte Spalte einem Personyze-Feld zu. Ein Schlüssel ist Pflicht — eine Interne ID (oder SKU / Produktseiten-URL). Ordnen Sie den Rest den passenden Feldern zu; ergänzen Sie optional Vorverarbeitung oder eine Maske, um einen Wert beim Einlesen zu bereinigen.
💡 Der Schlüssel muss dem entsprechen, wie Ihr Katalog geschlüsselt ist. „Importiert problemlos, passt aber auf nichts“ ist fast immer ein nicht passender Schlüssel.
Prüfen & importieren
Bestätigen Sie die Zuordnung und starten Sie den Import. Eine Datei lädt einmal; ein URL-, SFTP- oder API-Feed synchronisiert von hier an weiter — er wird etwa alle paar Minuten neu gelesen, damit Bestand, Preise und neue Datensätze aktuell bleiben.
Fertig ✓
Wählen, wie die Daten ankommen
Gehen Sie zum Bildschirm für das, was Sie laden — Einstellungen → Empfehlungen → Produktkatalog / Artikelkatalog / Produkt-Tracking oder Einstellungen → Besucherattribute —, und öffnen Sie Daten aus einer Datei oder einem Feed importieren. Wählen Sie eine Quelle: eine Datei hochladen (einmalig), einen URL-/RSS-/Atom-Feed oder SFTP (laufend synchronisiert) oder die JSON-API (Echtzeit). Überall derselbe Assistent — nur die Felder unterscheiden sich.
💡 Eine Datei ist eine Momentaufnahme; ein URL-/SFTP-/API-Feed synchronisiert nach Zeitplan immer wieder neu.
Die Datei formatieren
Der Importer ist kommagetrennt. Jede Zelle, die selbst ein Komma enthält — eine Liste von Interessen, mehrere Kategorien —, muss in doppelte Anführungszeichen gesetzt werden, sonst zerfällt sie in zusätzliche Spalten. Alles andere ist einfaches CSV.
💡 Die Zahl „Detected N columns“ im nächsten Schritt ist Ihre Kontrolle des Parsens — vertrauen Sie ihr mehr als dem Aussehen der Datei in Excel.
Die Spalten zuordnen
Ordnen Sie jede erkannte Spalte einem Personyze-Feld zu. Ein Schlüssel ist Pflicht — eine Interne ID (oder SKU / Produktseiten-URL). Ordnen Sie den Rest den passenden Feldern zu; ergänzen Sie optional Vorverarbeitung oder eine Maske, um einen Wert beim Einlesen zu bereinigen.
💡 Der Schlüssel muss dem entsprechen, wie Ihr Katalog geschlüsselt ist. „Importiert problemlos, passt aber auf nichts“ ist fast immer ein nicht passender Schlüssel.
Prüfen & importieren
Bestätigen Sie die Zuordnung und starten Sie den Import. Eine Datei lädt einmal; ein URL-, SFTP- oder API-Feed synchronisiert von hier an weiter — er wird etwa alle paar Minuten neu gelesen, damit Bestand, Preise und neue Datensätze aktuell bleiben.
Fertig ✓
Jeder Katalog auf einem Bildschirm, jeder mit eigenem Status, eigener letzter Synchronisierung und eigenem Zugang. Optionale sind als solche gekennzeichnet. Zum Vergrößern klicken.
Der Katalogbildschirm und was er Ihnen sagt
Einstellungen → Empfehlungen → Produktkatalog (und Artikelkatalog für
Inhalte) ist kein einzelnes Upload-Formular mehr. Er ist eine Übersicht aller Kataloge, die die Engine speisen, jeder mit eigenem
Zustand; „Sind meine Daten drin?“ beantworten Sie also durch Hinsehen statt durch einen erneuten Import:
Zeile
Was sie enthält
Aktive Feeds
Was den Katalog synchron hält und ob er In Ordnung ist.
Produktkatalog
Die Artikel selbst, mit Letzte Synchronisierung.
Interessen
Produkte nach Themen gruppieren.
Kategorien
Die Stöberpfade, die Besucher nehmen.
Manual cross-sell / up-sell links
Paare, die Sie selbst festlegen, per Datei oder von Hand.
System-generated cross-sell
Seed-Daten, die die Engine anlernen, bis Live-Kaufdaten übernehmen.
Jede Zeile hat ihren eigenen Status — In Ordnung, Konfiguriert, Nicht gesetzt, Nicht
konfiguriert —, und alles außer dem Katalog selbst ist als optional markiert; eine Ersteinrichtung
sieht also, was wirklich nötig ist.
Daten erreichen jeden davon auf dieselben vier Wege: Datei-Upload, URL-Feed, SFTP oder REST-API. Jede
Zeile bietet ihr eigenes Upload file or set RSS/Atom feed; Sie müssen also nicht herausfinden, zu welchem Bildschirm ein bestimmter
Katalog gehört.
Zwei Schlüssel, nicht einer
Produkte lassen sich bis zu zwei Schlüsseln zuordnen — Interne ID und SKU —, sodass Ereignisse auf der Website
zurückfinden, egal welche Kennung Ihre Website sendet. Eigene Felder lassen sich jederzeit hinzufügen; nichts muss
vorab deklariert werden.
Welche Spalte ist Ihre Interne ID?
Das falsch zu machen, ist der teuerste einzelne Fehler in einem Feed: Der Katalog füllt sich, die Empfehlungen werden gerendert,
und nichts passt zu dem, was Besucher tatsächlich angesehen haben. Der Importer beantwortet die Frage deshalb mit Belegen statt mit einer Vermutung.
Er vergleicht jede Kandidatenspalte mit den IDs, die Ihre Website bereits sendet, und meldet, was er
gemessen hat — “matches 96% of the ids your site already sends”, “none of these values
appear in what your site sends”, “checked across the first 500 rows”. Spalten, die gar kein Schlüssel
sein können — in jeder Stichprobenzeile leer, in manchen Zeilen fehlend, identisch mit einer anderen Spalte —, werden
entsprechend markiert.
Sind noch keine Ereignisse angekommen, weicht er aus und sagt, auf welcher Stufe er steht:
Gemessen an echten Ereignissen — die Antwort, der Sie vertrauen können.
Auf der Artikelseite gefunden — “no events have arrived yet, so we read one of your item
pages instead”.
Beste Schätzung allein aus der Form der Datei — und er sagt das auch: “check it against
what your site sends”.
{W}Ordnen Sie neben der ID auch die URL zu. Der Berater empfiehlt beides — “Map both: this as
Internal ID and that as Product Page URL” —, weil beide unterschiedliche Aufgaben haben. Die ID tragen
Warenkorb- und Kaufereignisse; die URL sorgt dafür, dass eine Landingpage überhaupt als Produktseite erkannt wird.
Ordnen Sie nur die ID zu, hat das Targeting nach Produktseiten nichts, worauf es passen könnte.
Vor dem Import ansehen
Die Zusammenfassung Bereit zum Import enthält Änderungen vorab prüfen — einen Probelauf, der nichts schreibt
und Ihnen sagt, was der echte Lauf tun würde:
Wie viele Zeilen neu, geändert und unverändert sind. Diese Zahlen kommen bei jedem Lauf mit, nicht nur in der
Vorschau.
Welche Spalten sich ändern würden — so zeigt sich ein Zuordnungsfehler als „der Preis jeder Zeile
würde sich ändern“ statt als stilles Überschreiben.
Bis zu fünf Vorher-nachher-Beispiele und bis zu fünf der neuen Schlüssel. Bewusst
begrenzt: Die Vorschau eines ganzen Katalogs soll kein Megabyte an Werten zurück an den Browser schicken.
{I}Eine hohe Zahl „neu“ bei einem erneuten Import ist die Warnung. Ein erneut importierter Katalog, den Sie schon
haben, sollte fast vollständig unverändert sein. Ist fast jede Zeile neu, ist die Schlüsselspalte falsch, und die Vorschau
ist der Ort, an dem das auffällt, statt nachdem sich der Katalog verdoppelt hat.
Vier Wege, einen Feed zu übertragen
Im ersten Schritt des Assistenten (Upload-Quelle) wählen Sie, wie die Daten Personyze erreichen. Eigentlich geht es darum, wie oft sie sich ändern.
1 Datei hochladen — CSV, TSV oder XLSX von Ihrem Computer. Eine Momentaufnahme; am besten für einmalige Listen und kleine Exporte. 2 URL-/RSS-/Atom-Feed — tragen Sie eine öffentliche URL ein; Personyze ruft sie nach Zeitplan ab (etwa alle 10 Minuten). Am besten für einen Katalog oder eine Liste, die Ihre Plattform oder ein Feed-Dienst aktuell hält. 3 SFTP-Push — Sie legen Dateien an einem konfigurierten SFTP-Endpunkt ab. Am besten für große nächtliche Exporte aus einem Data Warehouse. 4 JSON-API-Push — senden Sie Datensätze per POST in Echtzeit aus Ihrem Backend.
Einmalig oder klein → Datei hochladen. Der schnellste Weg, eine Liste einmal zu laden.
Automatisch aktuell → URL-Feed. Richten Sie Personyze auf eine Live-Feed-URL — einen Google-Shopping-Feed, den Export eines Feed-Dienstes, den Produkt-Feed Ihrer Plattform —, und er wird nach Zeitplan neu gelesen; Bestand, Preise und neue Produkte bleiben so aktuell, ohne dass Sie erneut hochladen. Das ist die übliche Wahl für einen Produktkatalog.
Groß & geplant → SFTP. Für große nächtliche Exporte, bei denen eine öffentliche URL nicht passt. Sie können Ihr eigenes SFTP-Konto einrichten, mit wenigen Klicks — ohne jemanden fragen zu müssen.
Echtzeit & eigenes Backend → API-Push. Senden Sie Datensätze per POST, sobald sie sich ändern.
Ein Live-URL-, SFTP- oder API-Feed synchronisiert nach dem ersten Import weiter; ein Datei-Upload ist eine Momentaufnahme, die Sie zum Aktualisieren erneut hochladen.
SFTP-Dateiablage — Dateien ablegen und vergessen
SFTP ist die Option ohne Handarbeit. Sie erhalten ein privates Upload-Konto, Ihr Exportskript legt Dateien in dessen Ordner /upload ab, und jeder neue Upload wird automatisch importiert, wenige Minuten nach seinem Abschluss. Niemand klickt dafür im Panel.
Wo Sie es finden: Ihre SFTP-Zugangsdaten liegen unter Einstellungen → Website-Profil, im Abschnitt SFTP-Dateiablage — das ist die Seite, die Sie öffnen, wann immer Sie den Host, den Benutzernamen oder ein neues Passwort brauchen. Dieselbe Karte mit den Zugangsdaten erscheint auch überall dort, wo der Import-Assistent SFTP als Quelle anbietet: Produkt- und Artikel-Tracking, die Bildschirme für Produkt- und Artikelkatalog und Besucherattribute.
Einstellungen → Website-Profil → SFTP-Dateiablage. Ein Button richtet das Konto ein; die Tabelle darunter ist die ganze Routing-Regel — der Dateiname entscheidet, was aus einem Upload wird. Zum Vergrößern klicken.
Das Konto einrichten
Klicken Sie auf SFTP-Zugang einrichten.
Personyze legt ein privates Konto für Sie an. Währenddessen steht dort „Setting up your SFTP account — usually under 5 minutes“, und die Karte füllt sich, sobald alles bereit ist. Sie können die Seite verlassen und später zurückkommen.
Die Karte zeigt dann Ihren Host (sftp://upload.personyze.com), Benutzernamen und Ihr Passwort — mit den Buttons Anzeigen und Kopieren.
Ein Konto bedient jeden Dateityp unten, und es gehört zu diesem Website-Profil. Legen Sie alle Dateien in den Ordner /upload — alles andere wird nicht abgeholt.
Sobald das Konto existiert, zeigt die Karte alles, was Sie zum Verbinden brauchen. Das Passwort bleibt maskiert, bis Sie auf Anzeigen oder Kopieren drücken. Zum Vergrößern klicken.
Das Passwort wird nur geladen, wenn Sie auf Anzeigen oder Kopieren drücken, nie mit der Seite selbst — es bleibt aus Seitenquelltexten und Logs heraus. Passwort rotieren stellt ein neues aus, und das alte funktioniert nach wenigen Minuten nicht mehr; ändern Sie es also gleichzeitig in Ihrem Export-Job. Wurde Ihr Konto früher vom Support manuell eingerichtet, gibt es kein gespeichertes Passwort zum Anzeigen; rotieren Sie einmal, dann haben Sie eines, das Sie sehen können.
Der Dateiname entscheidet, was ein Upload ist
Es gibt keine Konfiguration pro Upload. Der Importer leitet jede Datei nach ihrem Namen weiter; die Endung sagt ihm nur das Format. Singular und Plural funktionieren beide — product.csv ist dasselbe wie products.csv.
Akzeptierte Endungen: .csv, .json, .xml, .xls, .xlsx. Eine neuere Datei erneut hochzuladen, importiert sie erneut — die neueste passende Datei gewinnt —; ein nächtlicher Job kann also einfach jedes Mal denselben Namen überschreiben.
Der erste Upload: einmal zuordnen
Eine Datei muss zugeordnet sein, bevor etwas daraus importiert wird — Personyze muss erfahren, welche Spalte was enthält. Sie richten das nicht vorab ein: Legen Sie die Datei zuerst ab, und das Panel kommt zu Ihnen.
Wenige Minuten nach Abschluss des Uploads erscheint ein Banner auf dem Zielbildschirm — für users.csv ist das Einstellungen → Besucherattribute, unter Importierte Benutzerlisten:
In Ihrem SFTP-Ordner: users.csv 1 KB · vor 36 Min. hochgeladen Noch nicht zugeordnet, daher wird nichts daraus importiert: Personyze hat noch nicht erfahren, welche Spalte der Datei was enthält.
Daneben stehen zwei Buttons: Erneut prüfen, der den Ordner neu durchsucht, und Diese Datei zuordnen, der die Zuordnung öffnet.
Der Zuordnungsdialog
Map “users.csv” from your SFTP folder zeigt alles, was er aus der Datei selbst ermittelt hat:
Listenname (nur bei Nutzer-Feeds) — jeder in der Datei kommt in diese Liste, und die Liste ist das, was Ihre Kampagnen ansprechen. Sie müssen sie nicht vorher anlegen; der Name hier legt sie an.
Eine Zeile pro Spalte, mit der Spalte in der Datei, dem Profilfeld, dem sie zugeordnet wird, und Beispielwerten aus Ihrer echten Datei — so sehen Sie auf einen Blick, dass CRM ID wirklich bei SFTP-TEST-1 gelandet ist und nicht bei etwas anderem.
Eine Zusammenfassung: wie viele Spalten gefunden wurden, wie viele zugeordnet sind und wie viele Zeilen die Datei hat. Was auf Ignore bleibt, wird nicht importiert.
Klicken Sie auf Zuordnung speichern, und die Datei wird importiert. Das ist ein einmaliger Schritt pro Dateiname — danach wird jeder Upload von users.csv mit derselben Zuordnung von selbst importiert.
Solange eine Datei nicht zugeordnet ist, passiert nichts — und nichts sagt es Ihrem Skript. Der Upload selbst war erfolgreich; ein Export-Job sieht also Erfolg, während die Daten ungelesen liegen. Haben Sie eine Datei abgelegt und die Zahlen bewegen sich nicht, öffnen Sie den Zielbildschirm und suchen Sie das Banner oben.
Läuft ein Feed, können Sie auf demselben Bildschirm E-Mail an mich, wenn dieser Feed nicht mehr synchronisiert wird einschalten — der günstigste Weg herauszufinden, dass der Export der letzten Nacht nie angekommen ist. Die Liste der Quellen lässt sich außerdem nach Herkunft filtern: Hochgeladen, RSS / Atom, SFTP oder API-Push.
Die wichtigste Formatregel
Der Dateiimporter von Personyze ist kommagetrennt, und das lässt sich im Upload-Schritt nicht ändern. Diese eine Tatsache bestimmt jede Formatierungsentscheidung:
Spalten werden durch Kommas getrennt. Nicht durch Semikolons, nicht durch senkrechte Striche, nicht durch Tabs (für einen echten tab-getrennten Feed siehe den TSV-Hinweis unten).
Enthält ein Wert in einer Zelle ein Komma, muss diese Zelle in doppelte Anführungszeichen gesetzt werden, sonst teilt der Importer sie in zusätzliche Spalten.
Das ist Standard-CSV, aber der häufigste Grund, warum ein Import sich falsch verhält; es lohnt sich also, es klar zu sagen.
Ausgearbeitetes Beispiel: Produktinteressen
Interessen sind eine Liste von Tags pro Produkt — für Cross-Selling, Affinitätssegmente und interessenbasierte Empfehlungen. Das funktionierende Format sind zwei Spalten, Id und Interest, mit den Interessen kommagetrennt in einer Zelle in Anführungszeichen:
Die Interest -Zelle jedes Produkts enthält eine andere Menge an Tags. Die Anführungszeichen lassen die inneren Kommas überleben. Ohne sie wird NW-1001,"Sneakers,Footwear,Casual,Running" zu fünf Spalten statt zwei, und der Import bricht.
📥 Die Beispieldatei mit Interessen herunterladen — öffnen Sie sie in einem einfachen Texteditor (nicht in einer Tabellenkalkulation), um die Anführungszeichen genau so zu sehen, wie der Importer sie braucht.
Trennzeichen — was funktioniert und was nicht
Ziel
Funktioniert?
Wie
Interessen kommagetrennt in einer Zelle
Ja
Die Zelle in Anführungszeichen setzen: "Sneakers,Footwear,Running"
Senkrechter Strich / Schrägstrich / Semikolon zwischen Interessen
Nein
Das Feld „Interessen“ akzeptiert nur Kommas
Semikolon als Spaltentrenner
Nein
Der Upload-Schritt ist auf Komma festgelegt
Kommas ohne Anführungszeichen in einer Zelle
Nein
Der Importer teilt sie in neue Spalten
TSV-Hinweis: Der Assistent akzeptiert .tsv, und ein echter tab-getrennter Feed (wie ein Google-Shopping-Feed) wird sauber importiert — Tabs sind das Trennzeichen, Kommas in Beschreibungen sind also nur Text. Die Kommaregel oben betrifft speziell kommagetrennte Dateien.
Dieselbe Idee für ein Kategoriefeld
Das Muster „Komma in einer Zelle in Anführungszeichen“ gilt nicht nur für Interessen — jedes Feld mit mehr als einem Wert funktioniert genauso. Ein Kategoriefeld ist der häufige zweite Fall. Zwei Darstellungen, beide gültig:
Ein hierarchischer Pfad in einer Zelle — die Konvention von Google-Feeds, mit > zwischen den Ebenen. Keine Kommas, also keine Anführungszeichen nötig:
Mehrere Kategorien in einer Zelle — gehört ein Produkt zu mehreren, trennen Sie sie durch Kommas in Anführungszeichen, genau wie bei Interessen:
Category
"Sneakers,Footwear,Running"
Die Regel ist immer dieselbe: Ein Komma in einem Wert bedeutet, dass die Zelle in Anführungszeichen stehen muss. Ein durch >getrennter Pfad oder ein durch /getrennter hat keine Kommas und kommt ohne Anführungszeichen aus.
Zusätzliche Felder in derselben Datei mitführen
Sie brauchen keine eigene Datei pro Attribut. Eine Zeile kann den Schlüssel plus Interessen plus Kategorie plus alles andere tragen, was Sie im Datensatz haben wollen — Marke, Verfügbarkeit, ein eigenes Tag —, und Sie ordnen jede Spalte im Schritt Spalten wählen zu:
Nur die Interest -Zellen in Anführungszeichen enthalten Kommas, daher stehen nur sie in Anführungszeichen; der Rest läuft als einfache Spalten mit. Ordnen Sie Id → Internal ID, Interest → Interestszu und jede übrige Spalte ihrem Personyze-Feld.
Jeder Import braucht eine Schlüsselspalte, sonst bleibt Weiter deaktiviert, mit einem roten “Missing required mapping”:
Interne ID — der Schlüssel des Datensatzes (Produkt-ID, Nutzer-ID).
Produktseiten-URL — die vollständige Seiten-URL, als alternativer Schlüssel.
Der Schlüssel muss dem entsprechen, womit der Katalog bereits geschlüsselt ist. Ist Ihr Katalog nach SKU geschlüsselt, muss die Spalte Id der Datei dieselbe SKU enthalten. Ein Import, der durchläuft, aber „auf keine Produkte passt“, ist fast immer ein nicht passender Schlüssel — die IDs wurden gut geladen, sie stimmen nur nicht überein.
Die Spalten zuordnen
Im Schritt Spalten wählen zeigt Personyze jede erkannte Spalte und lässt Sie sie einem Personyze-Feld zuordnen, mit optionaler Vorverarbeitung und Maske pro Spalte.
Der Zuordnungsschritt. Personyze meldet, wie viele Spalten erkannt wurden, und zeigt Beispielzeilen, damit Sie vor dem Zuordnen bestätigen können, dass die Datei korrekt eingelesen wurde.
Die Spaltenzahl in diesem Schritt ist Ihre Kontrolle des Parsens. Für die zweispaltige Interessendatei muss dort Detected 2 source columns stehen. Steht dort 6, gingen die Anführungszeichen beim Export verloren — beheben und neu hochladen. Urteilen Sie danach, was dieser Schritt meldet, nicht danach, wie die Datei in Excel oder Numbers aussieht.
Für Interessen: Ordnen Sie Id → Interne ID zu (beseitigt den roten Fehler), ordnen Sie Interest → Interessen zu, lassen Sie Vorverarbeitung = Unverändert übernehmen und Maske = Alles durchreichen und gehen Sie weiter zu Bereit für den Import.
Die Datei bauen (wiederholbares Rezept)
Haben Sie einen Quellexport mit einer Interessenspalte mit Kommas, erzeugen Sie die zweispaltige Datei mit Anführungszeichen mit ein paar Zeilen Python — csv.writer setzt um jedes Feld mit Komma automatisch Anführungszeichen:
import csv
rows = list(csv.DictReader(open('source.csv', encoding='utf-8-sig')))
with open('Id_Interest.csv', 'w', newline='', encoding='utf-8-sig') as f:
w = csv.writer(f) # quotes cells with commas automatically
w.writerow(['Id', 'Interest'])
for r in rows:
ints = ','.join(x.strip() for x in r['Interests'].split(',') if x.strip())
w.writerow([r['Product ID'], ints])
Produktkatalog-Feeds
Ein Produktkatalog ist nach einer Produktkennung geschlüsselt — und Sie können Interne ID, SKU oder beides liefern. Nur ein Schlüssel ist Pflicht.
Wenn Sie keine Produkt-ID haben
Hat Ihr Katalog keine stabile ID, kann Personyze eine aus einem Hash der Produktseiten-URL erzeugen. Das genügt, um ein Produkt bei Seitenaufrufen und „In den Warenkorb“ zu erkennen — die URL ist jedes Mal dieselbe, der Hash also stabil.
Beim Kauf-Tracking wird ein URL-Hash umständlich. Eine Danke- oder Bestellbestätigungsseite trägt meist nicht die Produkt-URLs dessen, was gekauft wurde; es gibt also nichts zu hashen. Käufe gegen gehashte IDs zu tracken, ist möglich, aber die Einrichtung ist mühsam. Viel einfacher ist es mit einer echten Produkt-ID, die Personyze automatisch aus einer Seitenvariablen übernehmen kann — einem Data-Layer-Wert, einer Tag-Manager-Variablen oder einem Feld im DOM —, denn dieselbe ID verbindet dann Katalog, Verhalten auf der Website und Kauf. Wenn Sie verkaufen, nutzen Sie eine echte ID. Der URL-Hash als Rückfall ist für Personalisierung bei Aufrufen und Klicks gedacht, wenn es keine ID gibt.
Die Katalogdatei
Ein Produktkatalog nutzt mehr Spalten, aber dieselben Regeln. Ein typischer Aufbau:
Internal ID, SKU, Title, Product Page URL, Main Image URL,
Price, Sale Price, Is in Stock, Rating
Ordnen Sie Interne ID als Schlüssel zu, Main Image URL und Produktseiten-URL, damit Karten gerendert und verlinkt werden, und Price / Sale Price / Is in Stock, damit Widgets Preise, Rabatte und Bestands-Badges zeigen können. Leere Zellen sind in Ordnung — ein leerer Sale Price bedeutet nur, dass es keinen Rabatt gibt.
📥 Die Beispieldatei für den Produktkatalog herunterladen — der echte Spaltenaufbau eines Live-Shops.
Für einen Live-Katalog ist ein URL-Feed die praktische Einrichtung: Richten Sie Personyze auf einen Feed, den Ihre Plattform oder ein Feed-Dienst bereits erzeugt. Ein Standard-Google-Shopping-/Merchant-Feed (TSV, mit id, title, link, price, availability, image_link, product_typeusw.) funktioniert direkt — Personyze liest diese Spalten und ruft die URL erneut ab, damit Bestand und Preise aktuell bleiben. Haben Sie noch keinen Feed, erzeugen Tools wie Feedoptimise, DataFeedWatch oder der native Export Ihrer Plattform einen.
Jedes Produkt braucht ein Hauptbild, damit Empfehlungskarten gerendert werden können. Darüber hinaus können Sie weitere Bildspalten hinzufügen — die zusätzlichen Bilder speisen Widgets, die das Foto beim Überfahren mit der Maus wechseln oder rotieren. Ordnen Sie das erste Main Image URL zu und die übrigen den zusätzlichen Bildfeldern.
So viele eigene Felder, wie Sie möchten
Über die Standardspalten hinaus kann eine Feed-Zeile beliebige zusätzliche Daten tragen — Versandkosten, Staffelpreise, Preise je Kundentyp, Tags, Marke, Farbe, alles. Drei Dinge können Sie mit einem eigenen Feld tun:
Anzeigen — es auf der Empfehlungskarte zeigen (ein Hinweis „Kostenloser Versand“, ein Mitgliederpreis).
Danach filtern — eine Empfehlung auf eine Marke, Farbe oder Kategorie beschränken.
Die KI damit trainieren — dem Empfehlungsmodell mehr Signal über jedes Produkt geben, damit es besser ordnet.
Meist sind es einfache Attribute wie Marke oder Farbe; es gibt keine Grenze, und nicht zugeordnete Spalten werden einfach ignoriert.
Zusammen kaufen / bedingte Preise
Sie können im Feed auch einen Preis pro Kombination mitführen — einen rabattierten Preis, der gilt, wenn bestimmte Produkte zusammen gekauft werden —, sodass der Preis eines Bundles direkt aus dem Katalog kommt, statt berechnet zu werden. Konzept und Einrichtung stehen unter Rabatt beim gemeinsamen Kauf für E-Commerce-Empfehlungen. (Der genaue Spaltenaufbau für Kombinationspreise wird hier ergänzt.)
Inhaltskatalog-Feeds
Ein Inhaltskatalog (Artikel, Videos, Leitfäden) treibt Inhaltsempfehlungen an. Die leichteste Variante ist nur die Inhalts-URL — Personyze erzeugt automatisch eine ID und trackt die Interaktion über die URL oder den URL-Pfad, sodass Aufrufe und Lesevorgänge korrekt zugeordnet werden, ohne dass Sie einen Schlüssel liefern. Sie können auch Ihre eigene Interne ID angeben, falls Sie eine haben.
Alles andere funktioniert wie beim Produktkatalog: ein Hauptbild (weitere optional für Hover-Widgets), plus beliebige eigene Spalten, die Sie anzeigen, filtern oder zum Training nutzen wollen — Inhaltstyp, Kategorie, Autor, Veröffentlichungsdatum, Tags.
Eine Nutzerliste hängt CRM-Daten an Ihre Besucher. Das Minimum ist ein Schlüssel plus ein Attribut:
E-Mail-Adresse (oder eine interne / CRM-ID) als Schlüssel und
mindestens eine weitere Spalte — Vorname, Kontotyp, irgendetwas.
Sie können so viele Attributspalten hinzufügen, wie Sie möchten. Das Wichtige: Was Sie hier befüllen, steht im Targeting bereit, nicht nur in der Aktion, die die Liste nutzt. Laden Sie den Vornamen oder Kontotyp eines Besuchers, können Sie später eine Zielgruppe bauen, die darauf abzielt — „Kontotyp ist VIP“, „Branche ist Einzelhandel“ —, genau wie bei jedem anderen Profilfeld. Liefern Sie es als Datei oder halten Sie es per SFTP oder Feed-URL synchron.
Wo:Einstellungen → Empfehlungen → Produktkatalog. Unter den Feeds und Feldern hat der Katalogbildschirm zwei optionale Abschnitte, in denen Sie Personyze sagen, welche Produkte zusammengehören. Beide sind optional — die Engine lernt Paarungen auch selbst aus dem Live-Verhalten —, aber sie sind nützlich, um zu starten, bevor Sie Daten haben, oder für Paarungen, die Sie von Hand steuern wollen.
Der Bildschirm „Produktkatalog“ (Einstellungen → Empfehlungen → Produktkatalog): Ihr Katalog plus die optionalen Abschnitte Manual cross-sell links, Manual up-sell links und System-generated cross-sell (seed data). Zum Vergrößern klicken.
Ausdrückliche Paarungen, die Sie selbst festlegen — die Verknüpfungen „häufig zusammen gekauft“ oder „das könnte Ihnen auch gefallen“. Sie werden genutzt, wenn der Algorithmus einer Empfehlungskampagne auf „Cross-sell (manual)“ oder „Up-sell (manual)“ steht:
Cross-Sell verbindet ein Basisprodukt mit einem empfohlenen Artikel.
Upsell verbindet ein Basisprodukt mit einem höherwertigen Artikel.
Fügen Sie Paare von Hand hinzu oder importieren Sie eine Datei — eine Verknüpfung pro Zeile, Ausgangs- und verknüpftes Produkt jeweils per interner ID. Verknüpfungen sind gerichtet; um in beide Richtungen zu empfehlen, fügen Sie beide Zeilen hinzu:
Subject Internal ID,Linked Internal ID
AQB14X,AQB15X
AQB15X,AQB14X
BARR4FJ3,LABAR4114
Ein Weg, die Empfehlungs-Engine anzulernen, bevor sie echte Käufe gesehen hat. Sie fügen Seed-Sets hinzu: Teilen Sie Personyze mit, dass ein Produktpaar zusammen gekauft wurde, und es empfiehlt die beiden einander, bis Live-Kaufdaten übernehmen. Jedes Seed-Set besteht aus einem Subject-Artikel, einem Recommended-Artikel und der Interaktion, die es simuliert — „Purchased → Purchased“ lernt Cross-Selling „zusammen gekauft“ an. Ideal für einen brandneuen Katalog ohne Verhaltensdaten; sobald echte Käufe eintreffen, überwiegen sie die Seeds von selbst.
1. Ein Seed-Set anlegen. Klicken Sie auf der Karte für systemgeneriertes Cross-Selling auf Neues Seed-Set. Jeder Seed verbindet ein Subject-Produkt mit einem Recommended-Produkt; wählen Sie, welche Interaction er simuliert („Purchased → Purchased“ lernt Cross-Selling „zusammen gekauft“ an), und legen Sie optional Rate, Zahl der Nutzer und Transaktionen fest. Zum Vergrößern klicken.2. Die Produkte wählen. Wählen Sie die Produkte für Subject und Recommended aus der durchsuchbaren Liste (beide müssen bereits im Katalog sein) — jede Kombination wird zu einem Seed-Set — und klicken Sie dann auf Seed-Set hinzufügen. Zum Vergrößern klicken.3. Es erscheint in der Liste — die Karte wechselt zu Konfiguriert, und jedes Seed-Set zeigt sein Paar (mit Vorschaubildern), die Interaktion, die Rate und die Zahl der Nutzer / Transaktionen. Die Engine empfiehlt das Paar jetzt, bis Live-Kaufdaten übernehmen. Zum Vergrößern klicken.
Mit dem Hochladen früherer Käufe trainiert Personyze Empfehlungen an echtem Kaufverhalten und kann ab dem ersten Tag nach Kaufhistorie ansprechen, bevor es diese Käufe live beobachtet hat. Jede Zeile ist schlank — gerade genug, um zu sagen, wer was wann gekauft hat:
ein Kundenschlüssel — E-Mail-Adresse oder CRM-ID;
die gekaufte Produkt-ID oder SKU;
der Transaktionszeitpunkt.
Titel, Menge, Preis oder Währung sind nicht nötig — Personyze liest sie aus dem Katalog. Für den Zeitstempel nutzen Sie ein übliches Datum mit Uhrzeit wie 2026-07-21 14:30:00 oder eine Unix-Epoche wie 1751389200. (Klären Sie das genau akzeptierte Format im Zweifel mit Ihrem Account Manager.)
Über die obigen Typen hinaus lädt derselbe Assistent beliebige tabellarische Daten — Affinitätstabellen, Segmentlisten, eigene Attributsätze. Wählen Sie den Übertragungsweg, bringen Sie das Format in Ordnung, ordnen Sie einen Schlüssel zu und den Rest.
Ein Inhaltskatalog (Artikel, Videos, Leitfäden) funktioniert genauso — die Schlüsselspalten werden zu Inhalts-ID und URL, mit Titel, Bild und allen Attributen, nach denen Sie empfehlen oder ansprechen wollen. Dasselbe gilt für Cross-Sell-Tabellen, Affinitätsdaten und CRM-Nutzerlisten: Übertragungsweg wählen, Format in Ordnung bringen, einen Schlüssel zuordnen, den Rest zuordnen.
Den Import abschließen
Der letzte Schritt: Prüfen Sie die Zuordnung und starten Sie den Import. Eine Datei wird einmal geladen; ein URL-, SFTP- oder API-Feed synchronisiert von hier an nach seinem Zeitplan weiter.
Fehlerbehebung
Symptom
Ursache
Lösung
„Detected 6 source columns“ (erwartet: 2)
Die Interessenzelle stand nicht in Anführungszeichen, oder sie gingen beim Export verloren
Mit Anführungszeichen neu exportieren; prüfen Sie, dass die Rohdatei Folgendes zeigt: "Sneakers,Footwear,..."
Die ganze Zeile landet in einer Spalte
Sie urteilen nach einer Tabellenkalkulation, nicht nach dem Importer
Richten Sie sich nach dem, was Schritt 2/3 meldet, nicht nach Excel oder Numbers
„Missing required mapping“ (rot)
Keine Interne ID / Produktseiten-URL zugeordnet
Ordnen Sie Ihre Schlüsselspalte der Internen ID (oder der Produktseiten-URL) zu
Interessen werden als eine lange Zeichenkette importiert
Das Trennzeichen ist kein Komma
Nutzen Sie zwischen Interessen Kommas, nichts anderes
Importiert problemlos, passt aber auf keine Produkte
Die Id passt nicht zum Katalogschlüssel
Nutzen Sie die Kennung, nach der der Katalog geschlüsselt ist (oft die SKU)
Stattdessen einen Wert live von der Seite lesen
Unabhängig vom Dateiimport kann Personyze einen Wert auch live von einer Produktseite lesen, während Besucher stöbern — nützlich, wenn die Daten nicht in einem Feed stehen. Dieser Weg nutzt einen CSS-Selektor oder JavaScript statt einer Datei und wird unter Daten von Ihrer Website erfassen behandelt. Zwei Praxishinweise, die sich übertragen lassen:
Meta-Tags lassen sich mit dem Picker auf der Seite nicht anklicken — sie liegen im <head> und werden nicht gerendert. Tippen Sie den Selektor von Hand ein, z. B. meta[property="og:type"].
In JS-gerenderten Shops (VTEX, React) können Meta-/og-Tags beim Laden der Seite leer sein und sich erst nach der Hydration füllen oder werden per Prerender nur an Suchmaschinen-Bots ausgeliefert. Ein Selektor, der nichts liefert, liegt meist an dieser Lücke durch Timing/Prerender, nicht an einem falschen Selektor. Ein serverseitig gerendertes Element ist zuverlässiger. Auch der GTM-dataLayer trägt die Referenz — lesen Sie ihn in Single-Page-Shops aber sorgfältig, denn der dataLayer sammelt sich über Produkte hinweg an, und ein früher Eintrag kann der zuvor angesehene Artikel sein.
Die Kurzfassung
Kommagetrennte Datei; jede Zelle mit Komma in Anführungszeichen setzen; eine Schlüsselspalte (Interne ID oder Produktseiten-URL) zuordnen, die dazu passt, wie Ihr Katalog geschlüsselt ist; den Rest zuordnen. Laden Sie für einen einmaligen Import eine Datei hoch oder richten Sie Personyze auf einen URL-/SFTP-/API-Feed, damit er synchron bleibt.
