Amplitude

OneSignal’ı Amplitude ile entegre ederek push, uygulama içi, e-posta ve SMS genelinde gerçek zamanlı, davranış tabanlı hedefleme sağlayın. Bu uygulama düzeyinde entegrasyon üç veri akışını destekler:

• 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.

1. OneSignal’da Veriler > Entegrasyonlar > Katalog bölümüne gidin ve Amplitude’u seçin.
2. Ayarlar’ı tıklayın, ardından Çıkış sekmesini açın.
3. Amplitude API token’inizi girin, göndermek istediğiniz mesaj olaylarını seçin ve Kaydet’i tıklayın.

​

Amplitude’da

1. Proje API anahtarınızı bulun ve OneSignal’a kopyalayıp yapıştırın.
2. 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.com görüyorsanız, Amplitude’un AB sunucularını kullanıyorsunuz demektir.

​

Amplitude’a OneSignal Ekleme (Giriş)

Amplitude Destinations’ta OneSignal’ı arayın. Amplitude, katalogda iki OneSignal hedef türü sağlar:

• Cohorts: Kohortları Amplitude’dan OneSignal’a senkronize eder.
• Events User Properties: Özel olayları Amplitude’dan OneSignal’a gönderir.

​

User ID eşleştirmesi

OneSignal’daki External ID, seçtiğiniz Amplitude kullanıcı özelliğiyle eşleşmelidir (örneğin user_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.

---

​

Özel olayları test etme

1. Amplitude > OneSignal Events Destination bölümünde Test Connection butonuna tıklayın.

2. Payload’daki "user_id"’nin OneSignal Uygulamanızdaki mevcut bir Kullanıcının External ID’sine ayarlı olduğundan emin olun.
3. Send Test Event butonuna tıklayın.
4. Response kutusu boş kalmalı ve "OneSignal has successfully received test event." mesajını görmelisiniz.

5. 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.

1. Amplitude’da bir kohort oluşturun. Amplitude’un kohortlar hakkındaki belgelerine bakın.
2. Sync butonuna tıklayın ve hedef olarak OneSignal’ı seçin.
3. 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.

​

Olay özellikleri

OneSignal’dan Amplitude’a gönderilen tüm olaylar bu özellikleri içerir:

---

​

SSS

​

Kohort ve segment sayılarım neden eşleşmiyor?

1. 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.
2. 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.

Örneğin, bir Amplitude kohortu 10 kullanıcıya sahipse ancak OneSignal segmenti 8 Abonelik gösteriyorsa, eksik 2 kullanıcı:

• OneSignal’da mevcut olmayabilir veya yanlış External ID’ye sahip olabilir.
• Abonelikten çıkmış aboneliklere sahip olabilir.

Doğrulamak için, kullanıcıların var olup olmadığını ve aktif aboneliklere sahip olup olmadığını görmek için OneSignal’daki Audience > Users sekmesini kontrol edin.

​

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

Tam kaynağı izlemek için olay özelliklerinde 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 bir device_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

---