Hoe je onsite content kunt personaliseren met Klaviyo's API voor groepslidmaatschap

Wat je leert

Leer hoe je de Klaviyo JavaScript-object getGroupMembership gebruikt, waarmee je onsite personalisatie op je website kunt implementeren. Hiervoor moet je het Klaviyo object geladen en een array van lijst of segment doorgegeven om te controleren, die een uitvoer retourneert die je kunt gebruiken voor onsite personalisatie.

Voordat je van start gaat

Wanneer u Klaviyo's onsite tracking toevoegt aan uw site, wordt alleen de surfactiviteit van "bekende browsers" gevolgd (d.w.z. browsers die hebben bezocht, betrokken en zijn geïdentificeerd of "gekookt"). KlaviyoOnsite tracking traceert geen anonieme browsers. Er zijn 3 belangrijke manieren waarop Klaviyo een websitebezoeker identificeert voor onsite tracking:

• Indien iemand via een Klaviyo-e-mail naar uw website is doorgeklikt
• Indien iemand zich heeft aangemeld via een Klaviyo-formulier
• Als iemand zich op uw site heeft aangemeld en u tracking heeft geïnstalleerd

Bekijk onze Klaviyo video over het gebruik van de groepslidmaatschap API.

Installeer Klaviyo.js en laad het Klaviyo object

U dient eerst Klaviyo.js te installeren, indien u dit nog niet heeft gedaan. Klaviyo.js, ook bekend als Klaviyo's Active on Site JavaScript, ondersteunt automatisch het klaviyo-object. Indien u een integratie met uw Klaviyo-account hebt ingeschakeld of Klaviyo.js handmatig hebt geïnstalleerd, kunt u het klaviyo-object activeren om te luisteren naar relevante oproepen.

Om het Klaviyo object onmiddellijk te gebruiken bij het laden van de pagina, raden we aan om het onderstaande knipsel handmatig op je site te installeren (naast de installatie van Klaviyo.js zoals hierboven vermeld). Het Klaviyo hoeft maar één keer per pagina geladen te worden.

Om het Klaviyo object te laden:

Om de Klaviyo JavaScript object's getGroupMembership methode te gebruiken voor onsite personalisatie:

1. Selecteer binnen je code de lijst of segment-ID's waarvoor je het lidmaatschap wilt controleren. De limiet is 50 lijst of segment.
2. Identificeer gebruikers op uw site via een Klaviyo formulier of op een andere manier.
3. Doe een oproep in het volgende formaat, met een array van de lijst of segment ID's waarvoor je het lidmaatschap wilt controleren:

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

De uitvoer is een matrix van de lijst/segment-ID's waartoe de geïdentificeerde gebruiker behoort, gegeven dat die ID's in de invoer matrix stonden. Als er een lege array wordt geretourneerd, betekent dit dat je te veel ID's hebt doorgegeven of dat de gebruiker niet behoort tot een van de lijsten of segmenten die je hebt opgegeven.

Je kunt de geretourneerde segment en lijst lidmaatschapsgegevens gebruiken om je site aan te passen met relevante producten, inhoud en meer op basis van klantsegment van Klaviyo.

Code voorbeeld

Hier is een voorbeeld dat laat zien hoe je de getGroupMembership API kunt aanroepen met meerdere segment-ID's.

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

Invloed op de prestaties van de site

De groepslidmaatschap API heeft minimale invloed op de prestaties van je site. Het Javascript bestand (bijv. web_personalization.js) dat Klaviyo op uw site laadt is slechts ongeveer 1.2KB en het bundelverzoek voor dit bestand is niet main thread blokkerend, dus het heeft geen invloed op de bruikbaarheid van de pagina's.

De gegevens die worden geladen om een site aan te passen op basis van het klantprofiel, worden in de cache van de browser opgeslagen nadat ze voor het eerst zijn opgevraagd, zodat voor extra verzoeken geen API-aanroepen aan de achterkant nodig zijn.

Resultaat

Je kunt nu het Klaviyo JavaScript-object gebruiken met tools voor webpersonalisatie en om onsite-inhoud te personaliseren op basis van segment of lijstlidmaatschap.

Extra hulpbronnen

Inleiding tot het Klaviyo object

Klaviyogegevens model

Verklarende woordenlijst van veelgebruikte API-termen

Gebruik Klaviyo's groepslidmaatschap API