Terug naar het helpcentrum
Helpcentrum

Klaviyo-koppeling

Loyalo stuurt momenten uit je abonnementen en je spaarprogramma door naar Klaviyo, zodat je daar flows en segmenten bouwt. Je koppelt per winkel je eigen API-sleutel en test eerst met je eigen e-mailadres.

Bijgewerkt: 19 oktober 2026

Sleutel koppelen

  1. API-sleutel toevoegenMaak in Klaviyo een private API-sleutel (Settings > API keys, met Full Access voor Accounts, Events en Profiles) en vul hem in bij Instellingen > Integraties. Elke winkel heeft een eigen sleutel.
  2. Controleer de koppeling met profielenLoyalo koppelt een klant aan een Klaviyo-profiel via het klantnummer van Shopify, en anders via het e-mailadres.
  3. Testevent versturenKies een event, vul je eigen e-mailadres in en klik op 'Testevent sturen'. Binnen een minuut zie je het bij het profiel en onder Analytics > Metrics in Klaviyo. Een testevent heeft het veld loyalo_test, zodat je het in je flow kunt uitsluiten.
  4. Kies wie de e-mail stuurtStuurt je Klaviyo-flow de mail voor een moment, zet dan de e-mail van Loyalo voor dat moment uit bij Instellingen > E-mails. Klaviyo krijgt het event nog steeds; zo krijgt een klant geen dubbele mail.

Events en profielvelden

Loyalo stuurt events voor abonnementen (gestart, gepauzeerd, hervat, overgeslagen, opgezegd, aankomende levering), betalingen (mislukt, alsnog gelukt, kaart verloopt), punten (verdiend, beloning beschikbaar, ingewisseld, nieuwe tier), klantwaarde (ander segment) en B2B. Elk event heet in Klaviyo "Loyalo" plus de naam, bijvoorbeeld "Loyalo Subscription Started", en je zet elk event apart aan of uit. Daarnaast vult Loyalo profielvelden die met `loyalo_` beginnen, zoals het puntensaldo, de status van het abonnement of het RFM-segment. Loyalo zet in Klaviyo geen tags. Welke velden een event meestuurt, zie je op de pagina Integraties onder 'Payload per event': het laatste echte event, of een voorbeeld als het nog niet is verstuurd.

OnderdeelWaar te vinden
EventsKlaviyo > Metrics, de metrics die met Loyalo beginnen
ProfielveldenKlaviyo-profiel van de klant, velden met prefix loyalo_
Koppeling met het profielKlantnummer van Shopify, anders het e-mailadres

Punten tonen in je eigen e-mails

Loyalo houdt het puntensaldo en de tier van elke klant bij op het Klaviyo-profiel. Die velden gebruik je in elk template dat je al hebt, bijvoorbeeld als vast blok in de footer van je nieuwsbrief.

ProfielveldInhoud
loyalo_points_balanceHet huidige puntensaldo
loyalo_points_nameHoe je punten heten, in de taal van de klant
loyalo_points_valueWat het saldo waard is, op basis van je beloning met een vast bedrag
loyalo_rewards_availableHet aantal beloningen dat de klant nu kan inwisselen
loyalo_next_rewardDe eerstvolgende beloning waar de klant voor spaart
loyalo_points_to_next_rewardHoeveel punten de klant daarvoor nog nodig heeft
loyalo_points_expiringPunten die binnen 30 dagen vervallen
loyalo_points_expire_dateDe eerste datum waarop punten vervallen
loyalo_loyalty_urlDe link naar je loyaltypagina (uit Huisstijl), anders het klantaccount
loyalo_lifetime_pointsAlle punten die de klant ooit heeft verdiend
loyalo_tierDe naam van de tier van de klant
loyalo_next_tierDe naam van de volgende tier
loyalo_next_tier_remainingWat de klant nog nodig heeft voor de volgende tier, in de eenheid waarop je tiers bepaalt
Je hebt {{ person|lookup:'loyalo_points_balance'|default:0 }} {{ person|lookup:'loyalo_points_name'|default:'punten' }}{% if person|lookup:'loyalo_tier' %} · {{ person|lookup:'loyalo_tier' }}{% endif %}.
{% if person|lookup:'loyalo_points_to_next_reward' %}Nog {{ person|lookup:'loyalo_points_to_next_reward' }} tot {{ person|lookup:'loyalo_next_reward' }}.{% endif %}
{% if person|lookup:'loyalo_points_expiring' %}Let op: {{ person|lookup:'loyalo_points_expiring' }} {{ person|lookup:'loyalo_points_name'|default:'punten' }} vervallen binnenkort.{% endif %}
Plak dit in een tekstblok van je template. Dezelfde tekst staat met een kopieerknop op de pagina Integraties in je dashboard.
  1. Voeg een tekstblok toeOpen je template in Klaviyo en zet een tekstblok in de footer. Plak de regels hierboven erin en maak de tekst op in je eigen stijl.
  2. Toon het blok alleen aan klanten met puntenKies bij het blok het tabblad Display en vul bij Show/hide logic in: person|lookup:'loyalo_points_balance' > 0. Klanten zonder punten zien het blok dan niet.
  3. Voeg een link toeZet onder het blok een knop en vul als link {{ person|lookup:'loyalo_loyalty_url' }} in. Die gaat naar je loyaltypagina, waar de klant direct kan inwisselen.
  4. Gebruik het blok overalSla het blok in Klaviyo op als universal content. Je past het dan op één plek aan voor al je templates.

