Deze handleiding helpt je om de Magento Tweakwise Export Extensie te configureren. Deze module genereert een XML-feed die ingelezen moet worden in de Tweakwise app. Richt de instellingen op default configuratie niveau in.
Stap 1: Bepalen welke attributen mee moeten naar Tweakwise
Voordat je begint met het activeren van je feed voor Tweakwise, is het belangrijk om te zorgen dat de juiste attributen mee komen naar Tweakwise. Denk hierbij aan kleur, maat, SKU en andere relevante attributen waar je op wil zoeken, sorteren of filteren.
Ga naar Products > Attributes > Storefront properties:
Als een van de onderstaande instellingen op yes staat, wordt het attribuut toegevoegd aan de feed export:
- Use in search
- Layered navigation: alles behalve no gaat mee
- Use in search layered
- Use in product listing
- Use for sorting in product listing
- Use in advanced search
Stap 2: Tweakwise instancekey koppelen
Ga naar de module Algemeen van de Magento Tweakwise Master Extensie en vul bij Authentication key de door Tweakwise aangeleverde instancekey in. Zonder inrichting van deze key is het niet mogelijk om een succesvolle export te draaien.
Stap 3: Configureren Tweakwise feed
In de module Export activeer je de feedgeneratie en met behulp van deze module kun je de feed URL bij Tweakwise aanleveren.
Instelling |
Invoer |
Beschrijving |
Aanbevolen |
Enabled |
Yes/No |
Hiermee activeer je de feedgeneratie |
Yes |
Store level export |
Yes/No |
Geef aan of je de export wilt genereren per storeview (yes) of één export met alle storeviews (no). Wanneer je per storeview een aparte feed genereert, worden dit in Tweakwise losse instanties. Het kan zo zijn dat dit meerkosten met zich meebrengt. Twijfel je? Neem dan contact op met je Onboarding Specialist/Customer Success Manager. |
No |
Key |
Text field |
Zelf te bepalen key. Dit is de key die aangeeft waar de feed te benaderen is. De standaard Export url wordt www.example.com/tweakwise/feed/export/key/XXXX. Op deze laatste plek vind je dan de key die hier is ingevuld. |
- |
Allow cache flush |
Yes/No |
Met deze instelling is het mogelijk om de cache te legen wanneer er in Tweakwise een publicatietaak heeft gedraaid. Dit is aan te bevelen zodat de nieuwste resultaten direct in je shop ziet. Deze actie moet vanuit Tweakwise aangeroepen worden, dit kan door middel van de juiste URL aan te leveren aan je Onboarding Specialist/Customer Success Manager: Op deze laatste plek vind je dan de key die hier boven is ingevuld. |
Yes |
Validate |
Yes/No |
Deze functionaliteit controleert na het genereren van de feed of er categorieën en producten in staan, in dat geval wordt er niet geëxporteerd. In de Tweakwise app is een dergelijke validatie ook mogelijk. Let op: Zet je deze functionaliteit op Yes, dan zal het genereren van de feed iets langer duren. |
Yes |
Archive |
Numeric |
Aantal feeds om in archief te bewaren. |
Min. 1 |
Export in Real Time |
Yes/No |
Feed wordt real time gegenereerd zodra de feed wordt opgevraagd. Dus als er vanuit Tweakwise op Feed importeren geklikt wordt, wordt eerst de feed vanuit Magento opnieuw gegenereerd voordat deze in Tweakwise wordt ingelezen. Side note: wordt binnenkort uitgefaseerd |
No |
Tweakwise Import API Url |
Tekst field |
Hier kan de URL van de import taak in Tweakwise worden ingevuld. Als deze is ingevuld, wordt na een succesvolle feed generatie automatisch de import taak in Tweakwise getriggerd en gestart. Ontvang deze URL van jullie Onboarding Specialist/Customer Success Manager. |
- |
Export out of stock combined product children |
Yes/No |
Wanneer dit op no staat wordt gekeken naar de voorraad van de child products, wanneer een bepaalde maat niet meer op voorraad is, dan wordt deze maat niet meer toegevoegd aan de feed. Wanneer dit op yes staat wordt dit dus nog wel toegevoegd aan de feed. |
No |
Exclude child attributes |
Select |
Hier kan je selecteren welke attributen van de child products niet toegevoegd mogen worden en dus enkel de attributen van configurabele producten. |
Image, link, description |
Price field |
Dropdown |
Bepaal hoe het prijsveld wordt bepaald. Hierbij gaat het om het veld prijs op het tabblad kenmerken in Tweakwise. |
|
Batch size categories |
Numeric |
Stel de batchgrootte voor categorieën in tijdens het exporteren. Als geheugen minder belangrijk is dan snelheid, verlaag dan de batchgrootte. Is snelheid belangrijker? Verhoog dan de batchgrootte. |
|
Batch size products |
Numeric |
Stel de batchgrootte voor producten in tijdens het exporteren. Als geheugen minder belangrijk is dan snelheid, verlaag dan de batchgrootte. Is snelheid belangrijker? Verhoog dan de batchgrootte. |
|
Batch size products children |
Numeric |
Stel de batchgrootte voor child products in tijdens het exporteren. Als geheugen minder belangrijk is dan snelheid, verlaag dan de batchgrootte. Is snelheid belangrijker? Verhoog dan de batchgrootte. |
|
Schedule full export |
Text field |
Selecteer hier het tijdstip waarop de feed geëxporteerd wordt door middel van een cron job. Je kan hier inrichten of de feed dagelijks of meerdere keren per dag gegenereerd moet worden. Belangrijk is dat je hier dezelfde frequentie invult, zoals afgesproken in het contract met Tweakwise. Let op: Het vaker genereren van de feed kan ervoor zorgen dat je een toeslag van Tweakwise ontvangt op je factuur. |
|
State |
Text |
Weergeeft de status van de laatste export. |
|
Schedule exports |
Button |
De export gaat mee met de eerst volgende cron job. |
|
Stap 4: Configureren externe eigenschappen [Optioneel]
Opmerking: Het gebruik van deze externe eigenschappen is standaard niet inbegrepen in het Standard- en Medium-niveau.
U wilt mogelijk de voorraad of prijs vaker bijwerken dan de rest van de artikelgegevens. Dit kan worden gedaan met behulp van een externe eigenschap: Wat is een externe eigenschap? – Tweakwise .
Met de Export voor Voorraad en Prijs kunt u dit bereiken.
Export Voorraad
De standaard URL voor deze externe eigenschapsfeed is: www.example.com/tweakwise/feed/export/key/XXXX/type/stock
Waarbij de sleutel van de volledige feed wordt gebruikt.
Instelling |
Invoer |
Beschrijving |
Aanbevolen |
Schedule stock export |
Tekst field |
Selecteer hier het tijdstip waarop de feed door de cron job zal worden geëxporteerd. |
|
State |
Text |
Geeft de status van de laatste export weer. |
- |
Schedule stock export |
Button |
De export gebeurt bij de volgende cron job. |
|
Tweakwise Import API Url for stock feed (external property) |
Tekst field |
URL voor voorraadfeed (externe eigenschap) Tekstveld. Hier kan de URL van de importtaak in Tweakwise worden ingevoerd. Als dit is ingevuld, wordt na een succesvolle feedgeneratie de importtaak in Tweakwise automatisch geactiveerd en gestart. Ontvang deze URL van uw Onboarding Specialist/Customer Success Manager. |
Yes |
Export prijs
De standaard URL voor deze externe eigenschapsfeed is: www.example.com/tweakwise/feed/export/key/XXXX/type/price
Waarbij de sleutel van de volledige feed wordt gebruikt.
Instelling |
Invoer |
Beschrijving |
Aanbevolen |
Schedule price export |
Tekst field |
Selecteer hier het tijdstip waarop de feed door de cron job zal worden geëxporteerd. |
|
State |
Text |
Geeft de status van de laatste export weer. |
- |
Schedule price export |
Button |
De export gebeurt bij de volgende cron job. |
|
Tweakwise Import API Url for price feed (external property) |
Tekst field |
URL voor prijsfeed (externe eigenschap) Tekstveld. Hier kan de URL van de importtaak in Tweakwise worden ingevoerd. Als dit is ingevuld, wordt na een succesvolle feedgeneratie de importtaak in Tweakwise automatisch geactiveerd en gestart. Ontvang deze URL van uw Onboarding Specialist/Customer Success Manager. |
Yes |