Die Identify API verknüpft eine E-Mail-Adresse mit einem Besucher. Dadurch landen frühere Seitenaufrufe, Suchen und Quizze im Kundenprofil. Die Integrationen für Shopify, WooCommerce und Magento rufen sie im Checkout bereits auf. Nutze sie selbst in anderen Shops oder nach einem Login oder einer Newsletter-Anmeldung.
Aus der Storefront
Auf einer Seite, auf der das bluebarry-Skript läuft, reicht eine Zeile:
window.barry.identify({ email: "[email protected]" });Das Skript ergänzt die Besucher-ID und, falls vorhanden, die aktuelle Quiz-Session. Ohne E-Mail-Adresse passiert nichts.
Von deinem Server
Für einen Aufruf aus deinem Backend, etwa aus einem Bestell-Webhook, brauchst du die Besucher-ID. Lies sie im Browser mit window.barry.getUid() aus und gib sie mit der Bestellung weiter.
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>" }'| Feld | Pflicht | Bedeutung |
|---|---|---|
email | Ja | Die E-Mail-Adresse, bis 256 Zeichen. |
userId | Ja | Die Besucher-ID aus window.barry.getUid(). |
sessionId | Nein | Eine Quiz-Session-ID, falls du eine hast. |
Zur Authentifizierung dient deine Tenant ID im Header BB-Tenant-Id, genau wie in der Storefront. Du findest sie oben auf der Seite Integrations. Ein erfolgreicher Aufruf liefert 204 No Content, eine ungültige E-Mail-Adresse 400.
Was passiert
- bluebarry legt für den Besucher immer ein Profil an oder aktualisiert es. Ein Quiz ist nicht nötig. Der Aufruf wird nur übersprungen, wenn die Besucher-ID fehlt.
- Eine E-Mail-Adresse, die das Profil schon hat, wird nie überschrieben.
- Andere Datensätze mit derselben E-Mail-Adresse oder Besucher-ID werden zu einem Profil zusammengeführt.
- Quiz-Ereignisse von vor dem Identify-Aufruf werden nicht nachträglich an Klaviyo oder Omnisend gesendet. Wer im Checkout erkannt wird, löst für ein früheres anonymes Quiz keinen „Quiz Completed“-Flow aus.
Die Sicht für Händler findest du in So erkennt bluebarry Kundinnen und Kunden.