Mapping

Koppel interne Smart Fields, vaste waarden en combinaties zorgvuldig aan verplichte, aanbevolen en optionele doelvelden van een verkoopkanaal.

Waarvoor gebruik je Mapping?

Met Mapping bepaal je welke interne Nifelo-waarde naar ieder doelveld van een verkoopkanaal gaat. Selectie en Regels bepalen welke producten meedoen; Manipulaties passen hun tijdelijke uitvoerwaarden aan; Mapping geeft deze waarden vervolgens de veldnamen en structuur die het doelkanaal verwacht.

Een correcte mapping betekent nog niet dat ieder product een bruikbare waarde heeft. Controleer na het koppelen altijd Coverage & kwaliteit.

Doelveld en interne waarde

Iedere rij verbindt:

een doelveld van het kanaal, bijvoorbeeld g:title;
een brontype: Smart Field, vaste waarde of combinatie;
de interne waarde of formule die het doelveld vult.

Verwar deze mapping niet met Slimme velden bij een databron. Slimme velden koppelen brondata aan het interne productmodel. Verkoopkanaalmapping koppelt dat interne model aan een extern formaat.

Verplicht, aanbevolen en optioneel

Een kanaalsjabloon verdeelt doelvelden in drie groepen.

Verplicht

Zonder bruikbare mapping kan de uitvoer worden geblokkeerd of afgekeurd. Ook een gekoppeld verplicht veld kan onvoldoende zijn wanneer veel producten een lege of ongeldige waarde hebben.

Aanbevolen

Deze velden zijn niet altijd technisch verplicht, maar verbeteren vindbaarheid, kwaliteit of kanaalacceptatie. Open de ingeklapte groep en beoordeel ze bewust.

Optioneel

Gebruik optionele velden wanneer het kanaal en de productdata er werkelijk baat bij hebben. Voeg geen lege of betekenisloze velden toe alleen omdat ze beschikbaar zijn.

Het sjabloon bepaalt de belangrijkheid. Een nieuwe sjabloonversie kan de classificatie van een bestaand veld bijwerken.

Conceptvoorstellen

Bij een sjabloon stelt Nifelo op basis van het standaard Smart Field mogelijke koppelingen voor. Het label Concept betekent dat de rij nog een voorstel is.

Controleer vóór opslaan:

of bron- en doelveld dezelfde betekenis hebben;
of product- of variantniveau klopt;
of formaat, eenheid en taal passen;
of de productpreview een realistische waarde toont.

Concepten zijn pas definitief nadat je het verkoopkanaal opslaat. Een voorstel is geen garantie dat alle producten een waarde hebben.

Smart Field als bron

Kies Smart Field voor dynamische productwaarden zoals titel, merk, prijs, GTIN, kleur of beschikbaarheid. De mapping leest de effectieve waarde nadat eerdere kanaalmanipulaties zijn toegepast.

Kies het veld op betekenis, niet alleen op een vergelijkbare naam. Een leveranciercode is bijvoorbeeld geen merk en een interne categorie is niet automatisch een Google Product Category.

Vaste waarde

Een vaste waarde wordt voor ieder geselecteerd product hetzelfde. Dit is geschikt voor een werkelijk kanaalbrede constante, bijvoorbeeld een vaste conditie wanneer alle producten nieuw zijn.

Gebruik geen vaste waarde voor prijs, voorraad, SKU, GTIN of andere productfeiten die per product verschillen. Beperk uitzonderingen met Manipulaties voordat je een onjuiste algemene constante gebruikt.

Gecombineerde waarde

Met Combineren bouw je een waarde uit tekst en één of meerdere Smart-Fieldtokens. Je kunt bijvoorbeeld merk en titel samenvoegen. Tokens worden als {{ veld }} opgeslagen en bij ieder product vervangen.

Let zelf op spaties, scheidingstekens, maximale kanaallengte en lege tokens. Wanneer één onderdeel leeg is, kan dubbele interpunctie of een onvolledige tekst ontstaan. Gebruik de preview met meerdere producten.

Productpreview

De vaste previewbalk toont titel, SKU en databron van een voorbeeldproduct. Blader met de pijlen of zoek op titel, merk of SKU. Open het product in de databron voor nader onderzoek.

Per mapping toont de preview de actuele samengestelde waarde. De preview helpt bij configureren, maar is een steekproef en bewijst niet dat alle producten correct zijn.

Mapping leegmaken

