- Mesaj olayları → Amplitude: Tüm kanallar için teslimat, tıklama, başarısızlık ve daha fazlasını takip edin.
- Özel olaylar → OneSignal: Journey’leri veya Segment’leri tetiklemek için Amplitude olaylarını OneSignal’a gönderin.
- Kohortlar → OneSignal: Davranış tabanlı Amplitude kohortlarını OneSignal’da hedefleme filtresi olarak senkronize edin.
Gereksinimler
- Amplitude Hesabı
- OneSignal Ücretli Plan
- Kullanıcılar ve External ID ayarlanmış OneSignal uygulaması.
Kurulum
OneSignal’a Amplitude Ekleme (Çıkış)
OneSignal mesaj olaylarını Amplitude projenize gönderir.- OneSignal’da Veriler > Entegrasyonlar > Katalog bölümüne gidin ve Amplitude’u seçin.
- Ayarlar’ı tıklayın, ardından Çıkış sekmesini açın.
- Amplitude API token’inizi girin, göndermek istediğiniz mesaj olaylarını seçin ve Kaydet’i tıklayın.
Amplitude’da
- Proje API anahtarınızı bulun ve OneSignal’a kopyalayıp yapıştırın.
- Amplitude’un AB sunucularını kullanıyorsanız, Amplitude’un AB Residence Endpoint’ine özel olarak olaylar gönder 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.
Amplitude’a OneSignal Ekleme (Giriş)
Amplitude Destinations’ta OneSignal’ı arayın.
- Cohorts: Kohortları Amplitude’dan OneSignal’a senkronize eder.
- Events User Properties: Özel olayları Amplitude’dan OneSignal’a gönderir.
Hem kohort senkronizasyonu hem de özel olayları kullanmayı planlıyorsanız, her iki OneSignal hedefini de ekleyin. Her hedef Amplitude’da ayrı ayrı yapılandırılır, bu yüzden her biri için OneSignal kimlik bilgilerinizi girmeniz gerekir.
User ID eşleştirmesi
OneSignal’daki External ID, seçtiğiniz Amplitude kullanıcı özelliğiyle eşleşmelidir (örneğinuser_id). Bu özelliğin her iki sistemde de dolu olduğunu doğrulayın — kohort senkronizasyonu ve olay takibi tam eşleşmeye bağlıdır.
Ek özellikler
OneSignal’da özel olaylara eklenecek ek özellikler ekleyebilirsiniz. Bu, koşullu olay işleme için kullanışlı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.
- 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."mesajını görmelisiniz.
- OneSignal’da Veriler > Özel Olaylar bölümüne gidin ve listede test olayının göründüğünü doğrulayın.
Amplitude kohortlarını OneSignal’a dışa aktarma
Yukarıda yapılandırılan eşleşen External ID’yi kullanarak Amplitude kohortlarını OneSignal’a senkronize edin. Dışa aktarma kullanıcı oluşturmaz — her Kullanıcının OneSignal’da zaten mevcut olması gerekir.- 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 Segment oluşturma
Senkronize edilen kohort, Amplitude Segment filtresi olarak görünür. OneSignal, aşağıdaki koşullar sağlandığında kohort için otomatik olarak bir Segment oluşturur:- 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’da mesaj olaylarını takip etme
OneSignal, aşağıdaki mesaj olaylarını Amplitude’a gerçek zamanlı olarak gönderir. Hangi olayları göndereceğinizi Veriler > Entegrasyonlar > Amplitude > Çıkış bölümünde seçin.| 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 Delivered | 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
OneSignal’dan Amplitude’a gönderilen tüm olaylar bu özellikleri içerir:| 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 verilerim 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.
İlgili sayfalar
Analizlere genel bakış
OneSignal analizleri, teslimat metrikleri ve olay takibine genel bakış.
Özel olaylar
Journey’leri tetiklemek veya analizleri güçlendirmek için kullanıcı eylemlerini takip edin.
Need help?Chat with our Support team or email
support@onesignal.comPlease include:- Details of the issue you’re experiencing and steps to reproduce if available
- Your OneSignal App ID
- The External ID or Subscription ID if applicable
- The URL to the message you tested in the OneSignal Dashboard if applicable
- Any relevant logs or error messages