OneSignal'e Geçiş

• OneSignal SDK’yı uygulayan Geliştiriciler
• Kampanyaları ve analitiği yöneten Pazarlamacılar

​

Ön koşullar

• OneSignal’da bir hesap oluşturun
• Ekibinizi davet edin

​

Geçiş adımları

​

1. Mevcut mesajlaşma kurulumunuzu denetleyin

• Desteklediğiniz platformlar: iOS, Android, Web, e-posta, SMS, vb.
• Push ve uygulama içi mesaj olaylarını işleyen kod:
  • Ön plan görüntüleme ve tıklama işleme
  • Push, e-posta vb. için deep link kullanımı
  • Push token ve payload işleme
• E-posta adreslerini, telefon numaralarını, push token’larını vb. nasıl topladığınız
• E-posta alan adları ve DNS sahipliği
• SMS gönderenler ve katılım mekanizmaları

• Gönderdiğiniz mesaj türleri: (işlemsel, pazarlama, vb.)
  • Bu mesajlar için şablonlar
• Kullanıcıları nasıl segmentlediğiniz ve hedeflediğiniz
• İzlediğiniz analitik veya dönüşüm metrikleri

​

2. Temel OneSignal kavramları

• Users - External ID aracılığıyla tanımlanır. Kullanıcılar özelliklerden (etiketler, oturum verileri, vb.) ve aboneliklerden (push, e-posta, SMS) oluşur.
• Subscriptions - Bir kullanıcının mesaj alabileceği yolları ifade eder. 4 tür abonelik vardır:
  • Mobile: Push bildirimleri, uygulama içi mesajlar ve Live Activities alabilir.
  • Web push: Web push bildirimleri alabilir.
  • Email: E-posta bildirimleri alabilir.
  • SMS: SMS bildirimleri alabilir.
• Segments - Ortak özellikleri paylaşan bir kullanıcı grubu.
• Tags - Özel bir kullanıcı özelliği.
• Custom Events - Bir kullanıcının gerçekleştirdiği bir eylem.

​

3. OneSignal SDK’yı ekleyin (geliştiriciler)

​

Kullanıcıları External ID ile tanımlayın

• Mobile SDK
• Web SDK

​

Yeni e-postaları ve telefon numaralarını toplayın

• E-posta abonelikleri: Mobile SDK ve Web SDK’da addEmail metodunu kullanın
• SMS abonelikleri: Mobile SDK ve Web SDK’de addSms metodunu kullanın

​

4. Eski uygulamanızı kaldırın

​

Push token çakışmaları ve formatı

• Frontend Mobile SDK’mızı kullanarak cihazın push token tanımlayıcısını alın
• View user API’mizi kullanarak cihazın tanımlayıcısını alın

• iOS Push APNS token formatı: 64 karakter, yalnızca onaltılık karakterler (0-9,a-f). deviceToken.map {String(format: "%02x", $0)}.joined()
• Android Push FCM token formatı: Genellikle 163 karakter, alfanümerik karakterler, tire, iki nokta üst üste ve alt çizgi içerebilir.

​

Push payload işleme

​

Aşamalı geçiş (yalnızca mobil uygulamalar)

• Birden fazla SDK’nın push token’ları oluşturmasına izin vermeyin. OneSignal’in bunu ele almasına izin verin ve gerekirse token’ı eski sisteminizle paylaşın.
  • Frontend SDK veya View user API’yi kullanın
• Payload filtrelerini güncelleyin böylece eski SDK’nız OneSignal push’larını işlemesin.
  • OneSignal, rawPayload’unda bir "custom" anahtarı kullanır (dokümantasyon).
  • Bu anahtarı NotificationCompat’te (Android) kontrol edin.
• Hangi sağlayıcının hangi tür bildirimleri işleyeceğine karar verin.
• Net bir son tarih belirleyin ve eski sistemler için bir aşamalı çıkış planı oluşturun.
  • Gönderdiğiniz her bildirim türü için bir bildirim şablonu oluşturun.
  • Eski sağlayıcınızı uygulamanızın eski sürümündeki kullanıcılara mesaj gönderecek ve OneSignal’i uygulamanızın yeni sürümündeki kullanıcılara mesaj gönderecek şekilde ayarlayın.
  • Belirli kullanıcı gruplarını hedeflemek için segmentler oluşturun.

​

5. Web push geçişi

• Tarayıcı güvenlik sınırları nedeniyle web push aboneliklerini içe aktaramazsınız. OneSignal, kullanıcılar döndüklerinde onları kaydedecektir.
• OneSignal’in devralabilmesi için eski push service worker’larınızın kaydını kaldırmanız gerekir.

1. Eski SDK’yı kaldırın: Web sitesindeki kod ve Service Worker dosyaları.
2. Service Worker’ın kaydının kaldırıldığından emin olmak için bu kodu ekleyin.
3. sw.js’yi 3. taraf Service Worker dosyasının adıyla değiştirin.

