9 min de cititIntegrări

Urmărirea linkurilor în Mixpanel: clicurile ca evenimente

Urmărirea linkurilor în Mixpanel cu Elido: fiecare clic pe un link scurt devine un eveniment link_click server-side. Configurare, proprietăți, identitate.

Marius Voß
DevRel · edge infra

Urmărirea linkurilor în Mixpanel prin Elido este server-side și într-un singur sens: de fiecare dată când cineva dă clic pe unul dintre linkurile tale scurte, Elido postează un eveniment link_click la endpointul track al Mixpanel, cu tokenul proiectului tău. Evenimentul poartă slugul linkului, ID-ul linkului, țara și dispozitivul vizitatorului, destinația către care a fost trimis și un marcaj de timp. Nu rulează nimic în browserul vizitatorului, deci nici blocantele de reclame, nici bannerele de consimțământ nu îl ating.

Problema este identitatea. Fiecare eveniment este legat de link, nu de persoană, ceea ce înseamnă că poți număra și segmenta clicuri în Mixpanel toată ziua, dar nu poți urmări un utilizator care a dat clic în produsul tău pornind doar de la acel eveniment. Îți arăt la ce este bun, cum îl configurezi, cum îl verifici în vizualizarea Events și unde aș apela la altceva.

Dacă încă te decizi ce să etichetezi înainte de toate acestea, ghidul pilon despre urmărirea UTM-urilor cap-coadă este un punct de pornire mai bun. Mixpanel vede doar ce poartă linkul.

Ce trimite Elido către Mixpanel la fiecare clic

Un clic, un eveniment. Forwarderul construiește un lot cu un singur eveniment și îl trimite prin POST la /track pe hostul de ingestie care corespunde setării Data residency a integrării (api.mixpanel.com pentru US, api-eu.mixpanel.com pentru UE, api-in.mixpanel.com pentru India), autentificat prin tokenul din proprietăți, exact cum se așteaptă API-ul de ingestie al Mixpanel să sosească evenimentele server-side.

Iată payloadul complet, din care am scos doar valoarea tokenului:

[
  {
    "event": "link_click",
    "properties": {
      "token": "<your project token>",
      "distinct_id": "elido-link-4711",
      "workspace_id": 12,
      "link_id": 4711,
      "slug": "spring-26",
      "country": "DE",
      "device": "mobile",
      "destination": "https://shop.example/spring?utm_source=newsletter",
      "time": 1790000000,
      "ip": "203.0.113.0"
    }
  }
]

Atât. O listă scurtă, și intenționat.

ProprietateCe conțineCe faci cu ea în Mixpanel
slug / link_idCe link scurt a fost accesatDimensiune de defalcare pentru fiecare raport
destinationURL-ul spre care a fost trimis acest vizitator, după eventualele reguli de rutareVezi ce variantă geo sau de dispozitiv s-a declanșat
country, deviceStabilite la redirectSegmentezi fără să te bazezi pe presupunerea proprie a Mixpanel
ipAdresa vizitatorului, trunchiată (IPv4 /24, IPv6 /48)Mixpanel deduce orașul și regiunea, apoi o elimină
distinct_idelido-link-<link_id>Citește secțiunea despre identitate înainte să folosești Uniques

Două detalii de știut. destination este cea rezolvată, deci dacă un smart link trimite iPhone-urile în App Store și pe toți ceilalți pe site-ul tău, vei vedea ambele URL-uri. Iar etichetele UTM călătoresc doar în interiorul acelui șir de destinație; nu există proprietăți separate utm_source sau utm_campaign, deci dacă le vrei drept coloane, îți trebuie o proprietate derivată în Mixpanel. Aceasta este singura parte de configurare pe care aș face-o din prima zi.

Boții evidenți, crawlerele care se anunță în user agent, sunt filtrați la redirect și nu ajung niciodată în Mixpanel.

Pagina de integrare Elido pentru Mixpanel, cu valorile de conectare ale proiectului și pașii de configurare pentru trimiterea clicurilor ca evenimente

