Ana içeriğe atla
Bu kılavuz, mevcut mesajlaşma platformunuzdan OneSignal’e minimum kesinti ile nasıl geçiş yapacağınızı ele almaktadır. Şunlar için tasarlanmıştır:
  • OneSignal SDK’yı uygulayan Geliştiriciler
  • Kampanyaları ve analitiği yöneten Pazarlamacılar

​
Ön koşullar

Başlamadan önce:

​
Geçiş adımları

​
1. Mevcut mesajlaşma kurulumunuzu denetleyin

Geçişten önce, mevcut uygulamanızın envanterini çıkarın: Geliştiriciler için:
  • 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ı
Pazarlamacılar için:
  • Gönderdiğiniz mesaj türleri (işlemsel, pazarlama, vb.) ve her biri için şablonlar
  • Kullanıcıları nasıl segmentlediğiniz ve hedeflediğiniz
  • İzlediğiniz analitik veya dönüşüm metrikleri

​
2. Terminolojinizi OneSignal ile eşleştirin

Çoğu mesajlaşma platformu benzer kavramları farklı adlar altında paylaşır. OneSignal terimlerinin büyük olasılıkla halihazırda kullandığınız kavramlarla nasıl eşleştiği aşağıda açıklanmaktadır:
Your platformOneSignal termDetails
User / contact / profileUserExternal ID aracılığıyla tanımlanır. Özellikler ve abonelikler içerir.
Push token, email address, phone numberSubscriptionBir kullanıcının mesaj alabileceği kanal (mobil push, web push, e-posta, SMS).
Audience, cohort, listSegmentOrtak özellikler veya davranışlara dayalı dinamik bir kullanıcı grubu.
Custom attribute, user propertyTagHedefleme ve kişiselleştirme için kullanıcıya eklenen anahtar-değer çifti.
Tracked action, analytics eventCustom EventBir kullanıcının gerçekleştirdiği, segmentleme ve mesaj tetiklemede kullanılan eylem.

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

Mobil uygulamanızda ve/veya web sitenizde OneSignal SDK’yı kurun:

Mobil SDK kurulumu

Uygulama içi mesajlar için gereklidir ve iOS ile Android’de push bildirimleri için önerilir.

Web SDK kurulumu

Web push bildirimleri için gereklidir.
SDK’yı entegre ettikten sonra, kullanıcıları tanımlamak ve abonelik verilerini toplamak için aşağıdaki metodları kullanın:
  • login — Bir kullanıcıyı cihazlar ve kanallar arasında tanımlamak için External ID’yi ayarlar.
  • addEmail — Uygulamanızda veya sitenizde toplanan bir adresten e-posta aboneliği oluşturur.
  • addSms — Uygulamanızda veya sitenizde toplanan bir telefon numarasından SMS aboneliği oluşturur.
Uygulama ayrıntıları için SDK referanslarına bakın:

Mobil SDK referansı

login, addEmail, addSms, push token erişimi ve bildirim dinleyicileri için metodlar.

Web SDK referansı

login, addEmail, addSms ve web push olay işleme için metodlar.

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

İki geçiş yolu vardır:
  • Temiz geçiş — Eski SDK’nızı tamamen kaldırın ve tek bir uygulama sürümünde OneSignal ile değiştirin. Bu önerilen yaklaşımdır.
  • Aşamalı geçiş — Her iki SDK’yı geçici olarak tutun ve uygulama sürümüne göre farklı kullanıcı gruplarına her sağlayıcıdan gönderin. Bunu yalnızca eski SDK’yı tek bir sürümde kaldıramıyorsanız kullanın.
Her iki durumda da push token’ları, e-posta adresleri ve telefon numaraları toplamak için eski metodları ve API’leri kaldırın. Özellikle push token toplama, OneSignal SDK ile çakışmalar yaratabilir.

​
Push token çakışmaları ve formatı

Push token’ları üreten tüm eski kodu kaldırın. Yalnızca OneSignal’in push token’ı oluşturmasına izin verin; bu SDK başlatıldığında otomatik olarak gerçekleşir. Gerekirse, token’ı almak ve diğer sağlayıcınıza veya backend’inize göndermek için SDK’mızı kullanın. Bunu yapmak için metodlar:
  • 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
Push token formatları platforma göre farklılık gösterir (iOS APNS ve Android FCM). Ayrıntılar için Push token formatları bölümüne bakın.

​
Firebase Messaging SDK çakışması