if ('serviceWorker' in navigator) {
  navigator.serviceWorker.getRegistrations().then(function(registrations) {
    for (let registration of registrations) {
      if (registration.active.scriptURL.includes("sw.js")) {
        registration.unregister();
      }
    }
  });
}

​

OneSignal uygulamaları arasında geçiş

• Web push abonelikleri uygulamalar arasında doğrudan aktarılamaz. Her abonelik hem sitenizin alan adına (origin) hem de OneSignal App ID’sine bağlıdır.
• Geçiş yapmak için, sitenizin OneSignal başlatma kodunu Uygulama B’nin appId’sini kullanacak şekilde güncelleyin:

OneSignal.init({
  appId: "YOUR_APP_B_ID",
});

• Bir kullanıcı sitenizi yeniden ziyaret ettiğinde, tarayıcının mevcut push izni OneSignal’in onları Uygulama B’ye sessizce kaydetmesine izin verecektir.
• Yeni bir izin istemi görünmeyecektir, ancak aboneliğin Uygulama B’de oluşturulması için kullanıcıların sitenizi en az bir kez ziyaret etmesi gerekir.
• Aboneler, etkin olmayıncaya kadar Uygulama A’da görünmeye devam edecektir.

​

6. E-posta ve SMS kurulumu

​

E-posta ısınması gerekli mi?

​

Özel bir IP adresi alabilir miyim?

​

7. Mevcut kullanıcıları içe aktarın (isteğe bağlı)

​

Platform değerlendirmeleri

• E-posta adresleri aktif ve geçerli kullanıcılardan olmalıdır. Daha önce hiç e-posta tıklamayan veya açmayan e-posta adreslerini içe aktarmayın.
• Telefon numaraları belirli bir formatta olmalı ve kullanıcılar SMS almaya onay vermiş olmalıdır.
• iOS abonelikleri içe aktarmanın hemen ardından push bildirimleri almaya başlayabilir. Bildirim tıklama takibi ve onaylanmış teslimatlar gibi özellikler, SDK’mızın cihazda aktif olmasını gerektirir.
• Android/Huawei/Amazon abonelikleri, bildirim alabilmek için otomatik güncelleme veya manuel güncelleme yoluyla SDK’mızın cihazda aktif olmasını gerektirir.
• Web abonelikleri içe aktarılamaz. Web push geçişi’ndeki yukarıdakileri izlerseniz, web push aboneliği oluşturulacak ve kullanıcı siteye döndüğünde push token SDK’mız aracılığıyla alınacaktır.

​

İçe aktarma adımları

1. Anlamak için Kullanıcılar ve Abonelikler dokümanlarını inceleyin.
2. Eski sistemden test kullanıcı verilerini dışa aktarın.
3. Verileri OneSignal’in Create user API’si için biçimlendirin.
4. Test kullanıcılarını içe aktarın ve başarılı test sonrasında, sürüm öncesi kontrol listesinde tekrarlamak için süreci saklayın.

• token - Push token veya e-posta adresi veya telefon numarası
• type - Abonelik türü: iOSPush, AndroidPush, WebPush, Email, SMS
• external_id - Kullanıcı için benzersiz bir tanımlayıcı. Bu, takip ve analitik için kullanılması önerilir.

  {
    "identity": {
      "external_id": "user_12345"
    },
    "subscriptions": [
      {
        "type": "iOSPush",
        "token": "7abcd49d0affb7426a8f1202420e8f4e2fc4df58e49501adc383f3bd66df8636"
      },
      {
        "type": "AndroidPush",
        "token": "dQGm89TZQXiTvLsRIj_GBo:APA91bpgqFgqkP2qYvV1uW2kdK5Z3TjgCXB_1jkL6VJrgH3hoYn16MvFY19tzDE4OuSgKjYC7itbFpSJYHBfKLWt-xZYBpgCVhYn9K5neV_9-Zj7s9mOSjRUJ2IwEwVSYhR-j5ICF9WB"
      },
      {
        "type": "Email",
        "email": "test@example.com"
      },
      {
        "type": "SMS",
        "phone_number": "+1234567890"
      }
    ]
  }

​

7. Geçişi test edin

1. OneSignal SDK’da Hata Ayıklama Günlüğü’nü etkinleştirin.
2. Tüm platformlar (Android, iOS, Web, vb.) için gerçek cihazlarda test edin.
3. Hem ön plan hem de arka plan bildirim işlemesini doğrulayın.

• OneSignal SDK’yı eklemeden önce OneSignal’den içe aktarılan kullanıcılara test bildirimleri gönderin.
  • iOS’ta push almalısınız ancak onaylanmış teslimat veya tıklama analitiği almayacaksınız.
  • Başka bir push SDK’nız varsa ve henüz Payload işleme gereksinimlerini uygulamadıysanız Android’de push alabilirsiniz. Bildirim muhtemelen veri eksiktir ve tıklandığında beklendiği gibi çalışmaz.
