Heeft een klant een quiz gedaan, dan kun je op elke productpagina laten zien hoe goed dat product bij zijn antwoorden past, bijvoorbeeld "Past bij je droge huid". De Product Match API geeft de antwoordlabels terug waaraan een product voor de huidige klant voldoet, dezelfde labels die je quizresultaatpagina toont.
De webshophelper gebruiken
Roep op een pagina waar het bluebarry-script draait getProductMatch aan met de URL van het product:
window.barry.getProductMatch(window.location.href)
.then((matches) => {
// bijv. [{ label: "Great for dry skin" }, { label: "Fragrance free" }]
if (matches.length) showFitBadge(matches.map((m) => m.label));
})
.catch(() => { /* geen quizantwoorden voor deze klant, of een time-out */ });- bluebarry zoekt het product waarvan de URL het begin is van je pagina-URL, dus querystrings maken niet uit.
- Het gebruikt de laatste antwoorden van de klant en de matchregels van de quiz die hij het laatst deed.
- Een lege lijst betekent dat het product bij geen van zijn antwoorden past, of dat bluebarry het product niet kent.
- Heeft de klant in deze browser nog nooit een quiz gedaan, dan wordt de promise na 10 seconden afgewezen. Toon in dat geval je gewone pagina.
Het endpoint erachter
De helper roept een openbaar endpoint aan dat je ook zelf kunt aanroepen als je de bezoekers-ID en de quiz kent:
curl "https://api.bluebarry.ai/ProductMatch?productUrl=<product url>&userId=<visitor id>" \
-H "bluebarry-id: <your tenant id>" \
-H "bluebarry-advisor-id: <quiz id>"De response is een JSON-array met { "label": "…" }-objecten. productUrl en userId zijn verplicht. Zonder die twee krijg je 400.
Tips
- Antwoordlabels komen uit je quiz. Schrijf ze zo dat ze goed lezen op een productpagina.
- Wil je klanten zelf een product laten checken, dan past een productcheck misschien beter. Zie een productcheck lanceren op Shopify.