Suivi des liens Klaviyo : les clics sur les liens courts comme métrique personnalisée

Le suivi des liens Klaviyo via Elido est côté serveur et fonctionne dans un seul sens : chaque clic sur l'un de vos liens courts est envoyé à l'Events API de Klaviyo sous forme d'événement sur une métrique personnalisée appelée Elido Link Click. L'événement contient le slug et l'ID du lien, le pays et l'appareil, la destination vers laquelle le visiteur a été envoyé et l'heure du clic. La métrique est créée à la première utilisation, puis vous pouvez la représenter, la filtrer et créer des rapports dessus comme sur n'importe quelle autre métrique.

Ce que cette intégration ne fait pas, c'est placer le clic sur le profil d'un abonné. Chaque événement est associé au lien par un identifiant anonyme : ainsi, un lien cliqué par 4 000 personnes apparaît dans Klaviyo comme un seul profil anonyme avec 4 000 événements dans sa timeline. Ce seul fait détermine l'utilité de l'intégration. Je vais présenter le payload, la configuration, ce que les flows et les segments peuvent en faire, et la comparaison avec le suivi natif des clics de Klaviyo.

Si vos liens ne sont pas encore balisés de manière cohérente, commencez par corriger cela. L'article cornerstone sur le suivi des UTM de bout en bout explique la convention, et Klaviyo ne voit jamais que ce que le lien transporte.

Ce qu'Elido envoie à Klaviyo à chaque clic

Un clic, un POST. Le forwarder appelle https://a.klaviyo.com/api/events/ avec votre clé privée dans l'en-tête Authorization: Klaviyo-API-Key et un en-tête revision: 2023-02-22. C'est l'endpoint documenté dans la référence Create Event de Klaviyo.

Voici le corps complet, avec des valeurs d'exemple :

{
  "data": {
    "type": "event",
    "attributes": {
      "time": "2026-09-21T09:14:22Z",
      "properties": {
        "workspace_id": 12,
        "link_id": 4711,
        "slug": "autumn-drop",
        "country": "DE",
        "device": "mobile",
        "destination": "https://shop.example/autumn?utm_source=instagram",
        "ip": "203.0.113.24"
      },
      "metric": {
        "data": {
          "type": "metric",
          "attributes": { "name": "Elido Link Click" }
        }
      },
      "profile": {
        "data": {
          "type": "profile",
          "attributes": { "anonymous_id": "elido-link-4711" }
        }
      }
    }
  }
}

C'est tout. Pas d'adresse e-mail, pas de numéro de téléphone, pas de champs UTM comme propriétés séparées, pas de referrer et pas de navigateur.

Quelques détails comptent dès que vous commencez à filtrer. destination est l'URL effectivement reçue par ce visiteur, après les règles de routage éventuelles d'un lien intelligent. Ainsi, un lien qui envoie les iPhone vers l'App Store et tous les autres visiteurs vers votre boutique produit deux valeurs de destination. device vaut mobile, tablet ou desktop. Les balises UTM n'existent qu'à l'intérieur de la chaîne destination, donc il n'est pas possible de filtrer directement sur utm_campaign ; filtrez plutôt sur slug, qui est généralement la clé la plus claire de toute façon.

Les robots qui s'annoncent dans leur user-agent sont éliminés au niveau de la redirection et ne sont jamais transférés. Les clics que les heuristiques d'Elido signalent comme suspects sont tout de même envoyés, et l'événement ne contient aucune propriété qui l'indique.

Un profil anonyme par lien, et pourquoi

Chaque événement Klaviyo doit désigner un profil, identifié par une adresse e-mail, un numéro de téléphone, un identifiant externe, un identifiant Klaviyo ou un anonymous_id. Elido envoie toujours ce dernier, construit comme elido-link- suivi de l'ID du lien.

Ainsi, chaque clic sur autumn-drop arrive sur le même profil. Le premier clic le crée et chacun des suivants est ajouté à sa timeline.

Cela a trois conséquences, et la troisième m'a surprise.

Premièrement, les comptages fonctionnent mais les personnes restent inconnues. Le nombre total de clics, les clics par lien, par pays et par appareil fonctionnent tous. Tout ce qui est « Unique » compte les liens, pas les personnes.

Deuxièmement, le profil anonyme n'a ni adresse e-mail ni téléphone. Il peut figurer dans un segment, mais il ne peut pas recevoir de message.

