Mixpanel'i Elido'ya bağlayın

Elido, kısa bağlantılarınızdan birine her tıklandığında Mixpanel'in alım API'sine bir link_click olayı gönderir. Ekibiniz zaten Mixpanel'de çalışıyorsa bağlantı etkileşimi, herhangi bir yere izleme komut dosyası eklemeden ürün olaylarınızın yanında görünür.

Yalnızca tıklamalar iletilir. Dönüşüm olaylarının Mixpanel'e iletilmesi planlanmaktadır.

Gerekenler

• Bir Mixpanel projesi.
• Projenin Project Token'ı. Mixpanel'in modelinde bu bir gizli bilgi değildir, ancak Elido yine de token'ı şifreli olarak saklar.
• Projenizin veri yerleşimini bilmeniz: US, EU veya India.
• Elido çalışma alanınızda Admin veya Owner rolü (conversions.manage izni).

1. adım: Proje token'ınızı ve veri yerleşimini bulun

1. Mixpanel'de oturum açın ve Settings → Project Settings bölümünü açın.
2. Access Keys altında Project Token'ı kopyalayın. API Secret'ı veya bir hizmet hesabını kullanmayın; Elido bunlara ihtiyaç duymaz.
3. Projenin Data Residency değerini kontrol edin. Elido'da aynısını seçeceksiniz.

2. adım: Elido'ya bağlayın

1. Dashboard → Integrations → Mixpanel bölümüne gidin.
2. Connect Mixpanel'e tıklayın.
3. Token'ı Project Token alanına yapıştırın.
4. Data residency değerini projenizle eşleşecek şekilde ayarlayın:
   • United States, api.mixpanel.com adresine gönderir (varsayılan).
   • EU, api-eu.mixpanel.com adresine gönderir.
   • India, api-in.mixpanel.com adresine gönderir.
5. Save'e tıklayın. Panelde artık Connected ve ilk ve son dört karakteri gösterilen maskeli token görünür.

İletim, çalışma alanındaki her bağlantıyı kapsar; bağlantı başına bir açma-kapama seçeneği yoktur. Kaydettikten yaklaşık 5 dakika içinde başlar. Değiştirilen token veya yerleşim ya da bağlantının kesilmesi de aynı süre içinde etkili olur.

3. adım: Bağlantıyı test edin

Test connection'a tıklayın. Elido, elido_test: true ve slug _test içeren tek bir link_click olayı gönderir ve düğmenin altında Mixpanel'in yanıtını gösterir: HTTP durumu, gönderim yapılan sunucu ve yanıt gövdesi.

Başarılı olması kanıt değildir. Mixpanel'in /track uç noktası token'ın geçerli olup olmadığını veya projenin bu yerleşimde bulunup bulunmadığını kontrol etmez; bu nedenle yanlış token veya yanlış bölge yine de başarılı olabilir. Öte yandan başarısızlık gerçektir: Mixpanel olayı reddetmiştir ve mesaj nedenini belirtir.

Elido ne gönderir

Her tıklama tek bir olaya dönüşür:

{
  "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, bağlantı kimliğiyle birleştirilen elido-link- değeridir; bu nedenle ziyaretçi başına değil, bağlantı başına bir değerdir.
• time, Unix saniyeleri cinsinden tıklama zamanıdır.
• destination, ziyaretçinin gönderildiği URL'dir.
• country iki harfli ülke kodudur; device ise cihaz türüdür.
• ip, ziyaretçinin IP adresidir; Mixpanel bunu kendi coğrafi konumlandırması için kullanır.
• Test olayı elido_test: true ekler.

Kaydedilen her tıklama, Elido'nun şüpheli veya bot trafiği olarak işaretlediği tıklamalar da dahil olmak üzere iletilir. Mixpanel'e ulaşılamazsa Elido bir saniye sonra bir kez daha dener ve ardından bu olayı bırakır; birikmiş olay veya yeniden oynatma yoktur. Alan alan açıklama ve rapor fikirleri için Mixpanel link_click events sayfasına bakın.

distinct_id nasıl çalışır ve sınırları

distinct_id bağlantı başına olduğundan aynı bağlantıya yapılan her tıklama aynı Mixpanel "user" olarak sayılır. Bunun anlamı şudur:

• link_click üzerindeki Uniques, kişileri değil bağlantıları sayar. Bunun yerine toplam olay sayılarını kullanın.
• link_click olayından kayıt veya satın alma olayınıza giden huniler birleşmez, çünkü bu olaylar farklı bir distinct_id'ye aittir.
• Mixpanel'in yoğun parça sınırı her distinct_id için geçerlidir; bu nedenle sınır, çok yoğun bir bağlantıda ilk olarak kendini gösterir.

Bugün bir kişiyi tıklamadan kayda kadar takip etmek için hedef URL'ye UTM etiketleri ekleyin ve açılış sayfanızdaki Mixpanel SDK'sının bunları yakalamasını sağlayın; ardından kullanıcıyı her zamanki gibi orada tanımlayın.

Sorun giderme

Test connection başarılı oluyor ama Mixpanel'de hiçbir şey görünmüyor. Önce token'ı kontrol edin: token'ı Settings → Project Settings → Access Keys bölümünden tekrar kopyalayın. Ardından Data residency değerini projenin ayarıyla karşılaştırın. Yukarıda açıklandığı gibi her iki hata da testin başarılı olmasına neden olur.

Test connection başarısız oluyor. Düğmenin altındaki hatayı ve yanıt gövdesini okuyun; bunlar doğrudan Mixpanel'den gelir. Token'ı veya yerleşimi düzeltin, Update key'e tıklayın, kaydedin ve yeniden test edin.

Olaylar yanlış projeye ulaşıyor. Token'lar proje başınadır. Birden fazla projeniz varsa token'ı amaçladığınız projeden kopyaladığınızdan emin olun.

Gerçek tıklamalar bağlandıktan hemen sonra görünmüyor. İletimin başlaması yaklaşık 5 dakika sürebilir. Bundan sonra kısa bir bağlantıya tıklayın ve Events görünümünü kontrol edin.

Mixpanel kullanıcıları tanımladığınız kullanıcılarla eşleşmiyor. Bu beklenen bir durumdur: Elido'nun distinct_id değeri bağlantı başınadır. UTM çözümü için yukarıdaki bölüme bakın.