JavaScript-API
Der folgende Leitfaden zeigt dir, wie du die JavaScript-API einrichtest und verwendest. Wenn du eine vollständige E-Commerce-Integration planst, lies bitte diesen Leitfaden.
Hinweis
Um die Klaviyo Schnipsel zu verwenden, die unten bereitgestellt werden, musst du den Platzhalter für API mit deinem öffentlichen API-Schlüssel aktualisieren , den du hier findest.
Hinzufügen des Klaviyo-Snippets
Um mit dem Tracking zu beginnen, fügst du das unten stehende Snippet rechts in die Hauptvorlage deiner Website ein, damit es automatisch auf jeder Seite deiner Website eingefügt wird. Wenn du einen Entwickler hast, der dieses Skript zu deiner Website hinzufügt, kannst du ihm einen Link zu diesem Leitfaden schicken.
Du musst eine Änderung an dem Snippet vornehmen. Wenn du ein E-Commerce-Unternehmen bist, entferne die vier Zeilen mit dem Aufruf "identifizieren". Wenn du eine Website oder eine Webapplikation bist, in die sich Leute einloggen, ersetze den {{ email }} Platzhalter E-Mail durch den entsprechenden Vorlagen-Tag, der die E-Mail-Adresse des eingeloggten Benutzers enthält.
Wir empfehlen, den Klaviyo-Code am oder in der Nähe des unteren Randes deiner Website-Vorlage zu platzieren. Wenn du Google Analytics oder andere Dienste von Drittanbietern nutzt, kannst du den Klaviyo-Code direkt darüber oder darunter platzieren.
Du fragst dich vielleicht: "Wie wirkt sich die Nutzung von Klaviyo auf die Leistung meiner Website aus?" Die Antwort ist, dass Klaviyo die Leistung deiner Website überhaupt nicht beeinträchtigt. Unser Code wird erst geladen, wenn der Rest deiner Website fertig geladen ist. Außerdem weist Klaviyo die Browser an, unser JavaScript zwischenzuspeichern, damit deine Besucherinnen und Besucher nicht bei jedem Seitenwechsel unser JavaScript herunterladen müssen.
Prüfe dein Skript
Sobald du das JavaScript zu deiner Website hinzugefügt hast, kannst du überprüfen, ob es richtig eingerichtet ist, indem du die URL deiner Website rechts eingibst.
Sobald das Skript auf deiner Website installiert ist, wird Klaviyo die Besuche und Sitzungen auf deiner Website in Echtzeit verfolgen.
API-Grundlagen
Um die Klaviyo API aufzurufen und Informationen über Personen zu laden, verwendest du das _learnq-Objekt, das automatisch vom Skript Klaviyo hinzugefügt wird.
Um einen API-Aufruf zu tätigen, verwendet Klaviyo eine spezielle Syntax, mit der deine API-Aufrufe auch dann funktionieren, wenn unser Skript noch nicht auf der Seite geladen ist. Du erstellst ein Array, in dem der erste Wert der Name der Methode ist, die du aufrufen willst, und alle weiteren Werte sind Argumente, die du an die Methode übergeben kannst.
Menschen identifizieren
Mit der Identifizierungsmethode kannst du Eigenschaften einer Person identifizieren und festlegen. Diese Methode akzeptiert ein Wörterbuch oder einen Hash mit Eigenschaften. Wenn du jemanden identifizierst, musst du entweder seine E-Mail-Adresse mit dem Schlüssel $E-Mail oder eine eindeutige Kennung wie seine Benutzer-ID mit dem Schlüssel $id angeben.
Sobald du mindestens einen dieser Identifikatoren hinzugefügt hast, kannst du alle gewünschten Eigenschaften hinzufügen. Benutzerdefinierte Eigenschaften sind nützlich, um Fakten über Personen zu verfolgen. In Klaviyo kannst du dann auf der Grundlage dieser Eigenschaften Personensegmente erstellen. Du könntest zum Beispiel den Abonnementtyp oder das Anmeldedatum einer Person verfolgen. Klaviyo versteht auch die verschiedenen Datentypen, die du verwendest, also kannst du auch Zahlen, Boolesche Werte und Daten verwenden.
Klaviyo hat ein paar besondere Eigenschaften, die verwendet werden, um Informationen über Personen anzuzeigen. Diese sind: $Vorname, $Nachname, $Telefonnummer, $Titel und $Organisation.
Zusätzlich zu den Eigenschaften, die du verfolgst, stellt Klaviyo automatisch fest, von welcher Website jede Person zuerst verwiesen wurde, um die Attribution zu verfolgen, und den Standort einer Person, basierend auf dem Ort, an dem sie deine Website besucht.
Beispiel-Code:
Ereignisse und Aktionen nachverfolgen
Mit der Tracking-Methode kannst du Ereignisse und Aktionen aufzeichnen, die Menschen auf deiner Website durchführen. Diese Methode akzeptiert eine Zeichenkette, die der Name ist, den du dem Ereignis gibst. Diese Methode akzeptiert auch ein optionales Wörterbuch oder einen Hash von Eigenschaften, die mit diesem Ereignis verbunden sind.
Du könntest zum Beispiel nachverfolgen, wann jemand einen Artikel kauft und Informationen über den Kaufpreis und die gekauften Artikel einfügen. Wenn du eine Anwendung hast, in der Menschen ein Profil haben, kannst du verfolgen, wann jemand sein Profil ausfüllt. Wenn du eine vollständige E-Commerce-Integration planst, lies bitte diesen Leitfaden.
Die Ereignisverfolgung und die Analysefunktionen von Klaviyo sind sehr flexibel, sodass du sie so anpassen kannst, dass du die für dein Unternehmen wichtigen Daten im Blick behältst. Unsere Tracking-Methode versteht auch verschiedene Datentypen. Du kannst also Zahlen, Boolesche Werte und Daten verwenden und wir erstellen intelligente Diagramme und Grafiken auf der Grundlage der von dir gesendeten Daten.
Beispiel-Code: