De Identify API koppelt een e-mailadres aan een bezoeker, zodat zijn eerdere bezoeken, zoekopdrachten en quizzen bij zijn klantprofiel komen. De koppelingen met Shopify, WooCommerce en Magento roepen hem al aan bij de checkout. Gebruik hem zelf op andere webshops, of na een login of aanmelding voor de nieuwsbrief.
Vanuit de webshop
Op een pagina waar het bluebarry-script draait, is één regel genoeg:
window.barry.identify({ email: "[email protected]" });Het script voegt de bezoekers-ID toe en, als die er is, de huidige quizsessie. Zonder e-mailadres doet het niets.
Vanaf je server
Om hem vanuit je backend aan te roepen, bijvoorbeeld vanuit een orderwebhook, heb je de bezoekers-ID nodig. Lees die in de browser uit met window.barry.getUid() en stuur hem mee met de bestelling.
curl -X POST https://data.bluebarry.ai/data/identify \
-H "Content-Type: application/json" \
-H "BB-Tenant-Id: <your tenant id>" \
-d '{ "email": "[email protected]", "userId": "<visitor id>" }'| Veld | Verplicht | Betekenis |
|---|---|---|
email | Ja | Het e-mailadres van de klant, maximaal 256 tekens. |
userId | Ja | De bezoekers-ID uit window.barry.getUid(). |
sessionId | Nee | Een quizsessie-ID, als je die hebt. |
Je authenticeert met je Tenant ID in de header BB-Tenant-Id, net als de webshop. Je vindt hem bovenaan de pagina Integrations. Een geslaagde aanroep geeft 204 No Content terug. Een ongeldig e-mailadres geeft 400.
Wat er gebeurt
- bluebarry maakt altijd een profiel voor de bezoeker aan of werkt het bij. De bezoeker hoeft geen quiz te hebben gedaan. De aanroep wordt alleen overgeslagen als de bezoekers-ID ontbreekt.
- Een e-mailadres dat al in het profiel staat, wordt nooit overschreven.
- Andere records van de bezoeker met hetzelfde e-mailadres of dezelfde bezoekers-ID worden samengevoegd tot één profiel.
- Quizevents van vóór de identify-aanroep worden achteraf niet naar Klaviyo of Omnisend gestuurd. Een klant die bij de checkout wordt geïdentificeerd, start dus geen "Quiz Completed"-flow voor een eerdere anonieme quiz.
Hoe dit er voor jou als merchant uitziet, lees je in hoe bluebarry klanten herkent.