Configurarea integrării Mixpanel

Întreaga configurare înseamnă două câmpuri. Ca să trimiți evenimente de clic în Mixpanel ai nevoie de un proiect Mixpanel și de tokenul proiectului, care se află la Project Settings în Mixpanel; tokenul este o cheie de scriere menită să fie încorporată, deci lipirea lui la un furnizor este normală. Nu lipi secretul API, care este un alt șir și nu este cel folosit de forwarder.

  1. În workspace-ul tău Elido, deschide Integrations și alege cardul Mixpanel.
  2. Dă clic pe Connect Mixpanel, lipește tokenul în Project Token și alege Data residency: US (implicit), EU sau India, potrivit valorii Data Residency din setările proiectului tău Mixpanel. Salvează. Elido criptează tokenul în repaus și nu ți-l mai arată niciodată complet.
  3. Așteaptă câteva minute. Setările de integrare ale workspace-ului sunt ținute scurt în cache de partea forwarderului, deci primele clicuri de după salvare pot să nu fie trimise încă.
  4. Dă clic de pe un telefon pe unul dintre propriile linkuri.

Nu există un comutator per link. Odată conectat, fiecare clic din workspace este transmis, ceea ce se potrivește unei echipe care trăiește în Mixpanel și nu se potrivește unui workspace care găzduiește linkuri scurte pentru douăzeci de clienți fără legătură între ei. Dacă acesta ești tu, împarte mai întâi clienții în workspace-uri separate.

Verifică vizualizarea Events înainte să ai încredere în orice

Ceea ce Mixpanel numea Live View este acum vizualizarea Events, sub Data în navigarea din stânga, iar ghidul de depanare al Mixpanel o recomandă ca primă oprire pentru exact această treabă. Deschide-o, filtrează pe link_click, apoi atinge linkul tău scurt de pe un telefon care nu este pe Wi-Fi-ul biroului.

Fluxul unui clic pe un link scurt spre Mixpanel: vizitatorul atinge linkul, redirectul Elido răspunde primul și înregistrează clicul, forwarderul postează un eveniment link_click la endpointul track al Mixpanel pentru regiunea Data residency setată în Elido (US, EU sau India).

Ar trebui să vezi evenimentul în câteva secunde. Extinde-l și verifică trei lucruri: slug se potrivește cu linkul atins, country este locul în care se află de fapt telefonul, iar orașul și regiunea Mixpanel sunt completate din ip-ul trunchiat, deci tratează-le ca aproximative. Dacă orașul arată un centru de date, testul tău a trecut printr-un VPN.

Butonul Test connection din panoul integrării trimite un link_click marcat elido_test: true și arată răspunsul Mixpanel sub buton. Util, dar nu o dovadă: endpointul track al Mixpanel acceptă orice token și nu verifică niciodată rezidența, deci un rezultat verde cu tokenul greșit sau regiunea greșită înseamnă tot că nu ajunge nimic în proiectul tău. Evenimentul pe care îl vezi sosind de la un clic real este singura dovadă pe care aș accepta-o.

Trei rapoarte Mixpanel de construit primele

Când apare primul clic real, rezistă tentației de a construi un dashboard cu de toate. Aceste trei rapoarte folosesc doar ce poartă evenimentul și răspund la întrebările pe care le pun de fapt oamenii despre linkurile scurte.

  1. Clicuri pe link. În Insights, alege link_click, măsoară Total Events și defalcă pe slug. Acesta este clasamentul tău și funcționează pentru că slug este o proprietate obișnuită pe fiecare eveniment.
  2. Clicuri pe țară și dispozitiv. Același eveniment, defalcă pe country, apoi pe device. Fiindcă ambele sunt stabilite la redirect, o campanie în limba germană care ajunge mai ales pe desktop într-o altă țară se vede într-o zi.
  3. Ce destinație s-a declanșat. Defalcă pe destination pentru un smart link cu mai multe ținte. Fiecare variantă apare ca propria valoare, așa că vezi împărțirea între App Store, Play Store și varianta web de rezervă.

