JavaScript API
I följande guide går vi igenom hur du konfigurerar och använder JavaScript API. Om du planerar en fullständig integration av e-handel, se den här guiden.
Anteckning
För att använda Klaviyo-kodavsnitten nedan måste du uppdatera platshållaren för API_KEY med din offentliga API-nyckel, som du hittar här.
Lägga till Klaviyo-snippet
För att börja spåra människor, lägg till nedanstående snippet till höger i din webbplats huvudgalleri så kommer det automatiskt att läggas till på varje sida på din webbplats. Om du har en utvecklare som ska lägga till det här skriptet på din webbplats kan du skicka en länk till den här guiden till dem.
Du måste göra en ändring i utdraget. Om du är ett e-handelsföretag kan du ta bort de fyra raderna med "identifiera" samtal. Om du är en webbplats eller webbapp som folk loggar in på, byt ut {{ email }} platshållaren e-post med lämplig malltagg som har den inloggade användarens e-postadress.
Vi föreslår att du placerar Klaviyo -koden längst ned eller nära botten av din webbplats. Om du använder Google analys eller andra tjänster från tredje part kan du placera Klaviyo -koden direkt ovanför eller under den.
Du kanske undrar, "Hur påverkar användningen av Klaviyo min webbplats prestanda?" Svaret är att Klaviyo inte påverkar din webbplats prestanda alls. Vår kod laddas först när resten av din webbplats har laddats färdigt. Dessutom säger Klaviyo till webbläsare att cacha vårt JavaScript så att dina besökare ofta inte ens behöver ladda ner vårt JavaScript varje gång de byter sida.
Kontrollera ditt manus
När du har lagt till JavaScript på din webbplats kan du kontrollera att den är korrekt inställd genom att ange webbadressen till din webbplats till höger.
När skriptet finns på din webbplats kommer Klaviyo att börja spåra besök och sessioner på din webbplats i realtid.
Grunderna i API
För att göra anrop till Klaviyo API och butikinformation om personer använder du objektet _learnq som automatiskt läggs till av skriptet Klaviyo.
För att göra ett API-anrop använder Klaviyo en speciell syntax som gör att dina API-anrop fungerar även när vårt skript inte har laddats på sidan ännu. Du kommer att skapa en array där det första värdet är namnet på den metod du vill anropa och alla efterföljande värden är argument som ska skickas till den metoden.
Identifiering av personer
Med identifieringsmetoden kan du identifiera och ange egenskaper för en individ. Denna metod accepterar en ordbok eller en hash med egenskaper. När du identifierar någon måste du ange antingen e-postadressen, med nyckeln $e-post, eller en unik identifierare som t.ex. användar-ID, med nyckeln $id.
När du har inkluderat minst en av dessa identifierare är det fritt fram att lägga till de anpassade egenskaper du vill. Anpassade egenskaper är användbara för att spåra fakta om individer. I Klaviyo kan du sedan skapa segment av människor baserat på dessa egenskaper. Du kanske till exempel vill spåra en individs abonnemangstyp eller Registrera dig-datum. Klaviyo kommer också att förstå olika data typer som du använder, så använd gärna siffror, booleaner och datum.
Klaviyo har några speciella egenskaper som används för att visa information om personer. Dessa är: $förnamn, $efternamn, $telefonnummer, $titel och $organisation.
Utöver de egenskaper som du spårar kommer Klaviyo automatiskt att avgöra vilken webbplats varje person först hänvisades från för attributionsspårning och en persons plats baserat på var de besöker din webbplats.
Exempel på kod:
spårning Händelser och åtgärder
Med spårmetoden kan du registrera händelser och åtgärder som människor vidtar på din webbplats. Den här metoden accepterar en sträng som är det namn du ger händelsen. Denna metod accepterar också en valfri ordbok eller hash med egenskaper som är associerade med den händelsen.
Du kan till exempel spåra när någon köper en vara och inkludera information om inköpspriset och vilka varor de köpte. Om du har en applikation där människor har en profil kan du spåra när någon fyller i sin profil. Om du planerar en fullständig integration av e-handel, se den här guiden.
Klaviyo's eventspårning och analys är mycket flexibla, så att du kan anpassa dem för att hålla reda på vad som är viktigt för ditt företag. Vår spårningsmetod förstår också olika data -typer, så du kan använda siffror, booleaner och datum och vi kommer att skapa intelligenta diagram och grafer baserat på data du skickar.
Exempel på kod: