JavaScript API & Server-Side API

JavaScript API

De volgende handleiding helpt je bij het instellen en gebruiken van de JavaScript API. Als je een volledige e-commerce integratie plant, bekijk dan deze handleiding.

De Klaviyo snippet toevoegen

Om te beginnen met tracking, voeg je de onderstaande snippet toe aan de rechterkant in de hoofdpagina van je website template zodat deze automatisch wordt toegevoegd aan elke pagina op je website. Als je een ontwikkelaar hebt die dit script aan je website toevoegt, kun je hem een link naar deze handleiding sturen.

Je moet één wijziging aanbrengen in het knipsel. Als je een e-commerce bedrijf bent, verwijder dan de vier regels met de oproep "identify". Als je een website of webapp bent waarop mensen inloggen, vervang dan de {{ email }} placeholder e-mail door de juiste templatetag met het e-mailadres van de inloggen gebruiker.

We raden aan om de Klaviyo code onderaan of in de buurt van de template van je site te plaatsen. Als je Google analyses of andere diensten van derden gebruikt, kun je de code Klaviyo direct daarboven of daaronder plaatsen.

Je vraagt je misschien af: "Hoe beïnvloedt het gebruik van Klaviyo de prestaties van mijn site?" Het antwoord is dat Klaviyo de prestaties van je website helemaal niet beïnvloedt. Onze code wordt pas geladen als de rest van je website klaar is met laden. Bovendien vertelt Klaviyo browsers om onze JavaScript in de cache te plaatsen, zodat uw bezoekers vaak niet eens onze JavaScript hoeven te downloaden telkens als ze van pagina wisselen.

API Basis

Om de Klaviyo API aan te roepen en informatie over mensen te krijgen, gebruik je het _learnq object dat automatisch wordt toegevoegd door het Klaviyo script.

Om een API-oproep te doen, gebruikt Klaviyo een speciale syntaxis waardoor uw API-oproepen zelfs werken als ons script nog niet op de pagina is geladen. Je maakt een array waarin de eerste waarde de naam is van de methode die je wilt aanroepen en alle volgende waarden zijn argumenten om aan die methode door te geven.

Mensen identificeren

Met de methode identificeren kun je eigenschappen van een individu identificeren en instellen. Deze methode accepteert een woordenboek of hash van eigenschappen. Als je iemand identificeert, moet je of zijn e-mailadres, met de $e-mail sleutel, of een unieke identificatie zoals zijn gebruikers-ID, met de $id sleutel, toevoegen.

Als je ten minste één van deze identifiers hebt opgenomen, ben je vrij om alle aangepaste eigenschappen toe te voegen die je wilt. Aangepaste eigenschappen zijn handig voor tracking feiten over individuen. In Klaviyo kun je vervolgens segmenten van mensen maken op basis van die eigenschappen. Je wilt bijvoorbeeld het abonnementstype of de aanmeldingsdatum van een individu bijhouden. Klaviyo begrijpt ook de verschillende gegevenstypen die je gebruikt, dus voel je vrij om getallen, booleans en datums te gebruiken.

Klaviyo heeft een paar speciale eigenschappen die worden gebruikt om informatie over mensen weer te geven. Dit zijn: $voornaam, $achternaam, $telefoonnummer, $titel en $organisatie.

Naast de eigenschappen die je volgt, zal Klaviyo automatisch bepalen vanaf welke website elke persoon het eerst werd doorverwezen voor attributie tracking en de locatie van een persoon op basis van waar ze je website bezoeken.

Voorbeeldcode: 

Gebeurtenissen en acties volgen

Met de trackmethode kun je gebeurtenissen en acties registreren die mensen op je website ondernemen. Deze methode accepteert een string die de naam is die je aan die gebeurtenis geeft. Deze methode accepteert ook een optioneel woordenboek of hash van eigenschappen die bij die gebeurtenis horen.

Je kunt bijvoorbeeld bijhouden wanneer iemand een artikel koopt en informatie toevoegen over de aankoopprijs en welke artikelen ze hebben gekocht. Als je een applicatie hebt waar mensen een profiel hebben, kun je bijhouden wanneer iemand zijn profiel invult. Als je een volledige e-commerce integratie plant, bekijk dan deze handleiding.

Klaviyo tracking en analyses zijn zeer flexibel, zodat je ze kunt aanpassen om bij te houden wat belangrijk is voor je bedrijf. Onze trackmethode begrijpt ook verschillende soorten gegevens, dus je kunt getallen, booleans en datums gebruiken en wij maken intelligente grafieken en diagrammen op basis van de gegevens die je stuurt.

Voorbeeldcode: 

Server-kant API