Le suivi conversion développeur te permet d'implémenter des analytics et attribution complètes sur l'ensemble de ta stack d'application. Ce guide compréhensif montre comment utiliser le SDK JavaScript Pimms et l'API de suivi pour surveiller chaque étape du premier clic à la conversion finale.
Tu implémenteras un suivi de conversion en temps réel pour leads, réservations, et ventes avec des analytics d'attribution complètes. Parfait pour les développeurs full-stack qui ont besoin de données de conversion granulaires et de capacités d'intégration API.
Ce que tu vas implémenter : Intégration SDK complète, configuration suivi API, et attribution conversion pour chaque interaction utilisateur dans ton application.
- 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 :
- Installer le script ou SDK Pimms pour capter le
pimms_id - Activer le suivi des conversions sur tes liens
- 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 :
<script defer src="https://cdn.pimms.io/analytics/script.detection.js"></script>Option B — Avec le SDK (React / Next.js / Node.js)
// 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
- Va dans les Paramètres du workspace → Analytics
- Active Tracking des conversions au niveau du workspace
Option 2 — Lien par lien
- Ouvre le Link Builder
- 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 :
- Systeme.io
- Webflow
- Calendly (guide bientôt disponible)
- API ou SDK — pour les sites, apps ou tunnels personnalisés
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 Settings → API Keys
- Le token est privé — ne le partage pas
pimms_idest un identifiant unique qui suit l’utilisateur tout au long du tunnel. Tu peux récupérer lepimms_iddepuis le cookiepimms_idenregistré dans le navigateur.
Plus d'informations sur le Pimms SDK
Plus d'informations sur l'API dans la Documentation API
➤ 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é
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"
}
})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)
FAQ
Dois-je être développeur pour implémenter le suivi Pimms ?
Ce guide est destiné aux développeurs qui veulent un contrôle total. Si tu n'es pas technique, consulte nos guides no-code pour des plateformes comme Webflow, Calendly, et Stripe qui ne nécessitent aucun codage.
Puis-je suivre les conversions sur différents domaines et sous-domaines ?
Actuellement, Pimms suit dans le même domaine. Le suivi cross-domain arrive bientôt. Pour l'instant, utilise des configurations de suivi séparées pour différents domaines.
Combien de temps avant que les conversions apparaissent dans le tableau de bord Pimms ?
Les conversions apparaissent en temps réel, généralement en 1-2 secondes après l'appel API. Tu peux voir les données de clic à conversion immédiatement après l'envoi des événements.
C'est bon, tout est prêt 🎉
Tu as maintenant tout ce qu'il faut pour implémenter un suivi de conversion complet et des analytics — avec attribution totale du clic à la conversion et données en temps réel.
Ça commence ici
Si vous êtes arrivé jusqu'ici, il est temps de récupérer 10 liens gratuits.
10 liens intelligents inclus • Aucune carte bancaire
