Sleutel koppelen
- 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.
- Controleer de koppeling met profielenLoyalo koppelt een klant aan een Klaviyo-profiel via het klantnummer van Shopify, en anders via het e-mailadres.
- 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.
- 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.
| Onderdeel | Waar te vinden |
|---|---|
| Events | Klaviyo > Metrics, de metrics die met Loyalo beginnen |
| Profielvelden | Klaviyo-profiel van de klant, velden met prefix loyalo_ |
| Koppeling met het profiel | Klantnummer 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.
| Profielveld | Inhoud |
|---|---|
| loyalo_points_balance | Het huidige puntensaldo |
| loyalo_points_name | Hoe je punten heten, in de taal van de klant |
| loyalo_points_value | Wat het saldo waard is, op basis van je beloning met een vast bedrag |
| loyalo_rewards_available | Het aantal beloningen dat de klant nu kan inwisselen |
| loyalo_next_reward | De eerstvolgende beloning waar de klant voor spaart |
| loyalo_points_to_next_reward | Hoeveel punten de klant daarvoor nog nodig heeft |
| loyalo_points_expiring | Punten die binnen 30 dagen vervallen |
| loyalo_points_expire_date | De eerste datum waarop punten vervallen |
| loyalo_loyalty_url | De link naar je loyaltypagina (uit Huisstijl), anders het klantaccount |
| loyalo_lifetime_points | Alle punten die de klant ooit heeft verdiend |
| loyalo_tier | De naam van de tier van de klant |
| loyalo_next_tier | De naam van de volgende tier |
| loyalo_next_tier_remaining | Wat 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 %} - 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.
- 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.
- 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.
- 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.
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.
| Profielveld | Inhoud |
|---|---|
| loyalo_rfm_segment | De naam van het segment in de taal van je winkel, bijvoorbeeld Dreigen af te haken |
| loyalo_rfm_segment_handle | De vaste code van het segment: champions, loyal, potential, new, attention, at_risk, cant_lose of hibernating |
| loyalo_rfm_score | De RFM-score als tekst, bijvoorbeeld 2-4-5 |
| loyalo_rfm_r, loyalo_rfm_f, loyalo_rfm_m | De drie scores apart, elk van 1 tot 5 |
| loyalo_rfm_since | Sinds wanneer de klant in dit segment zit |
| loyalo_last_order_date | De datum van de laatste betaalde bestelling |
| loyalo_orders_12m | Het aantal betaalde bestellingen in de laatste 12 maanden |
| loyalo_revenue_12m | De omzet van die bestellingen |
| loyalo_clv_historic | De klantwaarde tot nu: wat de klant heeft besteed |
| loyalo_clv_predicted_12m | De verwachte klantwaarde voor de komende 12 maanden, leeg zolang je winkel minder dan 90 dagen aan bestelgeschiedenis heeft |
| loyalo_clv_total | De klantwaarde tot nu plus de verwachte waarde |
| loyalo_clv_band | top10, top25 of rest: of de klant bij je waardevolste 10% of 25% hoort |
| loyalo_avg_days_between_orders | Het gemiddelde aantal dagen tussen bestellingen |
| loyalo_expected_next_order | De 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 event | Inhoud |
|---|---|
| from_segment, to_segment | De code van het oude en het nieuwe segment, bijvoorbeeld loyal en at_risk |
| from_segment_name, to_segment_name | De namen van die segmenten in de taal van je winkel |
| rfm_score | De nieuwe RFM-score, bijvoorbeeld 2-4-5 |
| clv_total | De klantwaarde tot nu plus de verwachte waarde |
| is_subscriber | Of 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
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.
E-mails en huisstijl
Loyalo verstuurt e-mails over abonnementen en punten in je eigen huisstijl, in de taal van de klant. Per e-mail kies je of Loyalo of Klaviyo verstuurt.
Het spaarprogramma tonen in je winkel
Toon je spaarprogramma op de productpagina, een spaarpagina, in het klantaccount, aan de kassa en in e-mails, in de naam en kleuren van je eigen huisstijl.
Retentie en mislukte betalingen (dunning)
Verlaag churn op je abonnementen: doe een aanbod bij opzeggen, stuur gestopte klanten een win-backcode en laat mislukte betalingen vanzelf opnieuw proberen.
Analyse en rapportage
Zie de omzet uit je Shopify-abonnementen naast de periode ervoor, met MRR, churn, cohorten en punten, plus RFM-segmenten en klantwaarde per klant.