Connect Mixpanel to Elido

Elido sends click and conversion events to Mixpanel server-side. If you already use Mixpanel to track user behavior, adding Elido events gives you link engagement in the same funnel analysis — without client-side JavaScript.

What you need#

• A Mixpanel project.
• The project's Project Token (not a secret — it's safe to paste here).

Step 1 — Find your project token#

1. Log into Mixpanel.
2. Go to Settings → Project → Access Keys.
3. Copy the Project Token. It's a 32-character string. Don't confuse it with the Secret (which is used for importing data in batch; Elido uses the standard track endpoint instead).

Step 2 — Configure in Elido#

1. Go to Dashboard → Conversions → Mixpanel → Set up forwarding.
2. Paste the project token.
3. (Optional) Choose which events to forward: link.clicked, conversion.recorded, or both.
4. Click Save. Elido sends a test event immediately.

Check Mixpanel's Events view (Live view) within 30 seconds — you should see an elido_test event.

How distinct_id is mapped#

Mixpanel requires a distinct_id to attribute events to a user. Elido maps it as follows:

1. If you include a mixpanel_distinct_id parameter in your short link's destination URL (or pass it to the Conversions API), Elido uses that value directly. This gives you perfect session stitching.
2. Otherwise, Elido uses a hash of the Elido click_id. This creates a stable anonymous ID per click. Funnels that cross clicks and server events won't stitch automatically — but per-link analysis will work cleanly.

For most use cases (link campaign analysis, conversion attribution), option 2 is fine. For user-level journey mapping, implement option 1.

Event properties sent to Mixpanel#

Every Elido event includes:

{
  "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"
  }
}

Conversion events also include value and currency.

Troubleshooting#

Events not showing in Mixpanel Live view — Confirm the project token is correct. A wrong token returns HTTP 200 from Mixpanel (they accept silently) but the event never appears. Double-check by copying the token character by character.

Events appearing under a different project — Mixpanel tokens are project-specific. If you have multiple projects, confirm you copied from the right one in Settings → Project.

distinct_id not matching existing Mixpanel users — You need to pass the mixpanel_distinct_id in your Elido short link destination URL or via the Conversions API. Without it, Elido generates an anonymous ID that won't match your existing identified users.

Only seeing test event, not real events — Verify that the event types are enabled in Dashboard → Conversions → Mixpanel → Configure events. Both link.clicked and conversion.recorded can be toggled independently.