Mixpanel Integration Guide
Power Up User Behavior Analysis with Linkzly + Mixpanel
Linkzly's Mixpanel integration brings your short link and QR code events to life in Mixpanel's powerful analytics platform. Track rich properties like referrer, short code, and source channel with idempotency for clean, duplicate-free data. This server-side forwarding ensures real-time insights into user cohorts, engagement patterns, and funnels—perfect for optimizing retention and growth.
With production-grade scalability (up to 2GB/minute ingestion), Linkzly + Mixpanel helps you understand behaviors at scale, without missing a beat.
This integration uses Mixpanel's Track API for client-side feel with server-side reliability.
Why Integrate Linkzly with Mixpanel?
Transform your link and QR code data into actionable user insights with Mixpanel's advanced analytics.
Rich Event Tracking
Send "link_click" or "qr_scan" events with properties for detailed cohort analysis and pattern detection.
Idempotency for Accuracy
Unique IDs prevent duplicates, ensuring reliable data for queries and reports.
Scalable Ingestion
Handles billions of events daily with batching and compression—ideal for high-traffic campaigns.
User-Centric Model
Tie events to distinct users for personalized insights, without PII risks.
Real-Time & Historical
Forward live data or import backfills for comprehensive views.
Cost-Effective Growth
Reduce churn by analyzing behaviors, driving better user experiences and ROI.
Key Features in Linkzly's Mixpanel Integration
Comprehensive event tracking with advanced deduplication and scalable ingestion.
Event Properties
Include referrer, short code, source channel, geo, and UTM—up to 255 properties per event.
Idempotency Support
Automatic deduplication via $insert_id.
Geo Enrichment
Auto-add city/country from IP for segmented analysis.
Batching & Retries
Up to 2000 events per request, with exponential backoff for 429 errors.
Limits Compliance
Events <1MB uncompressed, rate-limited to 2GB/min for QoS.
Timeouts
Customizable for reliable delivery.
Step-by-Step Setup Guide
Integrate effortlessly and start analyzing user flows in minutes.
Access Integrations
In Linkzly, go to "Integrations" > "Add New" > Select Mixpanel.
Enter Credentials
Provide your Mixpanel Project Token (from Mixpanel Settings > Project Settings > Project Token).
Configure Settings
Enable idempotency, set timeouts, and choose EU/IN residency endpoints if needed.
Map Events
Pre-map Linkzly events to Mixpanel (e.g., "link_click" with properties like genre: "hip-hop").
Avoid reserved names like $ or mp_.
Test Connection
Send a sample event and verify in Mixpanel's Events page or Live View.
Activate & Monitor
Enable and track ingestion rates—use Mixpanel's autocomplete for recent data validation.
Sample Event Payload
Example of a forwarded click event:
[
{
"event": "link_click",
"properties": {
"distinct_id": "user123",
"$insert_id": "unique-event-id-456",
"referrer": "https://example.com",
"short_code": "abc123",
"source_channel": "email",
"ip": "192.0.2.1",
"time": 1627849200
}
}
]POST Request
To https://api.mixpanel.com/track (or EU/IN variants).
Geo Example
IP auto-enriches to add City, Country.
Best Practices for Production-Grade Use
Follow these recommendations to ensure optimal performance and data quality.
Event Naming
Use Object-Action (e.g., "Video Played")—short, descriptive, alphanumeric with underscores.
Properties
Flatten JSON strings; avoid user-generated content or high-cardinality IDs.
Batching
Send up to 2000 events/request, gzip-compressed for efficiency.
Rate Limiting
Backoff on 429s; partition by distinct_id for scale.
Historical Imports
Start with recent data (last 30 days) before backfills.
Testing
Use a separate project; check for super properties persistence.
Real-World Example: App Engagement
A mobile app forwards QR scans to Mixpanel. Event: "qr_scan" with properties like genre. Analysis shows 45% retention from email scans.
They optimize by cohorting users for targeted pushes, boosting engagement 25%.