​

Genel Bakış

Bir Abonelik, kullanıcının mesaj alabileceği belirli bir kanalı temsil eder—örneğin bir e-posta adresi, telefon numarası veya cihaz. OneSignal dört tür Aboneliği destekler:

• E-posta – e-posta mesajları göndermek için
• SMS – metin mesajları göndermek için
• Web Push – web tarayıcıları üzerinden push bildirimleri için
• Mobil – mobil cihazlarda push bildirimleri, uygulama içi mesajlar ve Canlı Etkinlikler için

Her kullanıcının birden fazla Aboneliği olabilir. Tüm Abonelikler genelinde kullanıcıyı tanımlamak için External ID kullanın. Yukarıdaki görselde, “userA” kullanıcısının 5 Aboneliği vardır:

1. Mobil (iOS) iOS uygulaması yüklendikten sonra oluşturuldu. External ID’yi ayarlamak ve Aboneliği kullanıcıya bağlamak için OneSignal.login çağrısı yapın.
2. SMS iOS uygulaması içinde sağlanan telefon numarasından sonra oluşturuldu. Ayrıntılar için aşağıdaki SMS Abonelikleri bölümüne bakın.
3. Web Push web sitesinde push’a abone olduktan sonra oluşturuldu. Push bildirimleri alabilir.
4. E-posta e-posta adresi sağlandıktan sonra oluşturuldu. E-posta mesajları göndermek için.
5. Mobil (Android) Android uygulaması yüklendikten sonra oluşturuldu. Push bildirimleri, uygulama içi mesajlar ve Canlı Bildirimler alabilir.

---

​

Abonelik özellikleri

Her Aboneliğin aşağıdaki özellikleri vardır:

​

Abonelik durumları

Genel olarak, Abonelikler ya mesaj alabilir (Abone) ya da mesaj alamaz (Abonelikten Çıkmış). Ancak bazı istisnalar vardır: Mobil Abonelikler

• Abone: Kullanıcı push bildirimleri almak için izin vermiştir.
  • iOS Geçici push etkinleştirilmişse, tüm iOS mobil Abonelikleri kullanıcı tarafından devre dışı bırakılana kadar Abone durumundadır.
• Abonelikten Çıkmış: Abonelik push bildirimleri alamaz ancak uygulama içi mesajlar alabilir.
  • Daha fazla ayrıntı için Kaldırmaları, abonelikten çıkmaları ve geçersiz push belirteçlerini işleme bölümüne bakın.
• Hiç Abone Olmamış – Kullanıcı hiç izin vermedi (abonelikten çıkmış ile aynı).

Web Abonelikleri

• Abone: Kullanıcı push bildirimleri almak için izin vermiştir.
• Abonelikten Çıkmış: Abonelik push bildirimleri alamaz.
  • Daha fazla ayrıntı için aşağıdaki Abonelikten çıkmaları ve geçersiz push belirteçlerini işleme bölümüne bakın.

E-posta Abonelikleri

• Abone: Kullanıcı e-posta mesajları almak için onay vermiş olmalı ve e-posta adresi geçerli olmalıdır.
• Abonelikten Çıkmış: Kullanıcı e-posta almayı reddetmiş ancak gerekirse geçersiz kılınabilir.
  • Daha fazla ayrıntı için aşağıdaki E-posta Abonelikleri bölümüne bakın.

SMS Abonelikleri

• Abone: Kullanıcı SMS mesajları almak için onay vermiş olmalı ve telefon numarası geçerli olmalıdır.
• Abonelikten Çıkmış: Kullanıcı SMS mesajları almayı reddetmiş.
  • Daha fazla ayrıntı için aşağıdaki SMS Abonelikleri bölümüne bakın.

---

​

notification_types

Aboneliğin mesaj alma yeteneğini, başarısızlık nedenlerini içerecek şekilde gösterir. Frontend SDK’larımız aracılığıyla otomatik olarak veya API aracılığıyla manuel olarak güncellenir. Kullanıcı Görüntüle API’si veya CSV Dışa Aktar aracılığıyla görüntülenebilir.

Notification Types tanımları.

1 veya pozitif sayı = Abone.

• Abonelik bu kanalda mesaj alabilir.
• Kullanıcı adına mesajları etkinleştiriyorsanız enabled özelliği ile kullanılabilir. Push Abonelikleri için, push bildirimleri almak üzere geçerli bir token ayarlanmalıdır. Ayrıntılar için SDK kurulum belgelerimize bakın.

0, -99 = Hiç Abone Olmamış.

• Abonelik henüz kanala abone olmamıştır.

-2 = Abonelikten Çıkmış.

