Passerelle PostHog, Mixpanel & Amplitude

1. Le problème : des chiffres sans visages

L’analyse produit vous donne un entonnoir : 1 000 utilisateurs ont atteint le paiement, 620 l’ont abandonné. C’est la mesure précise d’un problème que vous ne voyez toujours pas. Regarder une poignée de ces 620 enregistrements répond généralement à la question en quelques minutes — mais seulement si vous pouvez passer du graphique aux bonnes sessions sans exporter d’identifiants ni chercher à la main.

La passerelle d’analyse produit comble cet écart. Elle fonctionne dans mp.js et relie automatiquement les deux systèmes :

• Sortant : chaque événement enregistré par votre outil d’analyse porte une propriété mouseplayer_session_url. Ouvrez n’importe quel événement, cliquez sur le lien, regardez la session.
• Entrant : le distinct_id du visiteur est relu et enregistré sur la session MousePlayer, si bien que les enregistrements deviennent recherchables avec la même identité que celle que vous utilisez déjà dans PostHog, Mixpanel ou Amplitude.

2. Activation

Méthode A : tableau de bord (sans code)

1. Ouvrez votre projet et allez dans l’onglet Intégrations.
2. Basculez Passerelle PostHog, Mixpanel & Amplitude sur ON.
3. Sélectionnez la plateforme que vous utilisez. Les modifications sont enregistrées automatiquement.

Le réglage prend effet au prochain chargement de page de votre site. Les sessions existantes ne sont pas modifiées rétroactivement.

Méthode B : configuration manuelle du script

Si vous préférez l’inscrire en dur, définissez les deux valeurs dans window.mp_config :

3. Ce qui se passe selon la plateforme

Chaque plateforme expose une API différente ; la passerelle utilise donc l’appel idiomatique de chacune. Vous n’avez rien à configurer — elle suit la plateforme que vous avez sélectionnée.

Plateforme	Sortant (URL de relecture)	Entrant (identité)
PostHog	posthog.register() — enregistrée comme super property, elle est donc jointe à chaque événement suivant	posthog.get_distinct_id()
Mixpanel	mixpanel.register() — même comportement de super property	mixpanel.get_distinct_id()
Amplitude	setUserProperties() — définie comme propriété utilisateur	getDeviceId(), avec repli sur getInstance().options.deviceId dans l’ancien SDK

4. Identité : du distinct_id à une session nommée

La moitié entrante est celle que la plupart des équipes sous-estiment. Sans elle, les sessions MousePlayer sont anonymes : vous pouvez les regarder, mais vous ne pouvez pas répondre à « montre-moi les enregistrements du compte qui a résilié la semaine dernière ».

Une fois la passerelle active, le distinct_id de votre outil d’analyse est écrit dans le champ custom_user_id de la session — le même champ que celui renseigné par l’appel manuel du SDK :

Si vous appelez déjà mp('set') vous-même, continuez. Une identité que vous fournissez explicitement est la plus fiable, car il s’agit de votre propre clé primaire et non d’un identifiant d’analyse propre à chaque navigateur.

5. Comportement technique

Les SDK d’analyse sont généralement chargés de manière asynchrone, souvent après que mp.js s’exécute déjà. Une tentative unique au démarrage échouerait donc sur la plupart des sites réels.

• La passerelle réessaie toutes les 1,5 seconde, jusqu’à dix fois, et s’arrête dès que les deux sens ont abouti.
• Chaque sens se règle indépendamment, si bien que l’URL de relecture n’est jamais envoyée deux fois pendant l’attente d’une identité.
• Si le SDK n’apparaît jamais, la passerelle abandonne silencieusement après environ 15 secondes. Rien n’est écrit dans la console et l’enregistrement de la session continue sans être affecté.
• Les identifiants de plus de 128 caractères sont ignorés plutôt que tronqués, afin de ne pas stocker un demi-identifiant qui ne correspondrait jamais à rien.

6. Vérifier que cela fonctionne

1. Ouvrez votre site dans un onglet de navigateur normal et interagissez brièvement avec lui.
2. Dans votre outil d’analyse, ouvrez l’événement le plus récent et cherchez la propriété mouseplayer_session_url. L’ouvrir doit vous mener directement à l’enregistrement.
3. Dans MousePlayer, ouvrez l’explorateur d’utilisateurs. Les sessions qui portent une identité l’affichent à la place du pseudonyme généré pour le visiteur.

Si rien n’apparaît

• La propriété manque sur tous les événements : vérifiez que le SDK d’analyse se charge réellement sur la page et que vous avez sélectionné la plateforme correspondante. Une sélection PostHog ne lira pas Mixpanel.
• La propriété n’apparaît que sur des événements ultérieurs : c’est normal, voir la remarque de la section 3.
• L’URL est présente, mais pas l’identité : votre SDK n’a pas encore attribué de distinct_id, ce qui est normal avant qu’un utilisateur soit identifié. Il sera repris lors d’un chargement de page ultérieur.
• Vous testez en tant qu’administrateur connecté : certaines configurations excluent le trafic interne. Essayez une fenêtre de navigation privée.