Troisièmement, les clics de la même seconde sont regroupés. Le forwarder n'envoie pas de unique_id, et la référence de Klaviyo indique que, sans cet identifiant, la déduplication se fait à la seconde de l'heure de l'événement, pour le même profil et la même métrique. Comme le profil est associé au lien, deux personnes qui cliquent sur le même lien pendant la même seconde deviennent un seul événement. Pour un lien dans une newsletter qui reçoit des clics progressivement, vous ne le remarquerez jamais. Pour un lien dans une grande story Instagram, où plusieurs clics arrivent chaque seconde au pic, le nombre de clics dans Klaviyo sera inférieur à celui de vos analyses de clics Elido. L'avantage : l'unique nouvelle tentative du forwarder ne peut pas compter deux fois, car un événement réessayé conserve la même heure.

Pourquoi ne pas utiliser un identifiant par visiteur ? La redirection ne sait pas qui est le visiteur, et je préfère qu'elle ne dépose pas de cookie sur un domaine que le visiteur n'a jamais choisi de consulter. C'est le même compromis que celui que nous avons fait pour le suivi des liens Mixpanel, où distinct_id est associé au lien pour la même raison.

Configurer le suivi des liens Klaviyo dans Elido

La configuration tient en un champ.

1. Dans Klaviyo, allez dans Settings, puis API keys, et créez une clé API privée. La référence Create Event indique que le scope requis est events:write. Les notes de configuration intégrées à Elido mentionnent aussi profiles:write ; je commencerais uniquement par events et j'ajouterais le second si Klaviyo renvoie des erreurs 403.
2. Dans votre espace de travail Elido, ouvrez Integrations, choisissez la carte Klaviyo et cliquez sur Connect Klaviyo.
3. Collez la clé dans Private API Key et enregistrez. Elido la chiffre au repos et ne l'affiche ensuite que masquée.
4. Attendez environ cinq minutes. Les paramètres d'intégration sont mis en cache du côté du transfert, donc les premiers clics après l'enregistrement peuvent ne pas être envoyés.
5. Cliquez sur l'un de vos liens depuis un téléphone, puis ouvrez Analytics > Metrics dans Klaviyo et cherchez Elido Link Click.

Le bouton Test connection envoie un événement de test (marqué elido_test: true) à Klaviyo et affiche la réponse de Klaviyo : une clé révoquée ou en lecture seule échoue donc immédiatement. Cela prouve que la clé fonctionne, pas que la métrique arrive sur le profil attendu. L'apparition de la métrique dans Klaviyo après un vrai clic est la preuve.

Il n'y a pas de commutateur par lien. Chaque clic de l'espace de travail est transféré, y compris les liens que vous ne destiniez pas au marketing. Les agences qui gèrent de nombreux clients devraient attribuer un espace de travail à chaque client avant de connecter quoi que ce soit.

Suivi natif des clics de Klaviyo ou métrique Elido

Klaviyo suit déjà les clics dans ses propres e-mails et SMS, et ce suivi natif est préférable pour le travail au niveau de l'abonné. Klaviyo réécrit chaque lien via son domaine de suivi, enregistre Clicked Email ou Clicked SMS sur le profil du destinataire et marque les robots d'analyse probables avec une propriété Bot Click que vous pouvez exclure des rapports.

La métrique d'Elido trouve sa place partout ailleurs : le lien dans votre bio Instagram, un code QR sur un emballage, un lien envoyé par un partenaire depuis sa propre newsletter, un lien dans les notes d'un podcast. Aucun de ces clics ne passe par le tracker Klaviyo. Avec le forwarder activé, ils apparaissent dans le même compte que vos métriques e-mail, de sorte qu'un seul tableau de bord Klaviyo peut placer « a cliqué sur le lien autumn depuis n'importe où » à côté de « a cliqué sur l'e-mail autumn ».

Une interaction mérite votre attention. Dans les e-mails en production, Klaviyo ajoute un paramètre _kx à chaque lien afin que son script sur site puisse identifier le cliqueur sur votre site web. Si le lien de votre e-mail est un lien court Elido, _kx arrive sur l'URL courte et la redirection Elido ne reporte pas les paramètres de requête entrants vers la destination. L'identification sur site est donc perdue. Ma règle : dans les e-mails Klaviyo, créez un lien direct vers votre propre site et laissez Klaviyo le suivre ; utilisez les liens courts pour les canaux que Klaviyo ne peut pas atteindre.

