Connetti Mixpanel a Elido

Elido invia eventi di clic e conversione a Mixpanel lato server. Se già usi Mixpanel per tracciare il comportamento degli utenti, aggiungere gli eventi Elido ti dà il coinvolgimento con i link nella stessa analisi del funnel — senza JavaScript lato client.

Cosa ti serve#

• Un progetto Mixpanel.
• Il Project Token del progetto (non è un segreto — è sicuro incollarlo qui).

Step 1 — Trova il tuo project token#

1. Accedi a Mixpanel.
2. Vai su Settings → Project → Access Keys.
3. Copia il Project Token. È una stringa di 32 caratteri. Non confonderlo con il Secret (usato per l'importazione di dati in batch; Elido usa invece l'endpoint track standard).

Step 2 — Configura in Elido#

1. Vai su Dashboard → Conversioni → Mixpanel → Configura inoltro.
2. Incolla il project token.
3. (Opzionale) Scegli quali eventi inoltrare: link.clicked, conversion.recorded, o entrambi.
4. Fai clic su Salva. Elido invia immediatamente un evento di test.

Come viene mappato distinct_id#

Mixpanel richiede un distinct_id per attribuire gli eventi a un utente. Elido lo mappa come segue:

1. Se includi un parametro mixpanel_distinct_id nell'URL di destinazione del tuo link abbreviato (o lo passi all'API Conversioni), Elido usa direttamente quel valore. Questo ti dà un stitching di sessione perfetto.
2. Altrimenti, Elido usa un hash del click_id Elido. Questo crea un ID anonimo stabile per clic. I funnel che attraversano clic ed eventi server non si uniranno automaticamente — ma l'analisi per link funzionerà correttamente.

Per la maggior parte dei casi d'uso (analisi delle campagne link, attribuzione delle conversioni), l'opzione 2 va bene. Per la mappatura del percorso a livello utente, implementa l'opzione 1.

Proprietà degli eventi inviate a Mixpanel#

Ogni evento Elido include:

{
  "event": "elido_click",
  "properties": {
    "token": "your-project-token",
    "distinct_id": "clk_abc123-hashed",
    "time": 1715515200,
    "link_slug": "spring-2026",
    "destination_url": "https://example.com/spring",
    "utm_source": "newsletter",
    "utm_medium": "email",
    "utm_campaign": "spring-2026",
    "country": "DE",
    "device": "mobile",
    "browser": "Chrome"
  }
}

Gli eventi di conversione includono anche value e currency.

Risoluzione dei problemi#

Gli eventi non appaiono nella vista Live di Mixpanel — Conferma che il project token sia corretto. Un token errato restituisce HTTP 200 da Mixpanel (accettano silenziosamente) ma l'evento non appare mai. Ricontrolla copiando il token carattere per carattere.

Gli eventi appaiono in un progetto diverso — I token Mixpanel sono specifici per progetto. Se hai più progetti, conferma di aver copiato da quello giusto in Settings → Project.

distinct_id non corrisponde agli utenti Mixpanel esistenti — Devi passare il mixpanel_distinct_id nell'URL di destinazione del link Elido abbreviato o tramite l'API Conversioni. Senza di esso, Elido genera un ID anonimo che non corrisponderà ai tuoi utenti identificati esistenti.

Vedo solo l'evento di test, non gli eventi reali — Verifica che i tipi di evento siano abilitati in Dashboard → Conversioni → Mixpanel → Configura eventi. link.clicked e conversion.recorded possono essere attivati/disattivati indipendentemente.