Guide étape par étape pour les développeurs – configurer le tracking des conversions

Apprends à suivre les leads, prises de rendez-vous et ventes avec les liens intelligents PiMMs, des scripts frontend et l’API — visibilité complète, zéro approximations.

May 19, 2025
5 min de lecture
Guide étape par étape pour les développeurs – configurer le tracking des conversions

Tu veux savoir exactement ce qui génère des conversions — du premier clic jusqu'au paiement final ?

Avec PiMMs, tu peux suivre chaque étape importante :

  • Clic — lorsqu’un utilisateur clique sur un lien PiMMs ou scanne un QR code
  • Lead (Conversion) — lorsqu’il remplit un formulaire ou réserve un créneau
  • Vente — lorsqu’il paie (par exemple via Stripe)

Chaque lien PiMMs génère un identifiant unique pimms_id qui suit l’utilisateur tout au long du tunnel. Tu dois simplement :

  1. Installer le script ou SDK PiMMs pour capter le pimms_id
  2. Activer le suivi des conversions sur tes liens
  3. Envoyer les événements de conversion à PiMMs (via API, Zapier ou npm)

1. Configure le tracking côté client (obligatoire)

Pour activer l’attribution, il faut capter le pimms_id dès que l’utilisateur arrive sur ton site.

Option A — Avec une balise HTML (tous sites)

Colle ce code dans le <head> dans toutes les pages de ton site :

Code
<script defer src="https://cdn.pimms.io/analytics/script.detection.js"></script>

Option B — Avec le SDK (React / Next.js / Node.js)

Code
// Install the package (e.g. npm install @getpimms/analytics)
import { Analytics as PimmsAnalytics } from "@getpimms/analytics"
 
<PimmsAnalytics />

Plus d'informations sur les options de tracking côté client dans le PiMMs Analytics Repository

Vérifiez votre installation de script

Utilisez notre outil gratuit pour vérifier automatiquement si le script analytics PiMMs est correctement installé sur votre site web.

Active le tracking des conversions sur tes liens

Une fois le script installé, tu dois activer le suivi pour chaque lien.

Option 1 — À l’échelle du workspace

  1. Va dans les Paramètres du workspaceAnalytics
  2. Active Tracking des conversions au niveau du workspace

Option 2 — Lien par lien

  1. Ouvre le Link Builder
  2. Active le toggle Conversion Tracking

✅ Les tests A/B ont toujours le suivi activé par défaut.

2. Envoie les événements de conversion à PiMMs (Zapier, API ou SDK)

Quand un utilisateur convertit — formulaire, rendez-vous, paiement — tu dois envoyer l’événement à PiMMs.

➤ Suivre un lead

3 options s’offrent à toi :

  • Zapier ou Make.com — idéal pour les outils comme Cal.com, Tally, iClosed, Notion, etc.
  • Intégrations natives prises en charge, comme :
  • API ou SDK — pour les sites, apps ou tunnels personnalisés
Code
import { Pimms } from "pimms"
 
const pimms = new Pimms({ token: "YOUR_TOKEN" })
 
await pimms.track.lead({
  clickId: "pimms_id", // Récupère le pimms_id depuis le cookie pimms_id
  eventName: "Signup",
  customerId: "user_456", // L'identifiant de l'utilisateur ou l'email
  customerEmail: "samantha@example.com",
  customerName: "Samantha Li",
  customerAvatar: "https://example.com/avatar.png"
})

Notes:

  • Pour créer un token, sur ton dashboard PiMMs, va dans les SettingsAPI Keys
  • Le token est privé — ne le partage pas
  • pimms_id est un identifiant unique qui suit l’utilisateur tout au long du tunnel. Tu peux récupérer le pimms_id depuis le cookie pimms_id enregistré dans le navigateur.

Plus d'informations sur le PiMMs SDK

Plus d'informations sur l'API dans la Documentation API

PropriétéDescriptionObligatoire
clickIdL’identifiant unique pimms_id de l’utilisateur (cookie)Oui
eventNameNom de l’événement. Exemple : "Signup"Oui
customerIdTon identifiant interne pour l’utilisateur ou emailOui
customerEmailAdresse email de l’utilisateur (optionnel)Non
customerNameNom de l’utilisateur (optionnel)Non
customerAvatarURL de l’avatar (optionnel)Non

➤ Suivre une vente

Deux manières de suivre les ventes :

  • Pour Stripe Payment Links, Shopify, et Systeme.io, pas besoin de code.
  • Pour les checkouts personnalisés, utilise le SDK ou l’API.

Cas particulier : Stripe, Shopify, Systeme.io

PiMMs gère déjà l’attribution pour ces plateformes — il suffit de transmettre le bon identifiant.

  • Stripe Payment Links

👉 Configurer le suivi Stripe Payment Links

  • Stripe Checkout

👉 Configurer le suivi Stripe Checkout

  • Systeme.io

👉 Configurer le suivi Systeme.io

  • Shopify(guide bientôt disponible)

Utilise le SDK uniquement si tu gères ton propre tunnel de vente ou des événements backend.

Exemple : Utilisation du SDK pour un tunnel personnalisé

Code
await pimms.track.sale({
  customerId: "user_456", // L'identifiant de l'utilisateur ou l'email utilisé pour créer le lead (partie 2)
  amount: 1999,
  currency: "eur",
  paymentProcessor: "stripe",
  eventName: "Premium Upgrade",
  invoiceId: "inv_001",
  metadata: {
    campaign: "April Launch",
    source: "Instagram Story"
  }
})
PropriétéDescriptionObligatoire
customerIdIdentifiant client (interne) ou email utilisé pour créer le leadOui
amountMontant en centimes (ex : 1999 = 19,99 €)Oui
paymentProcessorNom du processeur de paiement (ex : "stripe")Oui
eventNameLibellé de l’événement (par défaut : "Purchase")Non
invoiceIdID de la facture (optionnel)Non
currencyDevise (par défaut : "usd")Non
metadataObjet facultatif pour infos de campagne, source, etc.Non

3. Configuration avancée (optionnel)

Tu veux aller plus loin ? Voici ce qui est possible :

  • Suivi cross-domain (bientôt dispo)
  • Support des reverse-proxy (bientôt dispo)
  • Paramètre ?via= (bientôt dispo)
  • Limiter le tracking à ton domaine (bientôt dispo)

C’est bon, tout est prêt 🎉

Tu as maintenant tout ce qu’il faut pour suivre ce qui convertit vraiment — avec attribution complète et analytics en temps réel.

👉 Crée ton premier lien PiMMs

Continuer la lecture

Explorez plus d'insights et de stratégies