Faire arriver les clics sur les profils réels des abonnés

Parfois, vous voulez effectivement associer le clic à une personne. Deux méthodes fonctionnent aujourd'hui, et aucune ne passe par le forwarder.

La plus simple consiste à laisser le suivi sur site de Klaviyo gérer l'identité. Envoyez le lien court partagé vers une destination comportant des balises UTM et vérifiez que le JavaScript de Klaviyo s'exécute sur cette page. Les visiteurs qui ont déjà un cookie issu d'un clic antérieur dans un e-mail, ou qui s'inscrivent via un formulaire, voient leur activité sur site associée à leur profil. Le clic sur le lien court reste anonyme ; la visite qui suit ne l'est pas. Vous comparez ensuite les deux au niveau de la campagne, ce qui est moins précis qu'au niveau individuel, mais reflète honnêtement ce que chaque côté sait.

La méthode plus lourde consiste à utiliser des liens par destinataire. Pour une petite liste à forte valeur, comme une séquence B2B ou des invitations VIP, créez un lien court par personne via l'API à l'adresse /v1/workspaces/{workspace_id}/links et conservez votre propre table associant l'ID du lien à l'adresse e-mail. Abonnez-vous aux événements de lien via des webhooks, recherchez l'adresse e-mail à l'arrivée d'un clic et envoyez votre propre événement à Klaviyo en utilisant cette adresse comme identifiant de profil. Cela représente peut-être quarante lignes de code, et c'est la seule méthode qui place un clic Elido sur un abonné identifié. Je ne le ferais pas pour une newsletter de 200 000 personnes.

Si les comptages de clics multicanaux dans Klaviyo sont ce qui vous manquait, choisissez un plan et connectez un espace de travail, puis faites passer votre prochaine campagne sociale par des liens de marque.

Limites actuelles du forwarder

Cinq choses à savoir avant de faire dépendre un rapport de cette intégration.

La livraison est effectuée au mieux. Un POST échoué fait l'objet d'une nouvelle tentative après une seconde, puis est abandonné, et rien n'est mis en file d'attente pour plus tard.

L'Events API est soumis à une limitation de débit par compte, à 350 requêtes par seconde en rafale et 3 500 par minute en régime stable. Ce quota est partagé avec toutes les autres applications qui écrivent des événements dans votre compte. Une pointe de campagne supérieure à environ 58 clics par seconde pendant une minute verra des erreurs 429 et, après l'unique nouvelle tentative, ces clics disparaîtront de Klaviyo.

L'en-tête de révision est ancien. Klaviyo accorde à chaque révision d'API deux ans avant son retrait, et les requêtes vers une révision retirée sont servies par la plus ancienne révision encore disponible. La révision 2023-02-22 a dépassé cette limite, donc le forwarder fonctionne aujourd'hui par fall-forward. Il fonctionne. J'aimerais tout de même que l'en-tête soit mis à jour.

L'adresse IP du visiteur est envoyée comme propriété d'événement. Attendez-vous à ce qu'elle soit stockée comme n'importe quelle autre propriété et traitez-la donc comme une donnée personnelle dans vos registres de traitement. Le guide sur la résidence des données UE pour les équipes marketing explique comment l'évaluer.

Des clics, uniquement. Les conversions ne font pas partie du payload : suivez donc le chiffre d'affaires là où se trouve l'identité du client, c'est-à-dire, pour la plupart des boutiques, dans l'intégration e-commerce propre à Klaviyo.

Articles associés sur le blog

• Suivre les UTM de bout en bout - la convention de balisage dont dépend le rapprochement au niveau de la campagne.
• Suivi des liens Mixpanel - le même modèle de forwarder, avec la même identité par lien.
• Webhooks pour les événements de lien - le composant de base des événements de clic par destinataire.
• Attribution des clics e-mail pour Mailchimp, Brevo et Klaviyo - une vue d'ensemble des plateformes e-mail.
• Clics sur les liens courts et sessions GA4 - pourquoi les nombres de clics et les sessions analytiques ne correspondent jamais.
• Surveillance des URL avec Datadog - le même forwarder de clics, alimentant un tableau de bord Datadog.