Wie du mit der API für Gruppenmitgliedschaften von Klaviyo Onsite-Inhalte personalisieren kannst

Du wirst lernen

Lerne, wie du die getGroupMembership-Methode des Klaviyo-JavaScript-Objekts verwendest, um eine Onsite-Personalisierung auf deiner Website zu implementieren. Dazu musst du das Klaviyo-Objekt laden und ein Array von Listen oder Segmenten zur Überprüfung übergeben, das eine Ausgabe zurückgibt, die du für die Onsite-Personalisierung nutzen kannst.

Bevor du beginnst

Wenn du das Onsite-Tracking von Klaviyo zu deiner Website hinzufügst, werden nur die Surfaktivitäten von "bekannten Browsern" getrackt (d.h. Browser, die die Website besucht haben und identifiziert wurden oder "cookied"). Das Onsite-Tracking von Klaviyo verfolgt keine anonymen Browser. Es gibt 3 Möglichkeiten, wie Klaviyo einen Website-Besucher für das Onsite-Tracking identifizieren kann:

• Wenn jemand durch eine Klaviyo E-Mail auf deine Website geklickt hat.
• Wenn sich jemand über ein Klaviyo-Formular angemeldet hat.
• Wenn sich jemand auf deiner Website eingeloggt hat und du Tracking installiert hast.

Installiere Klaviyo.js und lade das Klaviyo-Objekt

Zuerst musst du Klaviyo.js installieren, falls du das noch nicht getan hast. Klaviyo.js, auch bekannt als Klaviyo's "Active on Site" JavaScript, unterstützt automatisch das Klaviyo Objekt. Wenn du eine Integration mit deinem Klaviyo Konto aktiviert oder Klaviyo.js manuell installiert hast, kannst du das Klaviyo Objekt initiieren, um nach relevanten Anrufen zu lauschen.

Um das Klaviyo-Objekt sofort beim Laden der Seite zu verwenden, empfehlen wir, das folgende Snippet manuell auf deiner Website zu installieren (zusätzlich zur Installation von Klaviyo.js wie oben erwähnt). Das Klaviyo-Objekt muss nur einmal pro Seite geladen werden.

Um das Klaviyo-Objekt zu laden:

So verwendest du die getGroupMembership-Methode des Klaviyo JavaScript-Objekts für die Personalisierung vor Ort:

1. Wähle innerhalb deines Codes die Liste oder die Segment-IDs aus, für die du die Mitgliedschaft prüfen möchtest. Die Grenze ist 50 Liste oder Segment.
2. Identifiziere Nutzer/innen auf deiner Website über ein Klaviyo-Formular oder auf andere Weise.
3. Mache einen Aufruf im folgenden Format mit einem Array der Listen- oder Segment-IDs, für die du die Mitgliedschaft prüfen willst:

Klaviyo.getGroupMembership(['listID1', 'listID2', 'listID3'])

Die Ausgabe ist ein Array mit den Listen-/Segment-IDs, zu denen der identifizierte Nutzer gehört, wenn diese IDs im Eingabe-Array enthalten sind. Wenn ein leeres Array zurückgegeben wird, bedeutet das, dass du zu viele IDs übergeben hast oder dass der Nutzer zu keiner der von dir angegebenen Listen oder Segmente gehört.

Du kannst die zurückgegebenen Segment- und Listen-Mitgliedsdaten nutzen, um deine Website mit relevanten Produkten, Inhalten und mehr auf Basis des Kunden-Segments von Klaviyo anzupassen.

Code-Beispiel

Hier ist ein Beispiel, das zeigt, wie du die getGroupMembership-API mit mehreren Segment-IDs aufrufen kannst.

const customerSegments = await Klaviyo.getGroupMembership([
  VIPSegmentID,
  UnEngagedSegmentID,
  HundeliebhaberSegmentID,
]);

Auswirkungen auf die Leistung der Website

Die Gruppenmitgliedschafts-API hat nur minimale Auswirkungen auf die Leistung deiner Website. Die Javascript-Datei (z.B. web_personalization.js), die Klaviyo auf deine Website lädt, ist nur etwa 1,2 KB groß und die Bündelanforderung für diese Datei blockiert nicht den Haupt-Thread, sodass sie die Nutzbarkeit der Seiten nicht beeinträchtigt.

Die Daten, die geladen werden, um eine Website auf der Grundlage des Kunden-Profilings anzupassen, werden nach der ersten Anfrage im Browser zwischengespeichert, sodass weitere Anfragen keine Backend-Aufrufe von API erfordern.

Ergebnis

Du kannst das Klaviyo-JavaScript-Objekt jetzt mit Web-Personalisierungstools verwenden und Inhalte auf der Grundlage von Segment- oder Listenmitgliedschaften personalisieren.

Zusätzliche Ressourcen

Einführung in das Klaviyo-Objekt

Das Datenmodell von Klaviyo

Glossar der gängigen API-Begriffe