Met het verwijdericoon bij een rij maak je die koppeling leeg. Bij een opgeslagen mapping wordt de koppeling direct verwijderd; een sjabloonvoorstel kan daarna weer als Concept verschijnen.

Een optionele eigen rij kan volledig worden verwijderd. Een verplicht sjabloondoel blijft als doel bestaan, maar zonder interne waarde.

Alles leegmaken

Alles leegmaken verwijdert alle opgeslagen mappings van dit verkoopkanaal. Gebruik dit alleen wanneer je de mapping werkelijk opnieuw wilt opbouwen. Manipulaties, producten en bronmappings worden niet verwijderd, maar de kanaaluitvoer kan daarna onbruikbaar zijn.

Opnieuw vullen vanuit sjabloon

Opnieuw vullen vanuit sjabloon herstelt ontbrekende standaardvoorstellen vanuit het actuele kanaalsjabloon. De voorstellen blijven Concept totdat je ze controleert en opslaat.

Deze actie is nuttig na verkeerd leegmaken of een sjabloonupdate. Zij mag je eigen zakelijke beoordeling niet vervangen en overschrijft niet vanzelf ieder bewust aangepast veld.

Een optioneel of aangepast doelveld toevoegen

Kies een beschikbaar optioneel sjabloonveld of voeg bij een aangepast formaat een eigen doelveld toe. Gebruik exact de technische veldnaam die de ontvanger verwacht. Een spelfout kan een extra onbekende kolom maken in plaats van het bedoelde veld te vullen.

Opslaan en wijzigingen

Gebruik de algemene knop Opslaan om de getoonde mapping vast te leggen. Niet-opgeslagen Concepten en wijzigingen kunnen bij verlaten van de pagina verloren gaan.

Na wijzigingen is meestal geen nieuwe bronimport nodig: Mapping werkt tijdens de kanaaluitvoer. Start wel een nieuwe preview, coverage-analyse en export om het nieuwe resultaat te zien.

Mapping en manipulaties

Manipulaties worden vóór Mapping uitgevoerd. Wanneer een manipulatie een Smart Field wijzigt of een virtueel veld maakt, kan Mapping het gewijzigde resultaat gebruiken. Een mapping zelf verandert de productwaarde niet; zij bepaalt alleen het doelveld.

Mapping en taal/valuta

Export language bepaalt welke gelokaliseerde waarden beschikbaar zijn. Default currency helpt bij prijsnotatie en validatie, maar converteert geen bedragen. Mapping naar een prijsveld ontslaat je niet van controle op valuta, formaat en aanbiedingsprijs.

Shopify en beheerde integraties

Shopify gebruikt een centraal beheerd, read-only Product- en ProductVariant-contract in plaats van vrije kanaalmapping. Daardoor blijven doelvelden, formatters, ownership en beleid voor lege waarden consistent.

Selectie, Regels en Manipulaties blijven actief, maar je kunt geen willekeurig Shopify-doelveld toevoegen. Gebruik de Shopify-preview om verschillen, waarschuwingen en blokkades te controleren. Ontbreekt een noodzakelijk doelveld, laat dan het integratiecontract door Nifelo beoordelen.

Veelvoorkomende problemen

Een verplicht veld is gekoppeld maar coverage blijft laag

De juiste Smart-Fieldkoppeling bestaat, maar veel geselecteerde producten hebben geen waarde. Onderzoek bronmapping, productdata en validatie.

De preview is leeg

Controleer Smart Field, geselecteerde databronnen, productwaarde en eventuele Manipulaties. Blader ook naar een ander voorbeeldproduct.

Een gecombineerde waarde ziet er vreemd uit

Controleer tokens, vaste tekst, spaties en lege bronvelden. Test meerdere producten en varianten.

Het externe kanaal negeert een veld

Controleer de exacte technische doelnaam, sjabloonversie, formaat en kanaaleisen. Een succesvol bestand betekent niet automatisch dat ieder onbekend veld wordt gebruikt.

Aanbevolen werkwijze

Rond Selectie, Regels en noodzakelijke Manipulaties af.
Begin bij alle verplichte doelvelden.
Beoordeel ieder Concept op betekenis en formaat.
Gebruik Smart Fields voor productafhankelijke waarden en vaste waarden alleen voor echte constanten.
Test combinaties op lege velden en lengtelimieten.
Bekijk meerdere previewproducten uit verschillende bronnen.
Sla de mapping op.
Open Coverage & kwaliteit en los kritieke hiaten op.
Controleer na de uitvoer Resultaten en Logs.