Folosește Total Events în toate trei, nu Unique Users. Așa cum explică secțiunea următoare, unicii de pe acest eveniment numără linkuri, nu oameni. Dacă vrei o coloană UTM, creează în Mixpanel o proprietate personalizată care citește campania din destination, apoi defalcă după ea. Recomandările despre planul de urmărire ale Mixpanel merită răsfoite înainte să adaugi mai mult, pentru că un nume de eveniment curat și puține proprietăți țin rapoartele lizibile peste un an.

Iată limita de identitate, spusă pe șleau. distinct_id este elido-link- plus ID-ul linkului, deci fiecare clic pe spring-26 aparține unui singur "utilizator" sintetic din Mixpanel.

Mixpanel distinct_id per link: trei vizitatori diferiți dau clic pe același link scurt și toate cele trei evenimente link_click au același distinct_id elido-link-4711, deci Mixpanel numără un utilizator.

Totalurile merg. Defalcările pe slug, țară, dispozitiv și destinație merg, la fel și tendințele în timp. Trei lucruri se strică:

  • Unicii de pe link_click numără linkuri, nu oameni. O campanie cu 40.000 de clicuri pe două linkuri arată doi utilizatori unici.
  • Pâlniile care încep la link_click și se termină la evenimentul tău de înscriere nu se leagă, pentru că înscrierea aparține altui distinct_id.

Mai există un al treilea, pe care majoritatea echipelor nu-l ating niciodată. Mixpanel aplică limite hot shard de 200K evenimente per distinct_id pe zi, iar dincolo de ele evenimentele sunt redenumite în $hotshard_events. Un singur link care devine cu adevărat viral poate depăși această limită și, fiindcă ID-ul este per link, tocmai acel link este lovit.

De ce nu un ID per vizitator? Pentru că redirectul nu știe cine este vizitatorul și prefer să nu seteze un cookie pe un domeniu pe care vizitatorul nu l-a ales să-l viziteze. Un compromis sincer.

Cum legi clicurile pe linkuri scurte de utilizatori, pe calea care funcționează

Tiparul care funcționează folosește cele două jumătăți pentru ce se pricepe fiecare. Lasă evenimentul server-side al Elido să-ți dea numărul complet de clicuri, inclusiv clicurile oamenilor care abandonează înainte să se încarce pagina ta. Lasă SDK-ul Mixpanel de pe pagina de destinație să se ocupe de identitate.

Pune etichete UTM pe URL-ul destinației. Biblioteca JavaScript a Mixpanel urmărește implicit parametrii UTM și înregistrează valorile first-touch pe profil, așa că atunci când acel vizitator se înscrie mai târziu și apelezi identify, campania rămâne lipită de o persoană reală. Clicul pe linkul scurt și vizualizarea paginii de destinație împart atunci o valoare de campanie, nu un ID de utilizator, iar le îmbini într-un raport pe utm_campaign. Este o îmbinare la nivel de campanie, mai grosieră decât una la nivel de utilizator, și cred că oricum este nivelul potrivit pentru aceste date.

Vrei totalurile de clicuri și sesiunile paginii de destinație alăturat? Așteaptă-te să difere; clicurile pe linkuri scurte vs sesiunile GA4 explică de ce același decalaj apare în orice instrument de analiză, Mixpanel inclus.

Dacă aceasta este configurarea care îți lipsea, conectează un workspace și trimite următoarea campanie prin linkuri de brand.

Unde ajunge scurt azi

Trei lacune, ordonate după cât de probabil este să te lovească.

IP-ul trunchiat al vizitatorului călătorește în fiecare eveniment (gol dacă workspace-ul activează modul fără date personale). Cu rezidența în UE merge la hostul de ingestie din UE; pe implicitul US merge la un endpoint american, iar ghidul rezidenței datelor în UE tratează cum cântărești asta. Pentru partea Mixpanel în mod special, inclusiv cum verifici rezidența proiectului tău, vezi rezidența datelor Mixpanel în UE.

