Deze gids legt uit hoe je een XML-bestand genereert dat de volledige productcatalogus bevat, essentieel voor het synchroniseren van je producten met advertentie- en verkoopplatforms zoals Google Merchant Center, TikTok Shop of Facebook Catalog.
Omdat het genereren van de feed plaatsvindt via een specifieke webadres (URL), wordt de configuratie uitgevoerd door parameters toe te voegen aan dat adres.
1. Opbouw van de Basis-URL
Om de feed te genereren, moet je toegang krijgen tot een specifieke URL van jouw site. De basis-URL hangt af van het formaat en het doelsysteem.
1. Identificeer je domein (bijv. https://tuosito.com).
2. Voeg het pad van de feed toe /api/plugin/ecommerceFeeds/.
3. Kies het type feed om te genereren:
| Platform | Type Feed | Voorbeeld Basis-URL |
|---|---|---|
| Google Merchant / Standard | standard.xml | https://tuosito.com/api/plugin/ecommerceFeeds/standard.xml |
| TikTok Shop | tiktok.xml | https://tuosito.com/api/plugin/ecommerceFeeds/tiktok.xml |
> Opmerking: Als je deze URL zonder extra parameters bezoekt, wordt de volledige feed gegenereerd met alle actieve producten.
2. Geavanceerde Feedconfiguratie (Filters en Varianten)
Je kunt de inhoud van de feed aanpassen door configuratieparameters toe te voegen na een vraagteken (?) in de basis-URL.
2.1. Insluiten van Varianten (Maat, Kleur, Merk)
Als je producten varianten hebben (bijv. maten of kleuren), moet je specificeren welke attributen moeten worden gemapt naar standaardvelden van Google/TikTok (color, size, brand).
Je moet het numerieke ID identificeren van het attribuut dat Maat, Kleur, enzovoort vertegenwoordigt in jouw productbeheersysteem.
| Doel | Parameter | Voorbeeld (als ID 5 de Kleur is) |
|---|---|---|
| Kleur | v[c]=ID_ATTRIBUUT | ?v[c]=5 |
| Maat | v[s]=ID_ATTRIBUUT | ?v[s]=12 |
| Merk | v[b]=ID_ATTRIBUUT | ?v[b]=8 |
Voorbeeld URL met Varianten:
Als je de varianten Maat (ID 12) en Kleur (ID 5) wilt opnemen:
.../tiktok.xml?v[s]=12&v[c]=5
2.2. Filteren op Categorie
Het is mogelijk om producten op te nemen of uit te sluiten op basis van categorieën, gebruikmakend van categorie-ID's.
| Doel | Parameter | Voorbeeld |
|---|---|---|
| Categorieën Opnemen | include_cats=ID1,ID2 | ?include_cats=1,2,5 |
| Categorieën Uitsluiten | exclude_cats=ID1,ID2 | ?exclude_cats=10,11 |
2.3. Mapping van Aangepaste Labels (Custom Labels)
Aangepaste labels (customlabel0 tot en met customlabel4) zijn handig om producten te organiseren in advertentiecampagnes. Je kunt deze labels mappen naar:
- Categorieën: Om de hiërarchie van productcategorieën in te voegen.
- Attributen: Om de waarde van een specifiek attribuut (numeriek ID) in te voegen.
- Vaste Tekst: Om een vaste tekststring in te voegen.
| Label | Parameter | Waardevoorbeeld | Beschrijving |
|---|---|---|---|
customlabel0 | c[0] | categories | Voegt het volledige pad van categorieën in. |
customlabel1 | c[1] | 15 | Voegt de waarde in van Attribuut met ID 15. |
customlabel2 | c[2] | Estate2024 | Voegt de vaste string "Estate2024" in. |
3. Genereren van de Eindfeed
Om de feed te genereren plak je de volledige URL in je browser (of geef je deze aan het doelsysteem).
Voorbeeld Volledige URL (TikTok Shop):
Genereer de feed voor TikTok Shop inclusief varianten Maat (ID 12) en Kleur (ID 5), en map customlabel0 naar het categoriepaden:
https://tuosito.com/api/plugin/ecommerceFeeds/tiktok.xml?v[s]=12&v[c]=5&c[0]=categories
Zodra je deze URL opent zal het systeem de gegevens verwerken en direct het XML-bestand retourneren (of CSV indien gevraagd) dat je kunt opslaan of gebruiken voor automatische synchronisatie.
> Belangrijk: Het proces voor het genereren van de feed kan enkele seconden duren (tot wel 120 seconden, afhankelijk van het aantal producten) om onderbrekingen te voorkomen.