Het profiel wordt kort na elke wijziging in punten, tier of abonnement bijgewerkt, en één keer per dag loopt Loyalo alle profielen na. Zet daarvoor 'Klantprofielen bijwerken' aan op de pagina Integraties; met 'Profielen nu bijwerken' start je het direct. De velden staan alleen op profielen van klanten met punten, een tier, een abonnement of een klantwaardesegment.

Ook in Shopify

Dezelfde gegevens staan als metaveld op de klant in Shopify, in de naamruimte loyalo: points_balance, points_lifetime, tier en tier_name. Daarmee toon je het saldo ook in Shopify Email en gebruik je het in Flow. Zet daarvoor 'Profiel naar Shopify schrijven' aan op de pagina Tiers.

Klantwaarde op het profiel

Heb je Scale of Scale B2B, dan zet Loyalo ook het RFM-segment en de klantwaarde van elke klant op het Klaviyo-profiel (zie Analyse en rapportage). De velden worden elke dag bijgewerkt, na de berekening van de nacht. Zo bouw je in Klaviyo segmenten op segment, score of waarde zonder eigen berekening.

ProfielveldInhoud
loyalo_rfm_segmentDe naam van het segment in de taal van je winkel, bijvoorbeeld Dreigen af te haken
loyalo_rfm_segment_handleDe vaste code van het segment: champions, loyal, potential, new, attention, at_risk, cant_lose of hibernating
loyalo_rfm_scoreDe RFM-score als tekst, bijvoorbeeld 2-4-5
loyalo_rfm_r, loyalo_rfm_f, loyalo_rfm_mDe drie scores apart, elk van 1 tot 5
loyalo_rfm_sinceSinds wanneer de klant in dit segment zit
loyalo_last_order_dateDe datum van de laatste betaalde bestelling
loyalo_orders_12mHet aantal betaalde bestellingen in de laatste 12 maanden
loyalo_revenue_12mDe omzet van die bestellingen
loyalo_clv_historicDe klantwaarde tot nu: wat de klant heeft besteed
loyalo_clv_predicted_12mDe verwachte klantwaarde voor de komende 12 maanden, leeg zolang je winkel minder dan 90 dagen aan bestelgeschiedenis heeft
loyalo_clv_totalDe klantwaarde tot nu plus de verwachte waarde
loyalo_clv_bandtop10, top25 of rest: of de klant bij je waardevolste 10% of 25% hoort
loyalo_avg_days_between_ordersHet gemiddelde aantal dagen tussen bestellingen
loyalo_expected_next_orderDe datum waarop de volgende bestelling te verwachten is

Gaat een klant naar een ander segment, dan stuurt Loyalo het event Loyalo Segment Changed. Dat gebeurt vanaf de tweede nacht, want de eerste nacht krijgt elke klant zijn eerste segment. Net als de andere events zet je het apart aan of uit op de pagina Integraties.

Veld in het eventInhoud
from_segment, to_segmentDe code van het oude en het nieuwe segment, bijvoorbeeld loyal en at_risk
from_segment_name, to_segment_nameDe namen van die segmenten in de taal van je winkel
rfm_scoreDe nieuwe RFM-score, bijvoorbeeld 2-4-5
clv_totalDe klantwaarde tot nu plus de verwachte waarde
is_subscriberOf de klant een lopend abonnement heeft

Voorbeeldflows

  • Een win-back-flow op het event Subscription Cancelled
  • Een herinneringsflow op het event Upcoming Delivery
  • Een segment op puntensaldo met het profielveld loyalo_points_balance
  • Een winback-flow op het event Loyalo Segment Changed, met als trigger filter to_segment is gelijk aan at_risk: de klant was goed en is lang stil
  • Een VIP-segment met het profielveld loyalo_clv_band gelijk aan top10, voor vroege toegang tot een nieuw product of een persoonlijke mail
Let op

Flows bouw en beheer je zelf in Klaviyo. Loyalo levert alleen de events en profielvelden aan.

Kan ik events per winkel apart instellen?

Ja. Elke winkel heeft een eigen API-sleutel, eigen events aan of uit en eigen instellingen per e-mail.

Waarom zie ik geen tags in Klaviyo?

Loyalo zet de gegevens in profielvelden die met loyalo_ beginnen, niet in tags. Een veld heeft een waarde, zoals een saldo of een datum, zodat je in een segment kunt filteren op bijvoorbeeld meer dan 500 punten.

Kan ik het puntensaldo in mijn bestaande nieuwsbrief zetten?

Ja. Het saldo staat op het profiel als loyalo_points_balance. Zet het in een tekstblok met {{ person|lookup:'loyalo_points_balance'|default:0 }}; zie de sectie Punten tonen in je eigen e-mails.

Wat is het verschil met de voorspellingen van Klaviyo zelf?

Klaviyo heeft eigen voorspellende analyses, maar die werken pas vanaf minstens 500 klanten met een bestelling, 180 dagen aan bestelgeschiedenis met bestellingen in de laatste 30 dagen, en een deel van de klanten met drie of meer bestellingen (bron: Klaviyo Help Center, gecontroleerd op 19 oktober 2026). De klantwaarde van Loyalo heeft die minimums niet: segmenten krijg je na de eerste berekening, een verwachte waarde vanaf 90 dagen bestelgeschiedenis. Je kunt beide naast elkaar gebruiken.

Hoe test ik zonder mijn klanten te storen?

Stuur een testevent naar je eigen e-mailadres. Het is gemarkeerd met loyalo_test, zodat een flow het kan overslaan en geen klant er iets van merkt.

Lees ook