OneSignal + Mixpanel entegrasyon genel bakışı
Ana faydalar
- Mixpanel’e mesaj olayları gönderin: Push, uygulama içi, e-posta ve SMS genelinde teslimat, tıklama, başarısızlık ve daha fazlasını izleyin.
- Gerçek zamanlı içgörüler – Mixpanel ürün analitiğini OneSignal etkileşim metrikleri ile birleştirin.
- Veriye dayalı kampanyalar – Mixpanel’in davranışsal segmentasyonunu kullanarak daha akıllı yeniden etkileşim çalıştırın.
- Mixpanel’den cohort’ları içe aktarın: Davranış tabanlı cohort’ları hedefleme için filtreleme olarak OneSignal’e otomatik olarak senkronize edin.
- Kişiselleştirilmiş mesajlaşma – Kullanıcılar Mixpanel cohort’larına girdiğinde veya çıktığında bağlamsal OneSignal mesajlarını tetikleyin.
Gereksinimler
- Mixpanel Hesabı
- OneSignal Ücretli Plan
- Kullanıcılar ve External ID ayarlanmış OneSignal uygulaması.
Bu entegrasyon kullanıcı oluşturmaz. Mixpanel’deki kullanıcıları OneSignal’dekilere eşleştirir.
Kurulum
OneSignal’e Mixpanel ekleyin
OneSignal’de Data > Integrations > Mixpanel’e gidin ve Activate’e tıklayın.
OneSignal'de Mixpanel entegrasyonunu etkinleştirin
- Project Token’ınızı bulun ve OneSignal’e kopyalayıp yapıştırın.
- Data Residency’nizi kontrol edin. Mixpanel’in AB sunucularını kullanıyorsanız, Send events exclusively to Mixpanel’s EU Residency Server kutusunu işaretleyin.
Mesaj olaylarını seçin
Mixpanel’e göndermek istediğiniz OneSignal mesaj olaylarını seçin. Bitirdiğinizde, Activate’e tıklayın.
OneSignal'de Mixpanel ayarları
Mixpanel’e OneSignal ekleyin
Mixpanel Integrations’ınızda OneSignal’i ekleyin.
Mixpanel'de OneSignal Entegrasyonu ekleyin
OneSignal - APP_NAME gibi tanımlanabilir bir şey olarak ayarlayın; burada APP_NAME, OneSignal’deki uygulamanın adıdır.
OneSignal Settings > Keys & IDs’de aşağıdaki verilere ihtiyacınız olacak:
- App ID
- API Key
USER ID eşleştirmesi
Bu adım, cohort senkronizasyonu ve olay takibinin düzgün çalışması için gereklidir.
- Paylaşılan bir tanımlayıcı kullanın: OneSignal’deki External ID, seçilen bir Mixpanel User ID Property (user_id gibi) ile eşleşmelidir.
- Seçilen kullanıcı özelliğinin Mixpanel ve OneSignal Kullanıcı Profillerinizde mevcut olduğunu doğrulayın.
OneSignal özelliklerini ayarlamak için Mixpanel'in kontrol paneli.
Mixpanel > Users > User Profile Properties
OneSignal > Audience > Users > External ID
Kullanıcıları Mixpanel
$distinct_id’ye göre OneSignal ile eşleştirirseniz, yalnızca en üstteki değerle eşleşir.Aşağıdaki örnekte, yalnızca 890ea9b1-9024-4fb9-a92f-152ba67dd21a çalışır. 109768518080488203109 veya $device:1880c06821f1b3-052354675cde95-1d525634-1fa400-1880c06821f1b3 ile eşleşemez.
User ID Property eşleştirmesi için kullanılıyorsa Distinct ID ayarlarken dikkatli olun.
Artık Mixpanel’den OneSignal’e cohort’ları dışa aktarabilmeli ve OneSignal’den Mixpanel’e mesaj olaylarını toplayabilmelisiniz.
Mixpanel cohort’larını OneSignal’e dışa aktarın
Önceki adımda tartışılan eşleşen User ID/External ID özelliğine sahip oldukları sürece Mixpanel cohort’larınızdaki kullanıcıları OneSignal’deki kullanıcılara senkronize edebilirsiniz. Mixpanel’den kullanıcı verilerini dışa aktarmak OneSignal’de kullanıcıyı oluşturmaz, kullanıcı zaten var olmalı ve eşleşen External ID’ye sahip olmalıdır. Mixpanel’den OneSignal’e kullanıcıları dışa aktarmak için:- Mixpanel’de bir cohort oluşturun.
- Options > Export to… > OneSignal Bağlantı adı’na tıklayın.
Bir Mixpanel cohort'unu OneSignal'e nasıl dışa aktarırsınız.
- Senkronizasyon sıklığını seçin ve Begin Sync’e basın.
Mixpanel sıklık seçenekleri.
OneSignal Segment oluşturma
- Senkronize edilen cohort, OneSignal’de bir Mixpanel Segment filtresi olarak görünür.
- Aşağıdaki koşullar karşılanırsa cohort için otomatik olarak bir Segment oluşturulur:
- Mixpanel Cohort’undaki kullanıcılar OneSignal’de de eşleşen External ID ile mevcuttur.
- OneSignal’deki Segment limitinizi aşmamalısınız.
Mixpanel’in OneSignal’de bir Segment oluşturması için en az bir eşleşen kullanıcı gerekir.
Segment oluşturulduktan sonra, cohort’ta daha sonra kullanıcı olmasa bile OneSignal’de kalacaktır. Bu durumda, Segment kullanıcılar tekrar eklenene kadar basitçe boş olarak gösterilir.
Bir Mixpanel Cohort'undan nasıl Segment oluşturulur
Mixpanel’de mesaj olaylarını izleyin
Bağlandıktan sonra, OneSignal gerçek zamanlı olarak Mixpanel’e mesaj olayları gönderecektir. Bunu test etmek için OneSignal’den kendinize bir mesaj gönderin, ardından Mixpanel’deki kullanıcı profil sayfanıza gidin. Activity Feed içinde olayların doldurulduğunu görmelisiniz:
OneSignal mesaj olayları ile Mixpanel activity feed örneği.
Mesaj olayları
Bunlar OneSignal’in Mixpanel’e gönderdiği mesaj olay türleridir. OneSignal Integrations Settings içinde bu olaylardan hangilerini Mixpanel projenize göndermek istediğinizi seçebilirsiniz.| Message Event Kind (OneSignal) | Message Event Name (Mixpanel) | Event Description |
|---|---|---|
| Push Sent | Message Sent | Push bildirimi başarıyla gönderildi. |
| Push Received | Message Received | Push bildirimi başarıyla alındı. |
| Push Clicked | App Opened from Push | Cihazda push bildirimine dokunuldu. |
| Push Failed | Push Failed | Push gönderilemedi. OneSignal’deki başarısız mesaj raporunu kontrol edin. |
| Push Unsubscribed | Push Unsubscribed | Abonelik push’tan abonelikten çıktı. |
| In-App Impression | Message Sent | Uygulama içi mesaj cihazda başarıyla görüntülendi. |
| In-App Clicked | Message Opened | Cihazda uygulama içi mesaja tıklandı. |
| In-App Page Displayed | In-App Page Displayed | Uygulama içi mesaj sayfası görüntülendi. |
| Email Sent | Message Sent | E-posta başarıyla gönderildi. |
| Email Received | Message Received | E-posta alıcı tarafından alındı. |
| Email Opened | Message Opened | E-posta alıcı tarafından açıldı. |
| Email Link Clicked | App Opened from Push | E-posta bağlantısına tıklandı. |
| Email Unsubscribed | Email Unsubscribed | Alıcı e-posta aboneliğinden çıktı. |
| Email Reported As Spam | Email Reported As Spam | E-posta alıcı tarafından spam olarak bildirildi. |
| Email Bounced | Email Bounced | E-posta kalıcı bir hata nedeniyle gönderene geri döndü. |
| Email Failed | Email Failed | E-posta alıcının gelen kutusuna teslim edilemedi. |
| Email Suppressed | Email Suppressed | E-posta adresi engelleme listenizde. Ya geri döndü ya da e-postalarınız spam olarak işaretlendi. |
| SMS Sent | App Opened from Push | SMS alıcıya gönderildi. |
| SMS Failed | SMS Failed | SMS gönderilemedi. |
| SMS Delivered | SMS Received | SMS başarıyla teslim edildi. |
| SMS Undelivered | SMS Undelivered | SMS gönderilemedi. |
Olay özellikleri
Bunlar OneSignal’den Mixpanel’e gönderilen herhangi bir olaydaki özelliklerdir| PROPERTY NAME | DESCRIPTION |
|---|---|
| Distinct ID | Mesajla ilişkili external_id. |
| Message ID | Ayrı mesajın tanımlayıcısı. |
| Message Name | Mesaj adı. |
| Message Title | Mesaj başlığı. |
| Message Contents | Mesaj içerikleri. |
| message_type | Gönderilen mesaj türü: push, uygulama içi, e-posta, SMS. |
| template_id | Kullanılan mesaj şablonu (API ve Journey Mesajları). |
| subscription_id | OneSignal ayarlı cihaz/e-posta/sms tanımlayıcısı. |
| device_type | Mesajı alan cihaz türü. |
| language | Cihazın iki karakterli dil kodu. |
| source | onesignal (tüm olaylar için kaynak olarak belirtilir) |
SSS
Cohort ve segment sayılarım neden eşleşmiyor?
- Eksik veya eşleşmeyen External ID’ler Yalnızca eşleşen OneSignal External ID ve Mixpanel User ID’ye sahip kullanıcılar dahil edilir. Bu entegrasyon kullanıcı veya abonelik oluşturmaz.
- Abonelikten çıkmış kullanıcılar OneSignal segmentleri yalnızca abone Abonelikler için sayıyı görüntüler. Abonelikten çıkmış Abonelikler Journey’ler veya Uygulama İçi Mesajlar için kullanılabilir.
- OneSignal’de mevcut olmayabilir veya yanlış bir External ID’ye sahip olabilir.
- Abonelikten çıkmış aboneliklere sahip olabilir.
Abonelikten çıkmış kullanıcılar Mixpanel’den senkronize oluyor mu?
Evet, ancak şu anda OneSignal segment sayılarından hariç tutuluyorlar. Başka Aboneliklere sahiplerse veya Abonelik türleri destekliyorsa, onlara Journey’ler veya Uygulama içi mesajlar aracılığıyla hala mesaj gönderebilirsiniz.Teslimat verileri neden eşleşmiyor?
Tek bir kullanıcının birden fazla Aboneliği (push cihazları, e-posta adresleri, telefon numaraları) olabilir. Her Abonelik kendi teslimat olayını oluşturur. Örneğin:- 1 kullanıcı = 2 Android + 1 iOS + 2 Web = 5 push Aboneliği
- 1 push mesajı = 5’e kadar gönderildi/alındı/tıklandı olayı
subscription_id’yi kullanın.
Eksik olayları gidermek için:
- External ID’yi ayarlamak için bir kullanıcı tanımlandığında
OneSignal.login’in çağrıldığından emin olun. OneSignal.logout’un External ID’yi kaldırmadığını doğrulayın.- External ID’yi değiştirebilecek API isteklerini veya CSV yüklemelerini kontrol edin.
Kullanıcı/abonelik olaylarını nasıl gönderebiliriz?
Kullanıcı ve abonelik düzeyindeki olaylar (örn. izin verildi, kullanıcı girişi/çıkışı) otomatik olarak gönderilmez. OneSignal SDK’da, bu olayları izlemek için Mixpanel’e göndermeniz için kullanılabilecek olay dinleyicileri vardır:- User State Observer: Mobile SDK , Web SDK
- Permission Observer: Mobile SDK , Web SDK