Mixpanel aan Elido koppelen

Elido stuurt elke keer dat iemand op een van je korte links klikt een link_click-gebeurtenis naar de ingestion-API van Mixpanel. Als je team al in Mixpanel werkt, verschijnen linkinteracties naast je productgebeurtenissen zonder dat je ergens een trackingscript hoeft toe te voegen.

Alleen klikken worden doorgestuurd. Conversiegebeurtenissen doorsturen naar Mixpanel staat gepland.

Wat je nodig hebt

• Een Mixpanel-project.
• De Project Token van het project. Dit is volgens het model van Mixpanel geen geheim, maar Elido slaat de token wel versleuteld op.
• Weten welke dataresidentie je project heeft: US, EU of India.
• De rol Admin of Owner in je Elido-workspace (de machtiging conversions.manage).

Stap 1: Zoek je projecttoken en dataresidentie

1. Log in bij Mixpanel en open Settings → Project Settings.
2. Kopieer onder Access Keys de Project Token. Gebruik niet de API Secret of een serviceaccount; Elido heeft die niet nodig.
3. Controleer de waarde van Data Residency voor het project. In Elido kies je dezelfde waarde.

Stap 2: Koppel in Elido

1. Ga naar Dashboard → Integrations → Mixpanel.
2. Klik op Connect Mixpanel.
3. Plak de token in Project Token.
4. Stel Data residency in op de waarde van je project:
   • United States stuurt naar api.mixpanel.com (de standaardwaarde).
   • EU stuurt naar api-eu.mixpanel.com.
   • India stuurt naar api-in.mixpanel.com.
5. Klik op Save. In het paneel staat nu Connected en de token is gemaskeerd, behalve de eerste en laatste vier tekens.

Het doorsturen geldt voor elke link in de workspace; er is geen schakelaar per link. Het begint ongeveer 5 minuten na het opslaan, en een gewijzigde token of dataresidentie, of het verbreken van de verbinding, wordt binnen hetzelfde tijdsbestek van kracht.

Stap 3: Test de verbinding

Klik op Test connection. Elido stuurt één link_click-gebeurtenis met elido_test: true en slug _test, en toont het antwoord van Mixpanel onder de knop: de HTTP-status, de host waarnaar het bericht is verzonden en de response body.

Een geslaagde test is geen bewijs. Het /track-endpoint van Mixpanel controleert niet of de token geldig is of dat het project op die dataresidentie staat, dus een verkeerde token of regio kan de test nog steeds laten slagen. Een mislukking is daarentegen echt: Mixpanel heeft de gebeurtenis geweigerd en het bericht legt uit waarom.

Wat Elido verstuurt

Elke klik wordt één gebeurtenis:

{
  "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 is elido-link- plus het link-ID, dus één waarde per link en niet per bezoeker.
• time is het tijdstip van de klik in Unix-seconden.
• destination is de URL waarnaar de bezoeker is doorgestuurd.
• country is een tweeletterige landcode en device het apparaattype.
• ip is het IP-adres van de bezoeker; Mixpanel gebruikt dit voor de eigen geolocatie.
• De testgebeurtenis voegt elido_test: true toe.

Elke geregistreerde klik wordt doorgestuurd, ook klikken die de analyse van Elido als verdacht of botverkeer markeert. Als Mixpanel niet bereikbaar is, probeert Elido het na een seconde nog één keer en laat de gebeurtenis daarna vallen; er is geen backlog of replay. Zie Mixpanel link_click events voor een uitleg per veld en ideeën voor rapporten.

Hoe distinct_id werkt en wat de beperkingen zijn

Omdat distinct_id per link is, telt elke klik op dezelfde link als dezelfde Mixpanel-"gebruiker". Dat betekent:

• Uniques bij link_click tellen links en geen mensen. Gebruik in plaats daarvan het totale aantal gebeurtenissen.
• Funnels van link_click naar je registratie- of aankoopgebeurtenis worden niet gekoppeld, omdat die gebeurtenissen bij een andere distinct_id horen.
• De hot-shardlimiet van Mixpanel geldt per distinct_id, dus één zeer drukke link zou daar als eerste tegenaan lopen.

Als je iemand nu van klik naar registratie wilt volgen, zet je UTM-tags op de bestemmings-URL en laat je de Mixpanel-SDK op je landingspagina ze vastleggen. Identificeer de gebruiker daar vervolgens zoals je dat normaal zou doen.

Probleemoplossing

Test connection slaagt, maar er verschijnt niets in Mixpanel. Controleer eerst de token: kopieer die opnieuw uit Settings → Project Settings → Access Keys. Controleer daarna Data residency aan de hand van de instelling van het project. Beide fouten laten de test slagen, zoals hierboven uitgelegd.

Test connection mislukt. Lees de fout en response body onder de knop; die komen rechtstreeks van Mixpanel. Corrigeer de token of dataresidentie, klik op Update key, sla op en test opnieuw.

Gebeurtenissen komen in het verkeerde project terecht. Tokens zijn per project. Als je er meerdere hebt, controleer dan of je de token hebt gekopieerd van het project dat je bedoelde.

Echte klikken verschijnen niet meteen na het koppelen. Het kan ongeveer 5 minuten duren voordat het doorsturen begint. Klik daarna op een korte link en controleer de weergave Events.

Mixpanel-gebruikers komen niet overeen met je geïdentificeerde gebruikers. Dat is te verwachten: Elido's distinct_id is per link. Zie het bovenstaande gedeelte voor de UTM-oplossing.