• Abonelik bu kanalda mesaj alamaz.
• Kullanıcı adına mesajları kapatıyorsanız enabled özelliği false olarak ayarlanarak kullanılabilir. Mesaj izinlerini kapatırken önerilen değer.
• Kullanıcı abonelikten çıktığında otomatik olarak ayarlanır.

-3, -5 = Android Destek Kütüphanesi Hatası.Uygulamanızın Android Destek Kütüphanesi’ni ekleyin veya güncelleyin.-4, -8, -11, -12 = Android Google Play Hizmetleri Kütüphanesi Hatası.

• Logcat’i kontrol edin. Hata Ayıklama Günlüğü Alma bölümüne bakın.
• Uygulamanızdaki Google Play Hizmetleri Kütüphanesi’ni yükseltin ve Google Play Hizmetleri hataları için uygulamanın logcat’ini kontrol edin. Hata Ayıklama Günlüğü Alma bölümüne bakın.

-6 = Android Geçersiz Google Proje Numarası.

• FCMv1 Gönderen ID’si, bu token’ın ait olduğu orijinal ile eşleşmiyor. Uygulamanın logcat’ini kontrol edin. Hata Ayıklama Günlüğü Alma bölümüne bakın.

-7, -9 = Android Eski Google Play Hizmetleri Uygulaması

• Cihazdaki Google Play Hizmetleri uygulamasını güncelleyin veya etkinleştirin.

-10 = Abone Değil.

• Push Aboneliği uygulamayı kaldırdı veya cihaz ayarlarından abonelikten çıktı.
• Web push bildirimleri engelledi, tüm verileri ve worker’ları temizledi.

-13 = iOS missing_push_capability.

• Tüm adımların uygulandığından emin olmak için SDK kurulum belgelerini gözden geçirin. Kanal kurulumu bölümüne bakın.

-14, -16, -17 = iOS APNS Hataları.

• Cihazın APNS’ye bağlanırken bir sorunu var. iOS Sorun Giderme kılavuzuna ve Hata Ayıklama Günlüğü Alma bölümüne bakın.

-15 = iOS Simülatör Hatası.

• iOS Simülatörü iOS 16.4+ gerektirir. Farklı bir simülatör veya cihaz kullanın.

-18 = Hiç İstek Gönderilmedi.

• Aboneliğe abone olmak için hiç istek gönderilmedi. Bu yalnızca gerekli izin istemi izler ve uygulama içi mesajları içermez.

-19 = İstek Gönderildi Ancak Hiç Yanıtlanmadı.

• Aboneliğe istek gönderildi ancak yanıt verilmedi.

-20, -21 = temp_web_record. Web, pushSubscriptionchange izni iptal edildi-22 = Pano üzerinden Manuel Olarak Abonelikten Çıkarıldı.

• İzin iptal edildi.

-23, -24 = Web Service Worker Hatası.

• Web SDK sorun giderme bölümüne bakın.

-31 = REST API aracılığıyla Devre Dışı Bırakıldı.-98 = SMS Aboneliği çift onay bekliyor.

---

​

Mobil Abonelikler

Mobil Abonelikler iOS, Android, Huawei veya Amazon cihazlarını temsil eder ve şunları destekler:

• Push bildirimleri
• Uygulama içi mesajlar
• Canlı Etkinlikler

OneSignal SDK ile uygulamanızı yükleyip açtığında otomatik olarak oluşturulurlar.

​

Mobil Abonelikleri güncelleme

Mobil Abonelik özelliklerinin OneSignal mobil SDK aracılığıyla güncellenmesi önerilir.

• Push izinleri iste ve izin/Abonelik değişikliklerini gözlemle
• External ID ve Takma Adlar ayarlamak için Kullanıcı girişi yap
• Etiket ekle
• Dil ayarla

CSV İçe Aktarma özelliği aracılığıyla etiketleri, dili ve diğer bazı özellikleri güncelleyebilirsiniz. Mobil Abonelikler Kullanıcılar ve Abonelikler API’leri aracılığıyla da oluşturulabilir ve güncellenebilir, ancak çoğu kullanım senaryosu için mobil SDK önerilir.

​

Kaldırmaları, abonelikten çıkmaları ve geçersiz push belirteçlerini işleme

Mobil Abonelikler aşağıdaki durumlarda push bildirimleri almayı durdurur:

• Uygulamayı kaldırır
• Cihaz ayarlarında push’u devre dışı bırakır ve uygulamayı bir daha açmaz
• Push belirteci süresi dolar

Bu durumlarda, push bildirimleri gönderilirken Abonelik durumu Abonelikten Çıkmış olarak ayarlanacaktır. Daha fazla ayrıntı için aşağıdaki Push Abonelik durumları ne zaman güncellenir? bölümüne bakın.

