Klaviyo : événements, scénarios et segments pour vos abonnés
L'essentiel
Une fois Klaviyo branché, Ciklik envoie un événement à chaque étape de la vie d’un abonnement : début, rappel avant prélèvement, renouvellement, paiement refusé, relances terminées, carte qui expire, changement, date décalée, pause, reprise, résiliation, et pour les boutiques box l’abonnement cadeau. Chaque événement sert de déclencheur à un scénario d’emails dans Klaviyo (un « flow ») et porte ce qu’il faut pour l’écrire : contenu de l’abonnement, date du prochain prélèvement, lien vers l’espace abonnement, lien de paiement après un refus. Ciklik tient aussi à jour des propriétés « Ciklik » sur le profil de chaque abonné, pour bâtir vos segments : abonnés actifs, en pause, en impayé, résiliés.
Dans Klaviyo, chaque événement est une metric (métrique) qui porte le nom exact ci-dessous, en anglais comme le veut l’usage de Klaviyo. Ces noms ne changeront pas : un flow construit aujourd’hui continuera de se déclencher.
Quand : le premier paiement d’un nouvel abonnement réussit. Une seule fois par abonnement.
Utile : le contenu de l’abonnement, son rythme, la date du prochain prélèvement, le montant payé, le lien vers l’espace abonnement. Boutique PrestaShop : le numéro de la commande créée par la boutique.
Upcoming Subscription Charge
Quand : quelques jours avant chaque prélèvement, 3 par défaut (1 à 14, réglable), vers 8 h 30. Une fois par échéance, abonnements en pause exclus.
Utile : la date du prélèvement, le nombre de jours restants, le contenu, le lien vers l’espace abonnement.
Renewed Subscription
Quand : un renouvellement est payé, quel que soit le moyen de paiement, y compris après un refus.
Utile : le montant payé, le contenu, la date du prochain prélèvement. Boutique PrestaShop : le numéro de la commande de renouvellement.
Rescheduled Subscription Charge
Quand : la date du prochain prélèvement est décalée, à la demande (client, vous, module) ou, pour PrestaShop, faute de stock au renouvellement.
Utile : la raison (requested ou out_of_stock), qui l’a fait, la nouvelle date.
Quand : le paiement d’un renouvellement est refusé, à chaque essai. Un refus sur la toute première commande n’en déclenche pas.
Utile : le motif du refus, le numéro de l’essai, le montant dû, et le lien de paiement qui ouvre directement la page pour régler.
Exhausted Subscription Payment Retries
Quand : les relances de paiement sont finies et le renouvellement reste impayé. Cette livraison n’est ni payée ni envoyée ; l’abonnement continue à l’échéance suivante.
Utile : le nombre d’essais, le montant de la commande perdue.
Expiring Payment Card
Quand : le 25 de chaque mois, pour un abonné prélevé dans le mois qui suit dont la carte bancaire expire d’ici là. Une fois par carte et par date d’expiration.
Utile : la date d’expiration, la marque de la carte, le lien vers l’espace abonnement.
Quand : le contenu ou le rythme change : produits, quantité, ventes additionnelles, options, choix, fréquence, formule. Un seul événement par type de changement et par quart d’heure.
Utile : la nature du changement, qui l’a fait (client, vous, module, traitement automatique), le contenu à jour.
Paused Subscription
Quand : l’abonnement est mis en pause, par l’abonné ou par vous.
Utile : la durée de la pause et son unité (en mois ; en semaines pour une formule box à la semaine).
Resumed Subscription
Quand : l’abonnement reprend, à la fin d’une pause ou après une résiliation (réactivation).
Utile : d’où il repart (pause ou cancellation).
Cancelled Subscription
Quand : l’abonnement est résilié, quel que soit le chemin, fin programmée comprise (fin d’engagement, fin d’une carte cadeau).
Utile : la raison donnée dans le questionnaire de résiliation, et l’origine quand Ciklik la connaît (lien de résiliation, fin programmée).
Chaque événement porte des propriétés que vous pouvez afficher dans un email ou utiliser comme filtre de flow. Dans un email Klaviyo, une propriété dont le nom contient des espaces s’écrit avec le filtre lookup, par exemple {{ event|lookup:'Manage URL' }}.
Propriétés communes à tous les événements
Propriété
Contenu
Subscription ID
L’identifiant Ciklik de l’abonnement.
Interval, Interval Count
Le rythme : par exemple month et 1 pour tous les mois, week et 2 pour toutes les deux semaines.
Next Charge Date
La date du prochain prélèvement (AAAA-MM-JJ), tant que l’abonnement est actif.
Shop Type
box ou prestashop.
Subscription Mode
La façon dont l’abonnement est construit : box_plan (box à formule), box_products (box à produits), prestashop_frequency (PrestaShop, mode fréquence), prestashop_variant (PrestaShop, mode déclinaison).
Manage URL
Le lien vers l’espace abonnement du client : la page « Mes abonnements » de votre boutique PrestaShop, ou l’espace client de votre boutique box. Le client s’y connecte avec son compte.
Contenu de l’abonnement, selon son type
Type
Propriétés
Box à formule
Plan (nom de la formule), Plan ID, Quantity, Price (prix unitaire TTC payé), Options (réponses à choix du questionnaire de la box), Choices et Choice Names (produits choisis par le client dans sa box).
Box à produits
Items (pour chaque produit : Product ID, Name, SKU, Quantity, Price), Item Names, Offers (remise de quantité appliquée).
PrestaShop, mode fréquence
Items (pour chaque produit : PrestaShop Product ID, PrestaShop Combination ID si le produit a une déclinaison, Name, SKU, Quantity, Price), Item Names.
PrestaShop, mode déclinaison
Items (pour chaque produit : PrestaShop Combination ID, Name, SKU, Quantity, Price), Item Names.
Le prix est le prix unitaire TTC de la commande de l’événement, sinon de la dernière commande payée. Une propriété sans objet est absente : pas de Plan pour PrestaShop, pas d’Items pour une box à formule. Les réponses libres du questionnaire (texte saisi par le client) ne sont jamais envoyées.
Propriétés propres à certains événements
Événement
Propriétés
Started, Renewed Subscription
Order ID, Order Total, Currency ; boutique PrestaShop : PrestaShop Order ID, le numéro de la commande que le module Klaviyo de PrestaShop envoie aussi en « Placed Order ».
Upcoming Subscription Charge
Charge Date, Days Before.
Failed Subscription Payment
Order ID, Order Total, Currency, Failure Reason, Attempt, Payment URL.
Cancellation Reason (réponses au questionnaire de cette résiliation), Cancellation Source (signed_link pour le lien de résiliation du rappel, scheduled_end pour une fin programmée, vide sinon).
Motifs de refus (Failure Reason) : insufficient_funds (fonds insuffisants), card_declined (carte refusée), expired_card (carte expirée), authentication_required (validation 3D Secure demandée), lost_card (carte perdue ou volée), fraud_suspected (suspicion de fraude), forbidden (opération non autorisée), processing_error (erreur passagère), unknown.
À chaque événement, Ciklik met à jour sur le profil du client des propriétés calculées sur tous ses abonnements du site. Elles commencent toutes par « Ciklik » pour ne pas se mélanger aux vôtres ni à celles du module Klaviyo de PrestaShop. Pour une boutique PrestaShop, seuls les profils déjà créés par le module Klaviyo de PrestaShop les reçoivent : Ciklik ne crée aucun profil.
Propriété
Contenu
Ciklik Active Subscriber
true si le client a au moins un abonnement actif (en pause compris).
Ciklik Subscriber Status
active, paused (tous ses abonnements actifs sont en pause) ou cancelled.
Ciklik Active Subscriptions
Le nombre d’abonnements actifs.
Ciklik Payment Status
unpaid si un renouvellement reste à payer, sinon up_to_date.
Ciklik Next Charge Date
Le prochain prélèvement, tous abonnements confondus (hors pause).
Ciklik Subscription Frequency
Le rythme de chaque abonnement actif, par exemple 1 month.
Ciklik Plans
Les formules des abonnements actifs (boutiques box seulement).
Ciklik Subscribed Products
Les produits reçus : ceux d’un abonnement à produits, ceux choisis dans une box.
Ciklik Subscriber Since
La date du premier abonnement.
Ciklik Renewal Count
Le nombre de renouvellements payés.
Ciklik Subscription Revenue
Le total payé sur ses commandes d’abonnement.
Ciklik Commitment Ends On
La fin d’engagement la plus proche, si un engagement court.
Ciklik Cancelled At
La date de la dernière résiliation, quand plus aucun abonnement ne court.
Ciklik Last Cancellation Reason
La réponse au questionnaire de la dernière résiliation.
Ciklik Manage URL
Le lien vers l’espace abonnement.
Ciklik Customer ID
L’identifiant Ciklik du client.
Les propriétés partent avec le profil au branchement (voir la synchronisation), puis se mettent à jour à chaque événement. Dans l’interface française de Klaviyo, l’événement Cancelled Subscription peut s’afficher sous le nom « Abonnement annulé ».
Un scénario (un flow dans Klaviyo) part d’un déclencheur, attend, filtre et envoie. Pour en créer un : dans Klaviyo, ouvrez Flows (Flux dans l’interface française) et créez un flow à partir de zéro. Pour le déclencheur, ouvrez l’onglet Vos indicateurs, puis API, et choisissez l’événement Ciklik voulu.
Remerciez le nouvel abonné et montrez-lui où gérer son abonnement.
Bienvenue abonné
DéclencheurStarted Subscription
EmailMerci, votre abonnement est en placeContenu de l'abonnement (Plan ou Item Names), date du prochain prélèvement (Next Charge Date), bouton vers Manage URL
Attente7 jours
EmailBien profiter de votre abonnementConseils, comment changer le rythme, décaler ou mettre en pause
Boutique PrestaShop. Le module Klaviyo de PrestaShop envoie aussi la commande en « Placed Order » : voir Éviter un double envoi pour que votre flow de remerciement après achat n’écrive pas en plus à un nouvel abonné.
Le module Klaviyo de PrestaShop envoie Placed Order pour chaque commande de votre boutique, et chaque renouvellement Ciklik en est une : un abonné mensuel déclenche donc un « Placed Order » par mois, en plus de Renewed Subscription envoyé par Ciklik. Votre chiffre d’affaires dans Klaviyo reste juste (Ciklik n’envoie aucune commande), mais vos flows déclenchés par Placed Order se déclenchent aussi à chaque renouvellement. Trois façons de l’éviter, à choisir selon le flow :
Filtrer vos flows d’après-achat. Pour un remerciement, une demande d’avis ou une suggestion de produits déclenchés par Placed Order, ajoutez au début une attente de deux heures, puis un filtre de flow « a fait Renewed Subscription zéro fois depuis le début de ce flow » (et, si vous ne voulez pas non plus écrire à un nouvel abonné, « a fait Started Subscription zéro fois depuis le début de ce flow »). Ciklik envoie ces deux événements quelques minutes après la commande, l’attente leur laisse le temps d’arriver. Un flow de premier achat filtré sur « Placed Order zéro fois avant » n’est pas concerné : un renouvellement n’est jamais un premier achat.
Utiliser Renewed Subscription pour vos messages de renouvellement. Un message propre au renouvellement (merci pour votre fidélité, contenu de la livraison) se déclenche sur Renewed Subscription plutôt que sur Placed Order : il ne part qu’une fois par renouvellement, avec le contenu de l’abonnement et Ciklik Renewal Count pour adapter le ton.
Rapprocher les deux par le numéro de commande.Started Subscription et Renewed Subscription portent PrestaShop Order ID, le numéro de la commande que le module envoie en Placed Order. Il sert à rapprocher les deux événements dans vos analyses ou vos exports, et à reconnaître une commande d’abonnement.
ConditionPayment URL est renseigné ?Oui : bouton « Régler ma commande » vers Payment URL. Non : bouton vers Manage URL
EmailVotre paiement n'est pas passéMotif adapté avec Failure Reason (carte expirée, fonds insuffisants...), montant (Order Total)
Attente2 jours
ConditionCiklik Payment Status vaut toujours unpaid ?Non : le client a payé entre-temps, le flow s'arrête
EmailRappel : votre abonnement est en attente
Chaque essai refusé envoie un nouvel événement, avec son numéro dans Attempt. Pour ne pas relancer à chaque essai, limitez dans les réglages du déclencheur le nombre de passages d’un même profil dans le flow (par exemple une fois tous les 7 jours). Quand les relances sont finies, Exhausted Subscription Payment Retries peut déclencher un dernier message : l’échéance est perdue, l’abonnement continue.
Faites mettre à jour la carte avant que le prochain prélèvement n’échoue.
Carte qui expire
DéclencheurExpiring Payment CardLe 25 du mois, quand la carte expire avant un prélèvement du mois qui suit
FiltreCiklik Active Subscriber vaut true
EmailVotre carte expire bientôtDate (Card Expires On), marque (Card Brand), bouton vers Manage URL, où le client gère son abonnement et son moyen de paiement
Attente5 jours
EmailDernier rappel avant votre prochain prélèvement
Revenez vers l’abonné parti, avec un message adapté à la raison de son départ. C’est un email commercial : réservez-le aux profils inscrits à vos emails marketing (filtre de consentement).
Relance après résiliation
DéclencheurCancelled Subscription
FiltreProfil inscrit à vos emails marketingConsentement donné dans votre boutique
FiltreCancellation Source n'est pas scheduled_endÉcarte les fins programmées (engagement, carte cadeau) si vous voulez un autre message pour elles
Attente30 jours
ConditionCiklik Active Subscriber vaut toujours false ?Non : le client s'est réabonné entre-temps, le flow s'arrête
ConditionSelon Cancellation ReasonTrop cher : offre de retour. Trop de produits : rythme plus espacé. Autre : nouveautés
EmailVous nous manquezBouton vers Manage URL pour réactiver
Pour une offre plus forte, répétez avec une attente de 90 jours. Resumed Subscription avec Resumed From égal à cancellation vous permet de mesurer les retours.
Un segment se crée dans Klaviyo (Audience > Lists & segments > Create segment) à partir des propriétés « Ciklik » des profils ou des événements.
Segment
Condition dans Klaviyo
Abonnés actifs
Ciklik Subscriber Status vaut active.
En pause
Ciklik Subscriber Status vaut paused.
En impayé
Ciklik Payment Status vaut unpaid.
Résiliés depuis moins de 90 jours
Ciklik Cancelled At dans les 90 derniers jours.
Prélèvement dans les 7 jours
Ciklik Next Charge Date dans les 7 prochains jours.
Fin d’engagement dans 30 jours
Ciklik Commitment Ends On dans les 30 prochains jours.
Fidèles
Ciklik Renewal Count au moins 6.
Partis pour le prix
Ciklik Last Cancellation Reason contient le mot de votre questionnaire, par exemple « prix ».
Clients jamais abonnés (PrestaShop)
« Placed Order » au moins une fois, et Ciklik Customer ID non renseigné.
Les propriétés « Ciklik » partent avec le profil au branchement : un segment qui les utilise est juste dès la synchronisation. Un segment qui repose sur un événement, comme Placed Order, ne se remplit qu’au fil des commandes. Le dernier segment n’est sûr qu’après quelques mois, quand vos abonnés ont tous une commande.
Questions fréquentes
Quels événements Ciklik envoie-t-il à Klaviyo ?
Treize pour une boutique box : Started Subscription, Upcoming Subscription Charge, Renewed Subscription, Rescheduled Subscription Charge, Failed Subscription Payment, Exhausted Subscription Payment Retries, Expiring Payment Card, Updated Subscription, Paused Subscription, Resumed Subscription, Cancelled Subscription, Started Gift Subscription et Converted Gift Subscription. Une boutique PrestaShop en reçoit onze, sans les deux événements cadeau.
Ciklik envoie-t-il les commandes à Klaviyo ?
Non. Pour une boutique PrestaShop, les commandes arrivent par le module Klaviyo de PrestaShop, y compris celles des renouvellements. Ciklik joint seulement le numéro de la commande PrestaShop à Started et Renewed Subscription, pour distinguer un renouvellement d'un premier achat.
Combien de jours avant le prélèvement part le rappel ?
3 jours par défaut. Vous le réglez de 1 à 14 jours avec l'action Gérer la liaison Klaviyo, Modifier les réglages, de la fiche du site. Il part vers 8 h 30, heure de Paris, et jamais pour un abonnement en pause.
Pourquoi je ne trouve pas un événement Ciklik comme déclencheur de flow ?
Klaviyo ne propose une metric qu'après en avoir reçu un premier exemplaire. Tant qu'aucune carte n'a expiré, par exemple, Expiring Payment Card n'apparaît pas dans la liste.
Le lien de paiement est-il sûr ?
Il connecte le client à la page de paiement de sa commande refusée sans mot de passe, tant que cette commande reste à payer, puis ne sert plus. Placez-le seulement dans un email adressé à ce client et réservez l'accès à votre Klaviyo aux personnes de confiance.
Pourquoi mes flows Placed Order se déclenchent-ils à chaque renouvellement ?
Pour une boutique PrestaShop, chaque renouvellement Ciklik crée une vraie commande que le module Klaviyo de PrestaShop envoie en Placed Order. Filtrez vos flows d'après-achat (attente puis « Renewed Subscription zéro fois depuis le début de ce flow »), ou déclenchez vos messages de renouvellement sur Renewed Subscription.
Ciklik donne-t-il le consentement pour mes emails commerciaux dans Klaviyo ?
Jamais pour une boutique PrestaShop : le consentement reste géré par le module Klaviyo de PrestaShop. Pour une boutique box, seulement si vous avez choisi une liste d'abonnement : vos clients y sont alors abonnés comme avec Mailchimp, sauf ceux qui se sont désabonnés. Sans liste, Ciklik ne donne aucun consentement. Dans tous les cas, pour un email commercial, comme une reconquête ou une offre, ajoutez à votre flow un filtre qui ne garde que les profils inscrits à vos emails marketing. Un message de service peut être marqué transactionnel selon les règles de Klaviyo.