• OneSignal SDK’yı ekledikten sonra OneSignal’den içe aktarılan kullanıcılara test bildirimleri gönderin.
  • Hem Android hem de iOS’ta onaylanmış teslimat ve tıklama analitiği ile birlikte push almalısınız.
• Uygulamanın farklı durumlarında bildirim davranışını test edin.
• Derin bağlantıların ve özel eylemlerin doğru çalıştığını doğrulayın.

• Hem mevcut sağlayıcınızdan hem de OneSignal’den gönderin.
• Yinelenen bildirimleri kontrol edin
• Her sağlayıcının bildirimlerinin doğru görüntülendiğini doğrulayın
• Kullanıcı giriş/çıkış senaryolarını test edin

​

Sürüm öncesi kontrol listesi

• Uygulama güncellemelerini teşvik etmek için bir mesajlaşma planı oluşturun
• Kullanıcıları nazikçe güncellemeye hatırlatmak için eski sisteminizdeki push ve uygulama içi mesajları kullanmayı düşünün.

• Push ve uygulama içi mesaj analitiğinin beklendiği gibi çalıştığını doğrulayın.
  • Tıklama olayları ve onaylanmış teslimatın Android ve iOS’ta izlendiğini kontrol edin.
• Her iki sağlayıcıdan gönderilen mesajlar için tıklama olaylarının ve ön planda alınan olayların doğru işlendiğini doğrulayın.
• Kullanıcıları içe aktarıyorsanız, süresi dolmuş token’ları içe aktarmayı önlemek için son 270 gün içinde uygulamanızda aktif olan Android ve iOS kullanıcılarını dışa aktarın. Ayrıntılar için FCM Süresi Dolmuş Token SSS’ye bakın.

​

Uygulamanızı/sitenizi yayınlayın

• Çoğu kullanıcının uygulamaları otomatik olarak en son sürüme güncellenecektir.
• Kullanıcılar güncellenmiş uygulamanızı açtıklarında, izinler zaten verilmişse—gerekli izin istemlerinden veya uygulamanın bildirim ayarlarından—push bildirimlerine abone olmak için istenmeyeceklerdir.

• Kullanıcılar, uygulamanın güncellenmiş sürümünü açtıklarında otomatik olarak OneSignal’de oluşturulacaktır. Daha önce abone olmuşlarsa push için istenmeyeceklerdir.
• Onlara mesaj gönderebilmeniz için güncellenmiş uygulamayı açmalarını beklemeniz gerekecektir.
• Yeterli kullanıcı OneSignal’de görünene kadar birkaç gün boyunca önceki push sağlayıcısından bildirim ve uygulama içi mesaj göndermeye devam edin. Uygulamayı en son sürüme güncellemelerini isteyen ek uyarılar gönderin.

​

Sonuçları izleyin

• Dağıtımdan sonra hata oranlarını ve çökmeleri izleyin.
• Beklenmeyen token geçersizleştirmelerini izleyin.
• SDK entegrasyon analitiğini kontrol edin.

• Uygulama yayın tarihini işaretleyin.
• Geliştiricilerinizle şunları iletin:
  • Hangi geçiş yolunun alındığı (Temiz veya Aşamalı geçiş).
  • Kullanıcılar içe aktarıldı mı?
• Temiz geçiş uyguluyorsanız:
  • Önceki platformda, aktif olmaya devam eden kullanıcıların bir segmentini veya grubunu oluşturun. Oturum sürelerini, alınan mesajları ve tıklama olaylarını kontrol edin.
  • Yalnızca uygulamayı güncellememiş kullanıcılar aktif olmaya ve bu grupta yer almaya devam etmelidir.
  • Önceki sağlayıcınızdan bu kullanıcılara push ve uygulama içi mesajlar göndermeye devam edin, onları nazikçe güncellemeye teşvik edin.
  • Tamamen OneSignal’e geçmeye hazır olana kadar önceki sağlayıcıdan göndermeyi durdurun.
• Aşamalı geçiş uyguluyorsanız:
  • Önceki platformda, OneSignal’den önceki eski uygulama sürümüne sahip kullanıcıların bir segmentini veya grubunu oluşturun.
  • Önceki sağlayıcınızdan bu eski uygulama kullanıcılarına push ve uygulama içi mesajlar göndermeye devam edin, onları nazikçe güncellemeye teşvik edin.
  • Tamamen OneSignal’e geçmeye hazır olana kadar önceki sağlayıcıdan göndermeyi durdurun.
  • Bir sonraki uygulama sürümünde önceki push sağlayıcısının kodunu kaldırın.