Uygulamanız Firebase Messaging SDK’sını (firebase_messaging veya özel bir FirebaseMessagingService) içeriyorsa, bu SDK FCM mesajlarını OneSignal işlemeden önce yakalayabilir. Bu durum, bildirimlerin OneSignal’de “Teslim Edildi” olarak görünmesine ancak cihazda hiç görünmemesine neden olur. Bunu çözmek için:
  • AndroidManifest.xml’den eski Firebase alıcılarını kaldırın.
  • FirebaseMessaging.getToken() veya FirebaseMessaging.deleteToken() çağrısı yapmayın.
  • Push token yaşam döngüsünü yöneten tek SDK’nın OneSignal olduğundan emin olun.
Tam sorun giderme adımları için Firebase Messaging SDK çakışması bölümüne bakın.

​
Push payload işleme

OneSignal’i ve başka bir push sağlayıcısını paralel olarak kullanıyorsanız, tekrarları önlemek için diğer SDK’nızın OneSignal bildirimlerini işlemesini engellemeniz gerekir. OneSignal’in push payload’u, onu diğer sağlayıcılardan ayırt eden rawPayload içinde bir "custom" anahtarı içerir. Her iki SDK de çalışıyorsa, eski SDK’nızın OneSignal bildirimlerini işlememesi için bildirim işleyicinizi bu anahtarı kontrol edecek şekilde güncelleyin. Ayrıntılar için OSNotification payload referansına bakın.

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

Yaygın bir yaklaşım, eski uygulama sürümündeki kullanıcılara eski sağlayıcınızdan, yeni sürümdeki kullanıcılara ise OneSignal’den göndermeye devam etmektir. Ancak her iki SDK’yı sınırlı bir süre tutmanız gerekiyorsa:
  • Push token’larını yalnızca OneSignal’in yönetmesine izin verin. Gerekirse token’ı eski sisteminizle paylaşın (yukarıdaki Push token çakışmaları bölümüne bakın).
  • Eski SDK’nızın OneSignal push’larını yoksayması için payload filtrelerini güncelleyin (yukarıdaki Push payload işleme bölümüne bakın).
  • Eski uygulama sürümündeki kullanıcılara eski sağlayıcınızdan, yeni sürümdeki kullanıcılara OneSignal’den gönderin.
  • Net bir son tarih ve aşamalı çıkış planı belirleyin.

​
5. Web push geçişi

Aynı HTTPS site origin’ini kullanıyorsanız, aboneler bir sonraki ziyaretlerinde sessizce OneSignal’e eklenir — hiçbir istem gösterilmez ve hemen push alabilirler. Web push abonelikleri tarayıcı güvenlik sınırları nedeniyle içe aktarılamaz. OneSignal devralabilmeden önce eski push service worker’larınızın kaydını kaldırmanız gerekir:
  1. Eski SDK kodunu ve Service Worker dosyalarını web sitenizden kaldırın.
  2. Eski Service Worker’ın kaydını kaldırmak için aşağıdaki kod parçacığını ekleyin. sw.js’yi eski sağlayıcınızın 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ş

Aboneleri bir OneSignal uygulamasından (Uygulama A) diğerine (Uygulama B) taşıyorsanız:
  • 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.
Best practice: Yeterli kullanıcının geçiş yaptığını doğruladıktan sonra Uygulama A’dan göndermeyi durdurun. Geçiş ilerlemesini doğrulamak için her iki uygulamadaki abone sayılarını izleyin.

​
6. E-posta ve SMS kurulumu

OneSignal ile e-posta ve/veya SMS gönderiyorsanız, E-posta kurulumu ve SMS kurulumu kılavuzlarımızı takip etmeniz gerekecektir. Mevcut e-posta gönderen alan adınızı OneSignal’e geçirmek DNS kayıtlarını güncellemeyi gerektirir. Gerekirse OneSignal’de birden fazla e-posta gönderici kurabilirsiniz. SMS gönderenleri geçirmek zaman alabilir. Yardıma ihtiyaç duyarsanız support@onesignal.com adresinden bize ulaşın.

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

Son 270 gün içinde uygulamanızda aktif olan abone kullanıcıları içe aktarmak, geçiş sırasındaki kesintileri en aza indirmeye yardımcı olacaktır. Bilinen test kullanıcılarını içe aktararak başlamanızı, ardından uygulama lansmanından önce kalan kullanıcıları içe aktarmanızı öneririz.

