OneSignal + Amplitude Entegrasyonuna Genel Bakış
Temel avantajlar
- Amplitude’a 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ı takip edin.
- OneSignal’a özel olaylar gönderin: Özel olaylarınızı Amplitude’dan OneSignal’a gönderin.
- Amplitude’dan kohortları içe aktarın: Hedefleme için davranış tabanlı kohortları otomatik olarak OneSignal’a filtre olarak senkronize edin.
Gereksinimler
- Amplitude Hesabı
- OneSignal Ücretli Plan
- Kullanıcılar ve External ID ayarlanmış OneSignal uygulaması.
Bu entegrasyon kullanıcı oluşturmaz. Amplitude’daki kullanıcıları OneSignal’dakilere eşler.
Kurulum
OneSignal’a Amplitude Ekleme
OneSignal’da Data > Integrations > Amplitude bölümüne gidin ve Activate butonuna tıklayın.
OneSignal'da Amplitude Entegrasyon kartı
- Projenizin API Key’ini bulun ve OneSignal’a kopyalayıp yapıştırın.
- Amplitude’un AB sunucularını kullanıyorsanız, Send events exclusively to Amplitude’s EU Residency Endpoint seçeneğini işaretleyin. Bunu Amplitude URL’niz ile doğrulayabilirsiniz. Eğer
eu.amplitude.comgörüyorsanız, Amplitude’un AB sunucularını kullanıyorsunuz demektir.
Mesaj olaylarını seçin
Amplitude’a göndermek istediğiniz OneSignal mesaj olaylarını seçin. Bittiğinde Activate butonuna tıklayın.
OneSignal'da Amplitude ayarları
Amplitude’a OneSignal Ekleme
Amplitude’daki Destinations bölümünde OneSignal’ı arayın.
Amplitude'da OneSignal Hedef Ekleme
- Cohorts: Kohortları Amplitude’dan OneSignal’a senkronize edin.
- Events User Properties: Özel olayları Amplitude’dan OneSignal’a gönderin.
- Name: Hedefi Amplitude’da nasıl tanımladığınız. Bunu
OneSignal - APP_NAMEgibi tanımlanabilir bir şeye ayarlayın, buradaAPP_NAMEOneSignal’daki uygulamanın adıdır. - App ID: OneSignal App ID’si. OneSignal Settings > Keys & IDs bölümünde mevcuttur
- API Key: OneSignal API Key’i. OneSignal Settings > Keys & IDs bölümünde mevcuttur
Olayları gönderme
Beta özelliği. OneSignal’a özel olaylar göndermek için OneSignal’da Custom Events özelliğinin etkinleştirilmiş olması gerekir.
OneSignal'a gönderilecek Amplitude Olayları
USER ID eşleştirmesi
Bu adım, kohort senkronizasyonu ve olay takibinin düzgün çalışması için gereklidir.
- Paylaşılan bir tanımlayıcı kullanın: OneSignal’daki External ID seçilen bir Amplitude User ID Özelliği ile eşleşmelidir (user_id gibi).
- Seçilen kullanıcı özelliğinin Amplitude ve OneSignal Kullanıcı Profillerinizde mevcut olduğunu doğrulayın.
Ek özellikler
Özel olaylara dahil edilecek ek özellikleri OneSignal’a gönderebilirsiniz. Bu, olayları OneSignal’da yalnızca belirli bir özellik içeriyorlarsa işlemek için yararlıdır.Bittiğinde Save butonuna tıklayın.Artık Amplitude’dan OneSignal’a kohortları ve özel olayları dışa aktarabilmeli ve OneSignal’dan Amplitude’a mesaj olaylarını toplayabilmelisiniz.
Özel olayları test etme
- Amplitude > OneSignal Events Destination bölümünde Test Connection butonuna tıklayın.
Amplitude > OneSignal Events Destination
- Payload’daki
"user_id"’nin OneSignal Uygulamanızdaki mevcut bir Kullanıcının External ID’sine ayarlı olduğundan emin olun. - Send Test Event butonuna tıklayın
- Response kutusu boş kalmalı ve
"OneSignal has successfully received test event."yazan bir mesaj görmelisiniz
Response örneği
Bir hata alırsanız, OneSignal App ID ve REST API anahtarınızın Amplitude’a doğru eklendiğinden ve uygulamanın özel olaylar için yapılandırıldığından emin olun.
- OneSignal’da Data > Custom Events bölümüne gidin ve listede test olayını görmelisiniz.
OneSignal'da Özel Olay
Olayı görmüyorsanız,
"user_id"’nin OneSignal Uygulamanızdaki mevcut bir Kullanıcının External ID’sine ayarlı olduğundan emin olun.Amplitude kohortlarını OneSignal’a dışa aktarma
Önceki adımda tartışılan eşleşen User ID/External ID özelliğine sahip oldukları sürece, Amplitude kohortlarınızdaki kullanıcıları OneSignal’daki kullanıcılarla senkronize edebilirsiniz. Amplitude’dan kullanıcı verilerini dışa aktarmak OneSignal’da kullanıcı oluşturmaz, kullanıcının zaten var olması ve eşleşen External ID’ye sahip olması gerekir. Amplitude’dan OneSignal’a kullanıcıları dışa aktarmak için:- Amplitude’da bir kohort oluşturun. Amplitude’un kohortlar hakkındaki belgelerine bakın.
- Sync butonuna tıklayın ve hedef olarak OneSignal’ı seçin.
- Senkronizasyon sıklığını seçin.
OneSignal ile kohortlarınız için senkronizasyon ayarlama görüntüsü
OneSignal Segment oluşturma
- Senkronize edilen kohort, OneSignal’da bir Amplitude Segment filtresi olarak görünür.
- Aşağıdaki koşullar karşılandığında kohort için otomatik olarak bir Segment oluşturulur:
- Amplitude Cohort’undaki kullanıcılar, eşleşen External ID ile OneSignal’da da mevcuttur.
- OneSignal’daki Segment limitinizi aşmamış olmalısınız.
Amplitude Cohort'undan Segment oluşturma
Amplitude’da mesaj olaylarını takip etme
Bağlandıktan sonra, OneSignal mesaj olaylarını gerçek zamanlı olarak Amplitude’a gönderecektir.Mesaj olayları
Bunlar OneSignal’ın Amplitude’a gönderdiği mesaj olay türleridir. OneSignal Entegrasyonlar Ayarları içinde bu olaylardan hangilerini Amplitude projenize göndermek istediğinizi seçebilirsiniz.| Message Event Kind (OneSignal) | Message Event Name (Amplitude) | Event Description |
|---|---|---|
| Push Sent | [OneSignal] Push Sent | Push bildirimi başarıyla gönderildi. |
| Push Received | [OneSignal] Push Confirmed delivery | Push bildirimi başarıyla alındı |
| Push Clicked | [OneSignal] Push Clicked | Cihazda push bildirimine dokunuldu |
| Push Failed | [OneSignal] Push Failed | Push gönderilirken başarısız oldu. OneSignal’daki başarısız mesaj raporunu kontrol edin. |
| Push Unsubscribed | [OneSignal] Push Unsubscribed | Abonelik push’tan abonelikten çıktı. |
| In-App Impression | [OneSignal] IAM Displayed | Uygulama İçi Mesaj cihazda başarıyla görüntülendi |
| In-App Clicked | [OneSignal] IAM Clicked | Cihazda Uygulama İçi Mesaja tıklandı |
| In-App Page Displayed | [OneSignal] IAM Page Displayed | Uygulama İçi Mesaj sayfası görüntülendi |
| Email Sent | [OneSignal] Email Sent | E-posta başarıyla gönderildi |
| Email Received | [OneSignal] Email Confirmed delivery | E-posta alıcı tarafından alındı |
| Email Opened | [OneSignal] Email Opened | E-posta alıcı tarafından açıldı |
| Email Link Clicked | [OneSignal] Email Clicked | E-posta bağlantısına tıklandı |
| Email Unsubscribed | [OneSignal] Email Unsubscribed | Alıcı tarafından e-posta aboneliğinden çıkıldı |
| Email Reported As Spam | [OneSignal] Email Reported As SPAM | E-posta alıcı tarafından spam olarak bildirildi |
| Email Bounced | [OneSignal] Email Hard Bounced | Kalıcı hata nedeniyle e-posta gönderene geri döndü |
| Email Failed | [OneSignal] Email Failed delivery | E-posta alıcının gelen kutusuna teslim edilemedi |
| Email Suppressed | [OneSignal] Email Not delivering to suppressed email address | Alıcı gönderildiği e-posta adresini engellediği için e-posta teslim edilmedi |
| SMS Sent | [OneSignal] SMS Sent | SMS alıcıya gönderildi |
| SMS Failed | [OneSignal] SMS Failed delivery | SMS gönderilemedi |
| SMS Delivered | [OneSignal] SMS Confirmed deliveery | SMS başarıyla teslim edildi |
| SMS Undelivered | [OneSignal] SMS Undelivered | SMS gönderilemedi. |
Olay özellikleri
Bunlar OneSignal’dan Amplitude’a gönderilen tüm olaylarda bulunan özelliklerdir| PROPERTY NAME | DESCRIPTION |
|---|---|
| Distinct ID | Mesajla ilişkili external_id |
| Message ID | Ayrık mesajın tanımlayıcısı |
| Message Name | Mesaj adı |
| Message Title | Mesaj başlığı |
| Message Contents | Mesaj içeriği |
| message_type | Gönderilen mesajın türü, push, uygulama içi, e-posta, SMS |
| template_id | Kullanılan mesaj şablonu (API ve Journey Mesajları) |
| subscription_id | OneSignal tarafından ayarlanan 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
Kohort 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 Amplitude 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 olmuş Abonelikler için sayıyı görüntüler. Abonelikten çıkmış Abonelikler, Journey’ler veya Uygulama İçi Mesajlar için kullanılabilir.
- OneSignal’da mevcut olmayabilir veya yanlış External ID’ye sahip olabilir.
- Abonelikten çıkmış aboneliklere sahip olabilir.
Abonelikten çıkmış kullanıcılar Amplitude’dan senkronize ediliyor mu?
Evet, ancak şu anda OneSignal segment sayılarından hariç tutuluyorlar. Başka Abonelik türlerine 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 olabilir (push cihazları, e-posta adresleri, telefon numaraları). 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önderilen/alınan/tıklanan olay
subscription_id kullanın.
Eksik olayların sorununu 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ş/çıkış) otomatik olarak gönderilmez. OneSignal SDK’sı, bu olayları izlemek ve Amplitude’a göndermek için kullanabileceğiniz olay dinleyicilerine sahiptir:- User State Observer: Mobile SDK , Web SDK
- Permission Observer: Mobile SDK , Web SDK
OneSignal Subscription ID neden Amplitude’a device_id olarak ekleniyor?
Amplitude, tekilleştirme için birdevice_id bekler. OneSignal bunun için subscription_id kullanır ve bu otomatik olarak device_id’ye eşlenir.
Daha fazla bilgi için Amplitude’un belgelerine bakın.