Connecter Mixpanel à Elido

Elido envoie un événement link_click à l'API d'ingestion de Mixpanel chaque fois qu'une personne clique sur l'un de vos liens courts. Si votre équipe travaille déjà dans Mixpanel, l'engagement sur les liens apparaît à côté de vos événements produit sans ajouter de script de suivi où que ce soit.

Seuls les clics sont transférés. Le transfert des événements de conversion vers Mixpanel est prévu.

Ce dont vous avez besoin

• Un projet Mixpanel.
• Le Project Token du projet. Ce n'est pas un secret selon le modèle de Mixpanel, mais Elido le stocke tout de même chiffré.
• Connaître la résidence des données de votre projet : US, EU ou India.
• Le rôle Admin ou Owner dans votre workspace Elido (la permission conversions.manage).

Étape 1 : trouver le token de votre projet et sa résidence

1. Connectez-vous à Mixpanel et ouvrez Settings → Project Settings.
2. Sous Access Keys, copiez le Project Token. N'utilisez ni l'API Secret ni un compte de service : Elido n'en a pas besoin.
3. Vérifiez la valeur Data Residency du projet. Vous choisirez la même dans Elido.

Étape 2 : se connecter dans Elido

1. Allez dans Dashboard → Integrations → Mixpanel.
2. Cliquez sur Connect Mixpanel.
3. Collez le token dans Project Token.
4. Définissez Data residency pour qu'il corresponde à votre projet :
   • United States envoie les événements à api.mixpanel.com (valeur par défaut).
   • EU les envoie à api-eu.mixpanel.com.
   • India les envoie à api-in.mixpanel.com.
5. Cliquez sur Save. Le panneau affiche alors Connected et le token masqué, à l'exception de ses quatre premiers et quatre derniers caractères.

Le transfert couvre tous les liens du workspace : il n'existe pas de bouton par lien. Il démarre dans les 5 minutes environ suivant l'enregistrement, et la prise en compte d'un token ou d'une résidence modifiés, ou d'une déconnexion, s'effectue dans le même délai.

Étape 3 : tester la connexion

Cliquez sur Test connection. Elido envoie un événement link_click avec elido_test: true et le slug _test, puis affiche la réponse de Mixpanel sous le bouton : le statut HTTP, l'hôte auquel la requête a été envoyée et le corps de la réponse.

Un test réussi n'est pas une preuve. L'endpoint /track de Mixpanel ne vérifie ni la validité du token ni la résidence du projet : un token erroné ou une mauvaise région peuvent donc tout de même réussir le test. En revanche, un échec est bien réel : Mixpanel a rejeté l'événement et le message en indique la raison.

Ce qu'Elido envoie

Chaque clic devient un événement :

{
  "event": "link_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "elido-link-4711",
    "time": 1789000000,
    "workspace_id": 42,
    "link_id": 4711,
    "slug": "spring-26",
    "destination": "https://example.com/spring",
    "country": "DE",
    "device": "mobile",
    "ip": "203.0.113.7"
  }
}

• distinct_id est composé de elido-link- et de l'ID du lien : il s'agit donc d'une valeur par lien, et non par visiteur.
• time correspond à l'heure du clic en secondes Unix.
• destination est l'URL vers laquelle le visiteur a été redirigé.
• country est un code pays à deux lettres et device, le type d'appareil.
• ip est l'adresse IP du visiteur ; Mixpanel l'utilise pour sa propre géolocalisation.
• L'événement de test ajoute elido_test: true.

Chaque clic enregistré est transféré, y compris les clics que les indicateurs analytiques d'Elido signalent comme suspects ou provenant de bots. Si Mixpanel est inaccessible, Elido réessaie une fois après une seconde, puis abandonne cet événement : il n'y a ni file d'attente ni replay. Pour une présentation champ par champ et des idées de rapports, consultez Mixpanel link_click events.

Fonctionnement de distinct_id et limites

Comme distinct_id est défini par lien, chaque clic sur le même lien est compté comme le même « utilisateur » Mixpanel. Cela signifie que :

• Les Uniques sur link_click comptent les liens, pas les personnes. Utilisez plutôt le nombre total d'événements.
• Les entonnoirs allant de link_click à votre événement d'inscription ou d'achat ne correspondront pas, car ces événements appartiennent à un autre distinct_id.
• La limite de hot-shard de Mixpanel s'applique par distinct_id : c'est donc sur un lien très fréquenté qu'elle se ferait d'abord sentir.

Pour suivre une personne du clic à l'inscription dès aujourd'hui, ajoutez des tags UTM à l'URL de destination et laissez le SDK Mixpanel de votre page d'arrivée les capturer, puis identifiez l'utilisateur sur cette page comme vous le feriez normalement.

Résolution des problèmes

Test connection réussit, mais rien ne s'affiche dans Mixpanel. Vérifiez d'abord le token : recopiez-le depuis Settings → Project Settings → Access Keys. Vérifiez ensuite Data residency par rapport au paramètre du projet. Ces deux erreurs n'empêchent pas le test de réussir, comme expliqué plus haut.

Test connection échoue. Lisez l'erreur et le corps de la réponse sous le bouton : ils proviennent directement de Mixpanel. Corrigez le token ou la résidence, cliquez sur Update key, enregistrez, puis testez à nouveau.

Les événements arrivent dans le mauvais projet. Les tokens sont propres à chaque projet. Si vous en avez plusieurs, vérifiez que vous avez copié le token du projet voulu.

Les vrais clics n'apparaissent pas juste après la connexion. Le transfert peut mettre environ 5 minutes à démarrer. Cliquez sur un lien court après ce délai, puis consultez la vue Events.

Les utilisateurs Mixpanel ne correspondent pas à vos utilisateurs identifiés. C'est normal : le distinct_id d'Elido est défini par lien. Consultez la section ci-dessus pour la solution avec les tags UTM.