Conectează Mixpanel la Elido

Elido trimite un eveniment link_click către API-ul de ingestie Mixpanel de fiecare dată când cineva face clic pe unul dintre linkurile tale scurte. Dacă echipa ta lucrează deja în Mixpanel, interacțiunea cu linkurile apare lângă evenimentele produsului, fără să adaugi vreun script de urmărire.

Sunt transmise doar clicurile. Transmiterea evenimentelor de conversie către Mixpanel este planificată.

De ce ai nevoie

• Un proiect Mixpanel.
• Project Token al proiectului. În modelul Mixpanel nu este un secret, dar Elido îl stochează în continuare criptat.
• Să știi rezidența datelor proiectului tău: US, EU sau India.
• Rolul Admin sau Owner în workspace-ul tău Elido (permisiunea conversions.manage).

Pasul 1: Găsește tokenul și rezidența proiectului

1. Conectează-te la Mixpanel și deschide Settings → Project Settings.
2. În Access Keys, copiază Project Token. Nu folosi API Secret sau un cont de serviciu; Elido nu are nevoie de ele.
3. Verifică valoarea Data Residency a proiectului. O vei alege pe aceeași în Elido.

Pasul 2: Conectează-te în Elido

1. Mergi la Dashboard → Integrations → Mixpanel.
2. Apasă pe Connect Mixpanel.
3. Lipește tokenul în Project Token.
4. Setează Data residency astfel încât să corespundă proiectului tău:
   • United States trimite către api.mixpanel.com (valoarea implicită).
   • EU trimite către api-eu.mixpanel.com.
   • India trimite către api-in.mixpanel.com.
5. Apasă pe Save. Panoul afișează acum Connected, iar tokenul este mascat, cu excepția primelor și ultimelor patru caractere.

Transmiterea acoperă fiecare link din workspace; nu există o opțiune pentru fiecare link. Începe în aproximativ 5 minute de la salvare, iar schimbarea tokenului sau a rezidenței, precum și deconectarea, intră în vigoare în același interval.

Pasul 3: Testează conexiunea

Apasă pe Test connection. Elido trimite un eveniment link_click cu elido_test: true și slug-ul _test, apoi afișează răspunsul Mixpanel sub buton: statusul HTTP, gazda către care a făcut trimiterea și corpul răspunsului.

Un test reușit nu este o dovadă. Endpointul /track al Mixpanel nu verifică dacă tokenul este valid sau dacă proiectul se află în rezidența respectivă, așa că un token greșit sau o regiune greșită pot trece în continuare testul. Un eșec, pe de altă parte, este real: Mixpanel a respins evenimentul, iar mesajul spune de ce.

Ce trimite Elido

Fiecare clic devine un eveniment:

{
  "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 este elido-link- urmat de ID-ul linkului, deci este o valoare per link, nu per vizitator.
• time este momentul clicului în secunde Unix.
• destination este URL-ul către care a fost trimis vizitatorul.
• country este un cod de țară din două litere, iar device este tipul dispozitivului.
• ip este adresa IP a vizitatorului; Mixpanel o folosește pentru propria geolocalizare.
• Evenimentul de test adaugă elido_test: true.

Este transmis fiecare clic înregistrat, inclusiv clicurile pe care indicatorii de analiză Elido le marchează ca trafic suspect sau de tip bot. Dacă Mixpanel nu este accesibil, Elido reîncearcă o dată după o secundă, apoi elimină evenimentul; nu există backlog sau replay. Pentru o prezentare câmp cu câmp și idei de rapoarte, consultă Evenimentele link_click din Mixpanel.

Cum funcționează distinct_id și care sunt limitele sale

Deoarece distinct_id este per link, fiecare clic pe același link este considerat același "utilizator" Mixpanel. Asta înseamnă că:

• Uniques pentru link_click numără linkuri, nu persoane. Folosește în schimb numărul total de evenimente.
• Funnel-urile de la link_click la evenimentul de înregistrare sau de cumpărare nu se vor uni, deoarece acele evenimente aparțin unui alt distinct_id.
• Limita hot-shard din Mixpanel se aplică per distinct_id, așa că un singur link foarte aglomerat ar fi afectat primul.

Pentru a urmări astăzi o persoană de la clic la înregistrare, adaugă tag-uri UTM la URL-ul de destinație și lasă SDK-ul Mixpanel de pe pagina de destinație să le captureze, apoi identifică utilizatorul acolo, așa cum faci în mod normal.

Depanare

Test connection trece, dar nu apare nimic în Mixpanel. Verifică mai întâi tokenul: copiază-l din nou din Settings → Project Settings → Access Keys. Apoi verifică Data residency față de setarea proiectului. Ambele greșeli trec testul, după cum s-a explicat mai sus.

Test connection eșuează. Citește eroarea și corpul răspunsului de sub buton; vin direct de la Mixpanel. Corectează tokenul sau rezidența, apasă pe Update key, salvează și testează din nou.

Evenimentele ajung în proiectul greșit. Tokenurile sunt specifice proiectului. Dacă ai mai multe proiecte, asigură-te că ai copiat tokenul din proiectul dorit.

Clicurile reale nu apar imediat după conectare. Transmiterea poate dura aproximativ 5 minute până să înceapă. După aceea, fă clic pe un link scurt și verifică vizualizarea Events.

Utilizatorii Mixpanel nu corespund utilizatorilor identificați de tine. Este de așteptat: distinct_id din Elido este per link. Consultă secțiunea de mai sus pentru soluția cu UTM.