Livrarea este best effort. Un POST eșuat primește o reîncercare după o secundă, apoi este abandonat, iar evenimentele nu poartă $insert_id, deci o reîncercare după un succes lent poate număra dublu.

Evenimentul nu conține referrer sau browser, iar clicurile pe care redirectul le marchează ca suspecte sunt transmise în continuare. Consultă dashboardul de analiză a clicurilor când ai nevoie de ele.

Conversiile nu fac parte din asta. Urmărește veniturile acolo unde se află ID-ul utilizatorului tău.

Pe același subiect pe blog

Întrebări frecvente

Cum trimit evenimente de clic în Mixpanel de la un link scurt?

Lipește tokenul proiectului tău Mixpanel în integrarea Mixpanel din workspace-ul tău Elido și salvează. Din acel moment, fiecare clic pe un link din acel workspace este postat server-side în Mixpanel ca eveniment link_click, cu slugul, ID-ul linkului, țara, dispozitivul și destinația ca proprietăți. Pe redirect nu rulează JavaScript.

Ce nume de eveniment folosește Elido în Mixpanel?

Evenimentul se numește link_click, iar numele este fix. Construiește-ți rapoartele pe acest nume. Dacă vezi pe pagini Elido mai vechi un alt nume de eveniment, ai încredere în ce ajunge în vizualizarea Events, pentru că acela este payloadul pe care forwarderul îl trimite de fapt.

Poate Mixpanel să lege un clic pe un link scurt de un utilizator cunoscut?

Nu doar din evenimentul transmis. Elido setează distinct_id la o singură valoare per link, deci fiecare clic pe același link arată ca același utilizator Mixpanel. Ca să ajungi la o persoană reală, pune etichete UTM pe destinație și lasă SDK-ul Mixpanel de pe pagina ta de destinație să le preia, apoi identifică utilizatorul acolo, ca de obicei.

De ce nu apar clicurile mele Elido în Mixpanel?

Verifică trei lucruri, în ordine. Tokenul trebuie să fie tokenul proiectului corect, nu secretul API. Lasă câteva minute după salvare înainte ca primul clic să fie transmis. În sfârșit, dacă proiectul tău Mixpanel folosește rezidența datelor în UE sau în India, setează aceeași rezidență în integrarea Elido: evenimentele trimise la hostul de ingestie greșit nu sunt ingerate deloc.

Transmite Elido și conversiile către Mixpanel?

Integrarea Mixpanel acoperă doar clicurile; azi nu există un eveniment separat de conversie în payload. Pentru venituri, urmărește achiziția din backendul tău sau cu SDK-ul Mixpanel, folosind ID-ul real al utilizatorului. Acolo se află identitatea, deci conversia ajunge pe profilul corect, nu pe un substitut per link.

Stochează Mixpanel adresa IP a vizitatorului pe care o trimite Elido?

Elido trimite IP-ul deja trunchiat (IPv4 la /24, IPv6 la /48). Conform documentației de geolocalizare a Mixpanel, proprietatea ip a unui eveniment este folosită pentru a deduce țara, regiunea și orașul, apoi este eliminată înainte ca evenimentul să fie stocat. Așadar obții o locație aproximativă la nivel de oraș pentru fiecare clic în Mixpanel, dar IP-ul în sine nu ar trebui să apară ca proprietate interogabilă.

Încearcă Elido

Lipește un URL, obții un link scurt funcțional

Fără înregistrare. Linkul este activ timp de 30 de zile. Înregistrează-te ca să-l păstrezi pentru totdeauna.

Fără înregistrare. Creează un cont gratuit pentru 50 linkuri pe lună.

Încearcă Elido

Scurtător de URL-uri găzduit în UE, cu domenii personalizate, analiză avansată și un API deschis. Nivel gratuit - fără card bancar.

Etichete
mixpanel link tracking
send click events to mixpanel
mixpanel short link clicks
mixpanel server-side tracking
mixpanel distinct_id
link click analytics

Continuă lectura