Opgelet! We hebben een nieuwe documentatiesite en dit artikel is herschreven.

Bekijk de laatste versie van dit artikel →

 

De Tweakwise feed voorziet in één productstructuur en één categoriestructuur. Als het e-commerce platform uit meer talen en/of landen bestaat, dan kan dat op twee manieren opgelost worden;

1. Per taal en land wordt een aparte feed gemaakt. Er is dan per taal en land een aparte Tweakwise Navigator omgeving nodig. Voor elke omgeving zal de inrichting beheerd moeten worden.

2. De talen en landen worden samengevoegd in één feed. Er is dan maar één Tweakwise Navigator omgeving nodig. Delen van de inrichting kunnen gebruikt worden voor de diverse landen en talen.

Als de producten over de talen en landen heen in basis hetzelfde zijn, dan is de tweede optie (samenvoegen) het beste. Als de producten over de talen en landen heen nauwelijks overeen komen dan is de eerste optie (losse Tweakwise instantie) de beste optie.

Stel we hebben een fashion shop met een vaste collectie die in Nederland en België verkocht wordt. Het betreft dan 3 shops; de Nederlandse shop, de Belgische shop in het Nederlands en de Belgische shop in het Frans. De te verkopen producten (SKU’s) zijn over de shops heen gelijk, maar de talen en prijzen verschillen. Het is dan mooier om de shops samen te voegen in één feed en in te lezen in één Tweakwise Navigator omgeving.

Stel we hebben een e-commerce platform met diverse ‘clusters’; badkamers, BBQ’s, Haardhout etc. De clusters worden door verschillende mensen beheerd en de producten komen niet overeen. Het is dan mooier om verschillende Navigator omgevingen (en feeds) te hebben, zodat het beheer overzichtelijk blijft.

Magento

De Tweakwise extensie van Magento voorziet standaard in het samenvoegen van de verschillende storefronts tot één feed (de tweede optie).

Structuur bij samenvoegen in één feed

Categorieën

Stel we hebben een shop ‘MegaFashion’. De shop verkoopt online in Nederland en België. Binnen de shop hebben we 3 hoofdcategorieën; Schoenen, Tassen en Mutsen. Normaal zitten daar natuurlijk de sub- en sub subcategorieën onder, maar voor de eenvoud laten we dat weg uit het voorbeeld. We hebben dan deze categorieën;

In het voorbeeld hebben de categorieën allemaal een uniek CategorieID. In de praktijk kan het voorkomen dat de categorieën hetzelfde CategorieID hebben omdat ze slechts vertaald worden. Dan is dit de situatie:

Voor Tweakwise moeten alle categorieën een uniek CategorieID krijgen. Bij het laatste voorbeeld moet dan een voorloopcode toegevoegd worden per shop. Bijvoorbeeld;

Als de categorieën uniek gemaakt zijn moeten ze nog in één structuur geplaatst worden. Daarvoor moet er een root-categorie toegevoegd worden;

Deze categoriestructuur is geschikt voor Tweakwise. In de XML ziet de categoriestructuur er uiteindelijk zo uit:

Met de <parents> wordt altijd een link gelegd met de bovenliggende categorie(en). Let op dat de bij <parentids> genoemde ID’s ook altijd als categorie opgenomen zijn in de feed.

Producten en eigenschappen

Voor de producten moet per taal en land ook een apart item in de feed komen. Dus voor één SKU zullen drie producten (items) in de feed verschijnen. De drie producten moeten aan de corresponderende categorieën in de talen-/landenshops gekoppeld worden. Omdat het losse producten worden in de feed kunnen ook de productnamen en eigenschappen op de taal afgestemd worden.

Stel we hebben de onderstaande drie tassen:

De tassen moeten nu voor de drie shops gedupliceerd worden. Ze zullen daarbij altijd een uniek nummer moet krijgen. Een eenvoudige manier om dat te doen is het plaatsen van een voorloop-code. De code is dan bijvoorbeeld de CategorieID van de shop waaronder het product valt. Maar een andere code kan ook gebruikt worden. Als de producten maar een uniek nummer krijgen.  Bijvoorbeeld:

Misschien hebben de producten wel per land een eigen naam. Of hebben de eigenschappen per taal een eigen vertaling. Dan past dat prima in deze structuur;

In de XML van de feed moeten de negen producten opgenomen worden. Bij de producten wordt de juiste link gelegd naar de categorie. Dit is bijvoorbeeld de XML voor product 1-100-564001;

Of bijvoorbeeld voor hetzelfde product (dezelfde SKU) in de Franstalige Belgische shop:

Let met name op de vertaalde eigenschap namen en waardes.

Webservices Tweakwise

De geconstrueerde feed kan ingelezen worden in Tweakwise Navigator. Daarna wordt het zoeken en navigeren in Tweakwise ingericht en kan de front-end van de webshop gekoppeld worden aan Tweakwise (hiervoor is separate documentatie). In de koppelingen geeft Tweakwise de in de feed opgegeven ID’s terug. Hou er rekening mee dat daar dan mogelijk voorloopcodes in staan. Als bij een zoekactie Tweakwise product 3000102 teruggeeft, dan moet de front-end mogelijk de voorloopcode ‘3000‘ verwijderen voordat het product uit de database gehaald kan worden.

Bij het aanroepen van de Tweakwise webservices zal in geval van meertaligheid en/of meerlandigheid altijd het CategorieID meegegeven moeten worden van de betreffende shop. Stel je wil een zoekactie wil uitvoeren voor de BE-FR shop, dan zal bij de aanroep altijd CategorieID 3000100 meegegeven moeten worden. Zo weet Tweakwise exact binnen welke set aan categorieën en producten gezocht mag worden. Doe je dit niet, dan komt Tweakwise mogelijk met 3 exact dezelfde producten terug na een zoekactie. Zie hier bijvoorbeeld:

Let ook bij het meegeven van de categorieID’s op mogelijk aanwezige voorloopcodes.