×![]()
Klik ergens om te sluiten
De catalogus is waaruit Personyze aanbeveelt: titels, prijzen, afbeeldingen, beschikbaarheid — en de namen van de attributen erin zijn de namen waarnaar je verwijst in widgets, filters en targeting. Product- en contentfeeds hebben dezelfde structuur en opties; alles hieronder geldt voor beide.
Wat de catalogus mogelijk maakt
- Aanbevelingsalgoritmes hebben items om te rangschikken en rijke velden om te tonen.
- Interactie-events hangen aan echte producten (de ID’s moeten overeenkomen).
- Filters en targeting kunnen elk veld gebruiken dat je opneemt — merk, categorie, marge, tags.
Manieren om hem te laden
| Route | Wanneer |
|---|---|
| Live feed-URL | Je bestaande productfeed (het formaat van Google Shopping werkt) — Personyze leest die volgens een schema opnieuw, zodat voorraad en prijzen actueel blijven. De aanbevolen standaard. |
| Spreadsheet uploaden | Prima voor een eerste installatie of een stabiele catalogus; upload opnieuw om bij te werken. Alle uploadbronnen en de planning: feeds & databestanden uploaden. |
| Synchronisatie met een platform | Shopify en WooCommerce / WP-sitemap synchroniseren met een schakelaar. |
| REST API | Stuur en werk items programmatisch bij: products / articles. POST voegt samen op internal_id, dus opnieuw sturen is veilig. |
Welke velden ertoe doen
- In de praktijk verplicht:
internal_id(de sleutel waarop alles wordt gekoppeld),title, URL van het item, afbeelding, prijs,is_in_stock. - Aanbevolen: categorie (maakt categorielogica en hiërarchie mogelijk), merk, uitverkoopprijs.
- Alles wat je verder stuurt, wordt een veld — bruikbaar in het ontwerp van kaarten, in filters en in targeting. Meer data betekent rijkere widgets; begin met de verplichte set en breid uit.
Bewerken en controleren
De catalogusweergave (Instellingen → Aanbevelingen → Productcatalogus, of de stap Catalogus van de wizard) toont wat er is binnengekomen — controleer of afbeeldingen worden weergegeven, prijzen goed worden gelezen en voorraadmarkeringen kloppen. Afzonderlijke velden kun je ter plekke bewerken; voorwaardelijke prijzen worden hier ook beheerd.
Veelvoorkomende valkuilen
- ID’s komen niet overeen met interacties — de
internal_idvan de feed moet gelijk zijn aan wat je interactietracking doorgeeft (SKU en id door elkaar halen is de klassieker). - Relatieve afbeeldings-URL’s — gebruik absolute URL’s, zodat widgets ze overal kunnen weergeven.
- Omgaan met uitverkochte items — houd items in de feed met
is_in_stock=0in plaats van ze te verwijderen, zodat de geschiedenis en de filters intact blijven.