Abonelikler

​

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: 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ı etkinlikler 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ış). Ayrıntılar kanala göre değişir:

---

​

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 (örneğin, +14155551234). Şu yollarla oluşturulur:

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

​

SMS Aboneliklerini yönetme

Bir kullanıcıya bağlama SMS Aboneliklerini bir Kullanıcıya bağlamak için oluştururken external_id ayarlayın.

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

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

• Kullanıcı “STOP” veya diğer opt-out anahtar kelimesiyle yanıtlar
• API aracılığıyla enabled değerini false olarak ayarlarsınız
• Pano aracılığıyla seçenekler düğmesiyle Aboneliği abonelikten çıkarırsınız

SMS Abonelikleri şu yollarla yeniden abone hale gelebilir:

• Kullanıcı “START” veya diğer opt-in anahtar kelimesiyle yanıtlar
• API aracılığıyla enabled değerini true olarak ayarlarsınız
• Pano aracılığıyla seçenekler düğmesiyle Aboneliği yeniden abone edersiniz

---

​

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

---

​

SSS

​

Push abonelik durumları ne zaman güncellenir?

Push abonelik durumları iki mekanizma aracılığıyla güncellenir: 1. Kullanıcı uygulamanızı veya sitenizi açtığında OneSignal SDK, push belirtecinin geçerli olup olmadığını ve bildirim izinlerinin hâlâ verilip verilmediğini kontrol eder, ardından abonelik durumunu hemen günceller. Örneğin, bir kullanıcı cihaz ayarlarında push bildirimlerini devre dışı bırakır ve ardından uygulamanızı yeniden açarsa, SDK değişikliği algılar ve aboneliği hemen Abonelikten Çıkmış olarak işaretler. Bu değişiklikleri SDK’nın Abonelik Gözlemcisi (mobil | web) ile yakalayarak kendi veritabanınızla senkronize edebilirsiniz. 2. Push bildirimleri gönderdiğinizde Bir kullanıcı uygulamanızı kaldırır, tarayıcı verilerini temizler veya push’u devre dışı bırakır ve hiç geri dönmezse, OneSignal bir bildirim gönderene kadar değişikliği algılayamaz. Push hizmeti (FCM, APNs, HMS) belirteci geçersiz olarak bildirir ve OneSignal aboneliği Abonelikten Çıkmış olarak işaretler. Bu algılama genellikle 2 veya daha fazla mesaj gerektirir çünkü push hizmeti geçersiz bir belirteci hemen reddetmez: Mesaj gönderirken abonelikten çıkmaları gerçek zamanlı olarak algılamak için Event Streams kullanın.

​

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

Abonelik, o cihaza bir bildirim gönderene kadar OneSignal’de Abone olarak kalır. 2 veya daha fazla gönderim denemesinden sonra, push hizmeti belirteci geçersiz olarak bildirir ve OneSignal aboneliği Abonelikten Çıkmış olarak işaretler. Tam sıra için yukarıdaki Push abonelik durumları ne zaman güncellenir? bölümüne bakın.

---

​

İlgili sayfalar