​
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 adımları 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. 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. Önce test kullanıcılarını içe aktarın. Doğrulandıktan sonra, sürüm öncesinde kalan kullanıcılar için işlemi tekrarlayın.
Her kullanıcının bir external_id (kimlik) ve en az bir type ile token (veya email/phone_number) içeren aboneliği olması gerekir. Gerekli alanlar, desteklenen abonelik türleri ve örnek payload’lar için Create user API referansına bakın.

​
8. Geçişi test edin

Sorunsuz bir geçiş için kapsamlı test çok önemlidir.
  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.
Geliştirici ve pazarlamacı ekipleri için test senaryoları:
  • 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.
Birden fazla sağlayıcı kullanıyorsanız:
  • 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

Pazarlamacılar için:
  • 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.
Geliştiriciler için:
  • 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ı içe aktarmadıysanız:
  • 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

Geliştiriciler için:
  • Dağıtımdan sonra hata oranlarını ve çökmeleri izleyin.
  • Beklenmeyen token geçersizleştirmelerini izleyin.
  • SDK entegrasyon analitiğini kontrol edin.
Pazarlamacılar için:
  • Uygulama yayın tarihini işaretleyin ve geliştiricilerinizle hangi geçiş yolunun izlendiğini (temiz veya aşamalı) ve kullanıcıların içe aktarılıp aktarılmadığını doğrulayın.
  • Önceki platformunuzda, henüz yeni uygulama sürümüne geçmemiş kullanıcıların bir segmentini oluşturun. Bu gruba eski sağlayıcınızdan göndermeye devam edin, onları güncellemeye teşvik edin.
  • OneSignal’deki abone sayıları sabitlendiğinde önceki sağlayıcıdan göndermeyi durdurun.
  • Aşamalı geçiş uyguluyorsanız, son tarihten sonraki bir sonraki uygulama sürümünde eski sağlayıcının SDK’sını kaldırın.

​
SSS

​
Mevcut push sağlayıcımla OneSignal’i birlikte kullanabilir miyim?

Evet, ancak yalnızca geçici olarak. İki push SDK’yı paralel olarak çalıştırmak token çakışmalarına ve yinelenen bildirimlere neden olabilir. Aşamalı bir geçişe ihtiyaç duyuyorsanız, çakışmaları önlemek ve net bir son tarih belirlemek için Aşamalı geçiş kılavuzunu izleyin.

​
Web push abonelerini içe aktarabilir miyim?

Hayır. Tarayıcı güvenlik kısıtlamaları, web push aboneliklerinin sağlayıcılar arasında aktarılmasını engeller. Sitenize OneSignal’i entegre ettiğinizde, mevcut aboneler bir sonraki ziyaretlerinde sessizce yeniden kaydedilir — yeni bir istem gösterilmez. Web push geçişi bölümüne bakın.

​
Geçişten sonra kullanıcılardan push izni yeniden isteyecek miyim?

Hayır. Kullanıcılar uygulamanıza veya sitenize zaten push izni verdiyse, OneSignal mevcut izni kullanır. Yeni bir istem gösterilmez.

​
E-posta ısınması gerekli mi?

Gönderen alan adınızın yerleşik bir gönderim itibarı varsa gerekli değildir. Isınma yalnızca özel bir IP adresi kullanıyorsanız gereklidir.

​
Özel bir IP adresi alabilir miyim?

Evet, plan türünüze ve gönderim hacminize bağlı olarak. Ayrıntılar için hesap yöneticinizle iletişime geçin.

​
Eski sağlayıcımdan ne kadar süre göndermeye devam etmeliyim?

Çoğu kullanıcı güncellenmiş uygulamayı OneSignal SDK ile açana kadar eski sağlayıcınızdan göndermeye devam edin. Her iki sistemdeki abone sayılarını izleyin ve sayılar sabitlendiğinde eski sağlayıcıdan göndermeyi durdurun.
OneSignal’e başarıyla geçiş yaptınız! Geçiş planlaması hakkında strateji soruları için müşteri başarı ekibimiz kişiselleştirilmiş rehberlik sağlayabilir.
Yardıma mı ihtiyacınız var?Destek ekibimizle sohbet edin veya support@onesignal.com adresine e-posta gönderinLütfen şunları ekleyin:
  • Yaşadığınız sorunun ayrıntıları ve varsa yeniden üretme adımları
  • OneSignal Uygulama Kimliğiniz
  • Varsa Harici ID veya Abonelik ID
  • Varsa OneSignal Panosunda test ettiğiniz mesajın URL’si
  • İlgili günlükler veya hata mesajları
Size yardımcı olmaktan mutluluk duyarız!