Suivi des conversions

Elido suit deux choses à partir d'un lien court : le clic (lorsqu'une personne suit le lien) et la conversion (lorsque cette même personne effectue une action utile sur votre site par la suite). Le suivi des conversions relie les deux, ce qui vous permet de voir non seulement quels liens génèrent du trafic, mais aussi quels liens génèrent des résultats.

Ce qui compte comme conversion#

Une conversion est tout événement que vous définissez — un achat, une inscription, une soumission de formulaire, un démarrage d'essai. Elido n'impose pas de définition spécifique. Vous envoyez un événement de conversion lorsque l'action se produit ; nous l'attribuons au clic qui a amené l'utilisateur.

Le tableau de bord des conversions dans Analytics → Conversions affiche :

• Le total des conversions et le revenu total attribué.
• Les conversions ventilées par lien, campagne, jour et plateforme.
• Un tableau des événements de conversion individuels récents avec l'e-mail du client et le revenu.

Configurer un événement de conversion#

Option 1 : appel API côté serveur#

La méthode la plus fiable. Lorsqu'un utilisateur effectue une action sur votre backend, envoyez un POST au point de terminaison des conversions :

curl -X POST https://api.elido.app/v1/conversions \
  -H "Authorization: Bearer $ELIDO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": 42,
    "platform": "stripe",
    "customer_email": "[email protected]",
    "revenue_cents": 4900,
    "currency": "EUR",
    "converted_at": "2026-05-12T14:30:00Z"
  }'

Incluez customer_email ou click_id pour l'attribution. Si vous transmettez un click_id (renvoyé dans les en-têtes de réponse de redirection sous X-Elido-Click-ID), l'attribution est exacte. Si vous ne transmettez que customer_email, nous le faisons correspondre au dernier clic de cette adresse dans la fenêtre d'attribution.

Option 2 : pixel côté client#

Ajoutez le pixel Elido à votre page de confirmation (confirmation de commande, succès d'inscription, etc.) :

<script>
  window.elidoConvert = window.elidoConvert || function(opts) {
    fetch('https://api.elido.app/v1/conversions/pixel', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        workspace_id: opts.workspaceId,
        platform: opts.platform || 'web',
        revenue_cents: opts.revenueCents || 0,
        currency: opts.currency || 'EUR',
      }),
      credentials: 'include',
    });
  };
</script>

Appelez-le ensuite sur la page de confirmation :

<script>
  elidoConvert({
    workspaceId: 42,
    platform: 'web',
    revenueCents: 4900,
    currency: 'EUR',
  });
</script>

Le pixel utilise un cookie de navigateur défini lors de la redirection pour identifier le clic qui a précédé la conversion. Cela fonctionne pour les parcours sur le même navigateur et le même appareil. Pour une attribution multi-appareils ou multi-navigateurs, la méthode click_id côté serveur est plus fiable.

Fenêtres d'attribution#

Par défaut, une conversion est attribuée au clic le plus récent du même utilisateur dans une fenêtre de 30 jours. Si le même utilisateur a cliqué sur plusieurs liens pendant cette période, la conversion est attribuée au dernier clic (attribution last-touch).

La fenêtre est configurable par espace de travail dans Paramètres → Attribution. Les options disponibles incluent 1 jour, 7 jours, 30 jours et 90 jours.

Lecture du tableau de bord des conversions#

Analytics → Conversions décompose les conversions par :

• Plateforme — le champ platform que vous transmettez dans l'appel API (stripe, shopify, web ou tout autre libellé que vous choisissez).
• Liens principaux — quels liens courts ont généré le plus de conversions.
• Campagnes principales — quelles campagnes ont le mieux converti.
• Revenu quotidien — un graphique à barres du revenu attribué dans le temps.

Le revenu est affiché comme la somme des valeurs revenue_cents que vous avez transmises. Si vous ne suivez pas le revenu (par exemple pour la génération de prospects), vous pouvez laisser revenue_cents à 0 et utiliser uniquement le nombre de conversions.

Résolution des problèmes#

Les conversions n'apparaissent pas. Vérifiez la réponse de l'API pour votre appel POST /v1/conversions — le point de terminaison renvoie l'ID de conversion en cas de succès et un message d'erreur détaillé en cas d'échec. Problèmes courants : ID d'espace de travail manquant, code de devise invalide (doit être ISO 4217, par exemple EUR et non €), ou clé API sans autorisation conversions:write.

L'attribution ne correspond pas aux clics attendus. Si vous utilisez le pixel (basé sur les cookies), vérifiez que le navigateur de l'utilisateur ne bloque pas les cookies tiers. L'ITP de Safari et certains bloqueurs de publicités supprimeront le cookie avant que la page de conversion ne se déclenche. Utilisez la méthode click_id côté serveur pour une attribution fiable.

Les chiffres de revenu ne correspondent pas à mon processeur de paiement. Les chiffres dans Elido correspondent exactement à ce que vous nous envoyez — nous ne récupérons pas les données de Stripe ou de tout autre processeur directement. En cas de divergence, comparez les valeurs revenue_cents dans vos appels API de conversion avec vos enregistrements de paiement.

Une conversion apparaît sous le mauvais lien. L'attribution utilise le last-touch par défaut. Si un utilisateur a cliqué sur plusieurs liens avant de convertir, cela va au clic le plus récent. Si le dernier clic provenait d'une campagne différente, c'est un comportement attendu. Ajustez la fenêtre d'attribution ou passez à l'attribution first-touch dans les paramètres si le last-touch ne correspond pas à vos besoins de reporting.