Connetti Mixpanel a Elido

Elido invia un evento link_click all'API di ingestione di Mixpanel ogni volta che qualcuno fa clic su uno dei tuoi link brevi. Se il tuo team lavora già in Mixpanel, l'engagement sui link appare accanto agli eventi del prodotto senza aggiungere uno script di tracciamento in alcun punto.

Vengono inoltrati solo i clic. L'inoltro degli eventi di conversione a Mixpanel è previsto, ma non è ancora disponibile.

Cosa ti serve

• Un progetto Mixpanel.
• Il Project Token del progetto. Nel modello di Mixpanel non è un segreto, ma Elido lo conserva comunque in forma crittografata.
• Sapere qual è la residenza dei dati del tuo progetto: US, EU o India.
• Il ruolo Admin o Owner nel tuo workspace Elido (il permesso conversions.manage).

Passaggio 1: trova il token e la residenza del progetto

1. Accedi a Mixpanel e apri Settings → Project Settings.
2. In Access Keys, copia il Project Token. Non usare l'API Secret o un account di servizio: Elido non ne ha bisogno.
3. Controlla il valore Data Residency del progetto. In Elido selezionerai lo stesso valore.

Passaggio 2: connettiti a Elido

1. Vai su Dashboard → Integrations → Mixpanel.
2. Fai clic su Connect Mixpanel.
3. Incolla il token in Project Token.
4. Imposta Data residency in modo che corrisponda al tuo progetto:
   • United States invia gli eventi a api.mixpanel.com (il valore predefinito).
   • EU invia gli eventi a api-eu.mixpanel.com.
   • India invia gli eventi a api-in.mixpanel.com.
5. Fai clic su Save. Il pannello mostra ora Connected e il token mascherato, lasciando visibili solo i primi e gli ultimi quattro caratteri.

L'inoltro riguarda ogni link del workspace: non esiste un'opzione per singolo link. Inizia entro circa 5 minuti dal salvataggio; anche la modifica del token o della residenza, oppure la disconnessione, diventa effettiva entro lo stesso intervallo.

Passaggio 3: testa la connessione

Fai clic su Test connection. Elido invia un evento link_click con elido_test: true e slug _test, quindi mostra la risposta di Mixpanel sotto il pulsante: lo stato HTTP, l'host a cui ha inviato la richiesta e il corpo della risposta.

Un esito positivo non è una prova. L'endpoint /track di Mixpanel non verifica se il token è valido o se il progetto risiede in quella residenza, quindi un token errato o una regione sbagliata possono comunque superare il test. Un errore, invece, è reale: Mixpanel ha rifiutato l'evento e il messaggio spiega perché.

Cosa invia Elido

Ogni clic diventa un evento:

{
  "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 è composto da elido-link- più l'ID del link, quindi è un valore per link, non per visitatore.
• time è l'ora del clic in secondi Unix.
• destination è l'URL a cui è stato inviato il visitatore.
• country è un codice paese di due lettere e device il tipo di dispositivo.
• ip è l'indirizzo IP del visitatore; Mixpanel lo usa per la propria geolocalizzazione.
• L'evento di test aggiunge elido_test: true.

Ogni clic registrato viene inoltrato, compresi quelli che gli indicatori analitici di Elido segnalano come sospetti o provenienti da bot. Se Mixpanel non è raggiungibile, Elido riprova una volta dopo un secondo e poi scarta l'evento: non c'è alcun backlog o replay. Per una spiegazione campo per campo e idee per i report, consulta gli eventi link_click di Mixpanel.

Come funziona distinct_id e quali sono i suoi limiti

Poiché distinct_id è associato al link, ogni clic sullo stesso link viene considerato lo stesso "utente" di Mixpanel. Questo significa che:

• Uniques sugli eventi link_click contano i link, non le persone. Usa invece il conteggio totale degli eventi.
• I funnel da link_click all'evento di registrazione o acquisto non si collegheranno, perché questi eventi appartengono a un distinct_id diverso.
• Il limite di hot shard di Mixpanel si applica a ogni distinct_id, quindi verrebbe raggiunto prima su un link molto trafficato.

Per seguire oggi una persona dal clic alla registrazione, aggiungi tag UTM all'URL di destinazione e lascia che l'SDK Mixpanel sulla tua landing page li acquisisca, poi identifica lì l'utente come fai normalmente.

Risoluzione dei problemi

Test connection va a buon fine, ma in Mixpanel non appare nulla. Controlla prima il token: copialo di nuovo da Settings → Project Settings → Access Keys. Poi verifica Data residency rispetto all'impostazione del progetto. Entrambi gli errori superano il test, come spiegato sopra.

Test connection restituisce un errore. Leggi l'errore e il corpo della risposta sotto il pulsante: arrivano direttamente da Mixpanel. Correggi il token o la residenza, fai clic su Update key, salva e ripeti il test.

Gli eventi finiscono nel progetto sbagliato. I token sono specifici per progetto. Se ne hai diversi, assicurati di aver copiato il token dal progetto corretto.

I clic reali non compaiono subito dopo la connessione. L'inoltro può impiegare circa 5 minuti per iniziare. Dopo questo intervallo, fai clic su un link breve e controlla la vista Events.

Gli utenti Mixpanel non corrispondono agli utenti identificati. È previsto: il distinct_id di Elido è associato al link. Consulta la sezione precedente per la soluzione con i tag UTM.