Eerdere en offline transacties uploaden voor productaanbevelingen

Naast de online transacties die Personyze in realtime volgt, kun je het ook je eerdere of offline transacties geven. Omdat aanbevelingen zijn gebouwd op transactiestatistieken, verbetert het uploaden van de geschiedenis je aanbevelingen, en kun je verkopen uit fysieke winkels, telefonische bestellingen of elk kanaal dat Personyze op de site niet ziet benutten.

Waarom eerdere transacties uploaden?

Meestal om een nieuw Personyze-account een vliegende start te geven. Anders duurt het even voordat aanbevelingen relevant worden, omdat ze worden opgebouwd terwijl Personyze vanaf de dag van installatie klantinteracties volgt. Door in te voeren welke gebruikers in het verleden welke producten kochten, wordt de relevantie veel sneller bereikt.

Waarom offline transacties uploaden?

Om aanbevelingen te verbeteren met verkopen die Personyze op je site niet kan zien — aankopen in de winkel, kassadata, telefonische bestellingen. Omdat dit meestal een doorlopende bron is en geen eenmalige lading, lever je het het best als terugkerende feed (RSS/Atom, een URL-feed of SFTP) die blijft bijwerken.

Wat elke rij nodig heeft

Elke rij zegt wie wat kocht, en wanneer. In de wizard zijn de verplichte velden gemarkeerd met een sterretje:

Transactietijd of -ID (verplicht) — de datum/tijd van de aankoop, of een order-ID. Delen meerdere items één order-ID, dan leert Personyze dat ze samen zijn gekocht (en beveelt het ze samen aan zodra dat vaak genoeg gebeurt). Gebruik voor een tijdstempel een standaard datum-tijd zoals 2026-07-21 14:30:00 of een Unix-epoch zoals 1751389200.
Gebruikers-e-mail of Intern gebruikers-ID (één is verplicht) — de sleutel die elke transactie aan één klant koppelt. Het e-mailadres dient ook als sleutel voor campagnes met e-mailaanbevelingen (bijv. cross-sell-e-mails op basis van wat er is gekocht). Een CRM-/interne ID werkt net zo goed; je hebt er maar één van de twee nodig.
Intern product-ID (verplicht) — de ID die uniek is voor elk product. Die moet overeenkomen met de sleutel van je productcatalogus; is er geen product-ID, dan kan de URL van de productpagina die rol overnemen.
Aantal en Bedrag (optioneel) — neem ze op als je ze hebt; anders leest Personyze productgegevens zoals titel en prijs uit je catalogus.

Waar je het uploadt

Ga naar Instellingen → Aanbevelingen → Producttracking en open de wizard Eerdere aankoopevents uploaden. Die heeft drie stappen.

De vier manieren om transactiedata naar Personyze te sturen: een bestand uploaden, een URL-/RSS-/Atom-feed, SFTP of JSON API — Stap 1, **Uploadbron** — kies hoe de data binnenkomen. De keuze gaat eigenlijk over hoe vaak ze veranderen.

Stap 1 — Uploadbron. Kies hoe de data Personyze bereiken:

Bestand uploaden — een CSV of TSV van je computer (tot 50 MB). Een eenmalige momentopname; het beste om de geschiedenis aan te vullen.
URL-feed — een HTTP(S)-URL die CSV/JSON teruggeeft (of een RSS-/Atom-feed). Personyze vraagt die volgens een schema op, dus nieuwe transacties blijven binnenkomen. Het beste voor offline verkopen die blijven komen.
SFTP-drop — upload je bestand naar de map /upload op sftp://upload.personyze.com; het verschijnt in de wizard zodra het is gevonden. Het beste voor grote nachtelijke exports. Stel met een paar klikken je eigen inloggegevens in met SFTP-toegang instellen — zie Je SFTP-inloggegevens krijgen.
JSON API — POST records direct vanuit je backend naar het endpoint voor transacties (social_site_db_products_interactions_archive). Zie de API-documentatie.

De stap Kolommen kiezen, waarin elke bronkolom aan een Personyze-veld wordt gekoppeld — Stap 2, **Kolommen kiezen** — koppel elk van je kolommen aan een Personyze-veld. Verplichte velden zijn gemarkeerd met *; er wordt een voorbeeld van je data getoond, zodat je kunt bevestigen dat die goed is ingelezen.

Stap 2 — Kolommen kiezen. Personyze leest je kopregel en koppelt automatisch wat het herkent; pas aan wat het niet herkende. Koppel minstens de drie verplichte velden (Transactietijd of -ID, Intern product-ID, en Gebruikers-e-mail of Intern gebruikers-ID). Elke kolom heeft een optionele voorbewerking (bijvoorbeeld een valutasymbool of scheidingstekens voor duizendtallen verwijderen) en een live voorbeeld.

Stap 3 — Klaar voor import. Bevestig en start. Een bestand wordt één keer geladen; een bron via URL, SFTP of API kan worden bewaard als terugkerende feed — die wordt volgens een schema opnieuw geïmporteerd en verschijnt onder Actieve feeds op het scherm Producttracking, waar je op elk moment opnieuw kunt importeren, de koppeling kunt bewerken of de instellingen kunt wijzigen.

De product-ID in je feed moet overeenkomen met de sleutel die je productcatalogus gebruikt. Een import die voltooid is maar “geen producten matcht”, is bijna altijd een sleutel die niet overeenkomt — de transacties zijn goed geladen, ze sluiten alleen niet aan op de catalogus.

Gerelateerd

Feeds & databestanden uploaden — de gedeelde importwizard, de regels voor het formaat, en een downloadbare template voor transacties.
De product-/contentfeed instellen — de catalogus waartegen deze transacties worden gematcht.