Frühere und Offline-Transaktionen für Produktempfehlungen hochladen

Über die Online-Transaktionen hinaus, die Personyze in Echtzeit trackt, können Sie auch Ihre früheren oder Offline-Transaktionen einspeisen. Da Empfehlungen auf Transaktionsstatistiken beruhen, verbessert das Hochladen der Historie Ihre Empfehlungen und lässt Sie Verkäufe aus Filialen, telefonische Bestellungen oder jeden Kanal nutzen, den Personyze auf der Website nicht sieht.

Warum frühere Transaktionen hochladen?

Meist, um einem neuen Personyze-Konto einen Schnellstart zu geben. Andernfalls dauert es eine Weile, bis Empfehlungen relevant werden, weil sie sich aufbauen, während Personyze ab dem Tag der Installation Kundeninteraktionen trackt. Wenn Sie einspeisen, welche Nutzer früher welche Produkte gekauft haben, wird die Relevanz viel schneller erreicht.

Warum Offline-Transaktionen hochladen?

Um Empfehlungen mit Verkäufen zu verbessern, die Personyze auf Ihrer Website nicht beobachten kann — Käufe im Laden, POS-Daten, telefonische Bestellungen. Da das meist eine laufende Quelle und kein einmaliger Import ist, liefern Sie sie am besten als wiederkehrenden Feed (RSS/Atom, URL-Feed oder SFTP), der sich laufend aktualisiert.

Was jede Zeile braucht

Jede Zeile sagt, wer was wann gekauft hat. Im Assistenten sind die Pflichtfelder mit einem Sternchen markiert:

Transaktionszeit oder -ID (Pflicht) — Datum/Uhrzeit des Kaufs oder eine Bestell-ID. Teilen sich mehrere Artikel eine Bestell-ID, lernt Personyze, dass sie zusammen gekauft wurden (und empfiehlt sie zusammen, sobald das oft genug vorkommt). Für einen Zeitstempel verwenden Sie ein Standard-Datumsformat wie 2026-07-21 14:30:00 oder eine Unix-Epoch wie 1751389200.
Benutzer-E-Mail oder Interne Benutzer-ID (eines davon ist Pflicht) — der Schlüssel, der jede Transaktion einem Kunden zuordnet. Die E-Mail dient zugleich als Schlüssel für E-Mail-Empfehlungskampagnen (z. B. Cross-Selling-E-Mails auf Basis des Gekauften). Eine CRM- bzw. interne ID funktioniert genauso gut; Sie brauchen nur eines von beiden.
Interne Produkt-ID (Pflicht) — die für jedes Produkt eindeutige ID. Sie muss dem Schlüssel Ihres Produktkatalogs entsprechen; gibt es keine Produkt-ID, kann die URL der Produktseite einspringen.
Menge und Betrag (optional) — geben Sie sie an, wenn Sie sie haben; andernfalls liest Personyze Produktdetails wie Titel und Preis aus Ihrem Katalog.

Wo Sie hochladen

Gehen Sie zu Einstellungen → Empfehlungen → Produkt-Tracking und öffnen Sie den Assistenten Upload past purchase events. Er hat drei Schritte.

Die vier Wege, Transaktionsdaten an Personyze zu senden: Datei hochladen, URL-/RSS-/Atom-Feed, SFTP oder JSON-API — Schritt 1, **Upload-Quelle** — wählen Sie, wie die Daten ankommen. Die Wahl hängt vor allem davon ab, wie oft sie sich ändern.

Schritt 1 — Upload-Quelle. Wählen Sie, wie die Daten Personyze erreichen:

Datei hochladen — eine CSV- oder TSV-Datei von Ihrem Computer (bis zu 50 MB). Eine einmalige Momentaufnahme; am besten für das Nachladen der Historie.
URL-Feed — eine HTTP(S)-URL, die CSV/JSON liefert (oder ein RSS-/Atom-Feed). Personyze ruft sie nach Zeitplan ab, sodass neue Transaktionen weiter einfließen. Am besten für laufende Offline-Verkäufe.
SFTP-Ablage — laden Sie Ihre Datei in den Ordner /upload auf sftp://upload.personyze.comhoch; sie erscheint im Assistenten, sobald sie erkannt wurde. Am besten für große nächtliche Exporte. Richten Sie Ihre eigenen Zugangsdaten mit wenigen Klicks über SFTP-Zugang einrichten ein — siehe Ihre SFTP-Zugangsdaten erhalten.
JSON-API — senden Sie Datensätze per POST direkt aus Ihrem Backend an den Transaktions-Endpunkt (social_site_db_products_interactions_archive). Siehe die API-Dokumentation.

Der Schritt „Spalten wählen“, in dem jede Quellspalte einem Personyze-Feld zugeordnet wird — Schritt 2, **Spalten wählen** — ordnen Sie jede Ihrer Spalten einem Personyze-Feld zu. Pflichtfelder sind mit * markiert; ein Ausschnitt Ihrer Daten wird angezeigt, damit Sie prüfen können, ob sie korrekt eingelesen wurden.

Schritt 2 — Spalten wählen. Personyze liest Ihre Kopfzeile und ordnet Erkanntes automatisch zu; passen Sie an, was nicht erkannt wurde. Ordnen Sie mindestens die drei Pflichtfelder zu (Transaktionszeit oder -ID, Interne Produkt-ID sowie Benutzer-E-Mail oder Interne Benutzer-ID). Jede Spalte hat eine optionale Vorverarbeitung (zum Beispiel das Entfernen eines Währungssymbols oder von Tausendertrennzeichen) und eine Live-Vorschau.

Schritt 3 — Bereit für den Import. Bestätigen und starten. Eine Datei wird einmal geladen; eine URL-, SFTP- oder API-Quelle kann als wiederkehrender Feed beibehalten werden — sie wird nach Zeitplan neu importiert und erscheint unter Aktive Feeds auf dem Bildschirm „Produkt-Tracking“, wo Sie jederzeit neu importieren, die Zuordnung bearbeiten oder die Einstellungen ändern können.

Die Produkt-ID in Ihrem Feed muss dem Schlüssel Ihres Produktkatalogs entsprechen. Ein Import, der abgeschlossen wird, aber „keinen Produkten entspricht“, ist fast immer eine Schlüsselabweichung — die Transaktionen wurden korrekt geladen, sie passen nur nicht zum Katalog.