• Kullanıcı uygulamayı aynı cihazda veya yeni bir cihazda yeniden yüklerse, yeni bir Abonelik oluşturulacak ve mesaj almak için yeniden abone olmaları gerekecektir.
• Kullanıcı cihaz ayarlarında push’u yeniden etkinleştirirse, uygulamayı açtığında Abonelik durumu Abone olarak ayarlanacak ve push belirteci güncellenecektir.
• Push belirtecinin süresi dolarsa, kullanıcı aynı cihazda uygulamayı açtığında Abonelik durumu ve yeni push belirteci güncellenecektir.

Değişiklikleri şu yollarla takip edin:

• Event Streams - push gönderirken abonelikten çıkmaları tespit edin
• Push raporları - push gönderirken abonelikten çıkmaları tespit edin
• SDK’nın Abonelik değişikliği dinleyicisini kullanın - kullanıcı cihaz ayarlarında push’u devre dışı bıraktıktan sonra uygulamayı açtığında abonelikten çıkmaları tespit edin

---

​

Web push Abonelikleri

Web push Abonelikleri belirli bir cihaza, tarayıcıya ve tarayıcı profiline bağlıdır. Chrome masaüstünde abone olan bir kullanıcı, web sitenize o mobil cihazdan da abone olmadıkça—ayrı bir web push Aboneliği oluşturmadıkça Chrome mobilde push almaz. Yeni web push Abonelikleri şu senaryolarda oluşturulur:

• Kullanıcı tarayıcının sistem düzeyindeki yerel izin istemine “İzin Ver” tıklayarak web sitenize abone olur. Bu benzersiz bir push belirteci ve Abonelik ID’si oluşturur.
• Kullanıcı tarayıcı verilerini (geçmiş, önbellek, çerezler, yerel depolama) temizler ve sitenizi yeniden ziyaret eder. Bu, yeni benzersiz bir Abonelik ID’sinin oluşturulmasına neden olur.

​

Web push Aboneliklerini güncelleme

Web push Abonelik özelliklerinin OneSignal web SDK aracılığıyla güncellenmesi önerilir.

• Push izinleri iste ve izin/Abonelik değişikliklerini gözlemle
• External ID ve Takma Adlar ayarlamak için Kullanıcı girişi yap
• Etiket ekle
• Dil ayarla

CSV İçe Aktarma özelliği aracılığıyla etiketleri, dili ve diğer bazı özellikleri güncelleyebilirsiniz. Web push Abonelikleri REST API aracılığıyla oluşturulamaz ancak Kullanıcılar ve Abonelikler API’leri ile güncellenebilir, ancak çoğu kullanım senaryosu için web SDK önerilir.

​

Abonelikten çıkmaları ve geçersiz push belirteçlerini işleme

Web push Abonelikleri aşağıdaki durumlarda push bildirimleri almayı durdurur:

• Tarayıcı verilerini temizler (geçmiş, önbellek, çerezler, yerel depolama)
• Tarayıcı sistem ayarlarında push’u devre dışı bırakır
• Push belirteci süresi dolar

Bu durumlarda, push bildirimleri gönderilirken Abonelik durumu Abonelikten Çıkmış olarak ayarlanacaktır. Daha fazla ayrıntı için aşağıdaki Push Abonelik durumları ne zaman güncellenir? bölümüne bakın.

• Kullanıcı tarayıcı verilerini temizledikten sonra siteye geri dönerse, yeni bir Abonelik oluşturulacak ve otomatik yeniden abonelik etkinleştirilmişse mesaj almak için otomatik olarak yeniden abone olacaktır.
• Kullanıcı tarayıcı ayarlarında push’u yeniden etkinleştirirse, siteye döndüğünde Abonelik durumu Abone olarak ayarlanacaktır.
• Push belirtecinin süresi dolarsa, kullanıcı siteye döndüğünde Abonelik durumu ve yeni push belirteci güncellenecektir.

Değişiklikleri şu yollarla takip edin:

• Event Streams - push gönderirken abonelikten çıkmaları tespit edin
• Push raporları - push gönderirken abonelikten çıkmaları tespit edin
• SDK’nın Abonelik değişikliği dinleyicisini kullanın - kullanıcı push’u devre dışı bıraktıktan sonra siteye döndüğünde abonelikten çıkmaları tespit edin

---

​

E-posta Abonelikleri

E-posta Abonelikleri e-posta adresine dayalıdır ve yalnızca e-posta teslimatı için kullanılır. Bu, bir Etiket ayarlamaktan farklıdır. E-posta Aboneliklerini şu yollarla oluşturun:

1. SDK addEmail yöntemi veya e-posta istemi - External ID’yi ayarlamak ve Aboneliği kullanıcıya bağlamak için OneSignal.login çağrısından sonra bu yöntemleri kullanın.
2. Kullanıcı oluştur API veya E-posta oluştur API
3. Pano CSV İçe Aktarıcı veya manuel olarak e-posta adresleri ekleyin

​

E-posta Aboneliklerini yönetme

Bir kullanıcıya bağlama E-posta Aboneliklerini bir Kullanıcıya bağlamak için oluştururken external_id ayarladığınızdan emin olun.

• SDK kullanırken, external_id ayarlamak ve e-posta Aboneliğini kullanıcıya bağlamak için addEmail çağrısından önce login yöntemini çağırın.
• CSV İçe Aktarıcı veya REST API kullanırken, e-posta ile birlikte external_id tanımlayıcısını ayarlayın.

Abonelik durumları Yeni oluşturulan e-posta Abonelikleri, aksi belirtilmedikçe otomatik olarak Abone olarak ayarlanacaktır. E-posta Abonelikleri aşağıdaki durumlarda abonelikten çıkmış hale gelebilir:

• E-posta gönderilirken, kullanıcı Abonelikten Çıkma bağlantısı aracılığıyla devre dışı bırakır
• API aracılığıyla enabled değeri false olarak ayarlanır
• Seçenekler düğmesi aracılığıyla panoyu kullanarak Aboneliği abonelikten çıkarır E-posta Abonelikleri şu yollarla yeniden abone hale gelebilir:
• API aracılığıyla enabled değeri true olarak ayarlanır
• Seçenekler düğmesi aracılığıyla panoyu kullanarak Aboneliği abone eder

Bir kullanıcı e-postalardan abonelikten çıkarsa, abonelikten çıkmış e-postalara gönderme ile onları abonelikten çıkmış olarak tutabilir ancak önemli e-postaları gönderebilirsiniz.

---

​

SMS Abonelikleri

SMS Abonelikleri E.164 formatlı telefon numaralarına bağlıdır. Şu yollarla oluşturulur:

1. SDK addSms veya SMS istemi - External ID’yi ayarlamak ve Aboneliği kullanıcıya bağlamak için OneSignal.login çağrısından sonra bu yöntemleri kullanın.
2. Kullanıcı oluştur veya SMS oluştur API
3. CSV İçe Aktarıcı

​

SMS Aboneliklerini yönetme

• Kullanıcı “STOP” veya diğer SMS onay anahtar kelimeleri ile yanıtlayarak abonelikten çıkar
  • Kullanıcı ayrıca “START” veya diğer SMS onay anahtar kelimeleri ile yanıtlayarak yeniden abone olabilir
• API enabled özelliği aracılığıyla Aboneliği güncelleyin

---

​

Abonelikleri içe aktarma veya taşıma

Başka bir sağlayıcıdan push belirteçlerini, e-posta adreslerini ve telefon numaralarını şu yollarla içe aktarın:

• Kullanıcı oluştur API
• Abonelik oluştur API

---

​

Abonelikleri silme

Abonelikler aşağıdaki nedenlerle silinebilir:

• Veri gizliliği
• Etkin olmayan kayıtları temizleme

Ayrıntılar için Kullanıcıları silme bölümüne bakın.

---

​

SSS

​

Push Abonelik durumları ne zaman güncellenir?

Push Abonelik durumları şu durumlarda güncellenir:

1. Kullanıcı uygulamayı açtığında, OneSignal SDK push belirtecinin geçerli olup olmadığını ve bildirim izinlerinin verilip verilmediğini kontrol eder, ardından Abonelik durumunu buna göre günceller.

• Bu olayı SDK Abonelik Gözlemci yöntemlerimizle yakalayabilir ve Veritabanınıza gönderebilirsiniz.

2. Aboneliğe 2+ bildirim gönderdikten sonra. Mesaj gönderirken abonelikten çıkmaları tespit etmek için Event Streams kullanın.

Örnek:

• Mesaj 1: Teslim edildi. Kullanıcı cihazda alıyor, ardından kullanıcı cihaz ayarlarında abonelikten çıkıyor.
• Mesaj 2: Teslim edildi (ancak cihaz almıyor).
• Mesaj 3: Başarısız (abonelikten çıkmış olarak işaretlendi)
• Mesaj 4: Aboneliğe gönderilmedi.

​

Bir kullanıcı cihaz ayarlarında bildirimleri kapatır ve uygulamayı bir daha açmazsa ne olur?

Kullanıcılar cihaz ayarlarında bildirimleri kapattığında o cihazda artık push bildirimleri alamazlar. Cihaza bildirimler gönderildikten sonra abonelikten çıkmış olarak işaretleneceklerdir. Daha fazla ayrıntı için Push Abonelik durumları ne zaman güncellenir? bölümüne bakın.

---