Ana içeriğe atla
Bu sayfa, gerçek bir uygulamayı baştan sona takip eden Örnek uygulama: eksiksiz bir OneSignal entegrasyonu kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan Clean Beans’tir ve Expo (React Native) ile bir Supabase backend’i kullanılarak geliştirilmiştir. Bir push’un ulaşmasını sağlamak ilk adımdır. Bu sayfa, push’ları güvenilir kılan daha küçük kararları ele alır: aynı push’u asla iki kez göndermemek, eskiyenlerin süresinin dolmasına izin vermek ve her türün kendine uygun şekilde davranmasını sağlamak.

Aynı hatırlatıcıyı asla iki kez göndermeyin \

Zamanlanmış işler yeniden denenir. Bir iş yanlışlıkla iki kez de çalışabilir. Koruma olmadan her tekrar bir push daha gönderir. OneSignal’ın idempotency_key alanı bu sorunu çözer. İki istek aynı anahtarı taşıyorsa ikincisi gönderilmez. Anahtar bir UUID olmalıdır ve OneSignal onu 30 gün boyunca hatırlar. Zamanlanmış bir fonksiyonun çalıştırmalar arasında rastgele bir anahtar saklayacağı bir yer yoktur. Bu yüzden Clean Beans anahtarı gönderimin ne olduğundan türetir: türü, alıcısı ve tarihi. Aynı gönderim her zaman aynı anahtarı üretir.
supabase/functions/_shared/idempotency.ts
Grup halinde gönderimde anahtar tüm grubu kapsar.
supabase/functions/send-cleaning-reminder/index.ts
Idempotency anahtarları Create message ve Create custom events uç noktalarında çalışır. Live Activity istekleri bunları kabul etmez. Bunlar activity_id ile tanımlanır.

Her push türüne kendi davranışını verin \

İki saat geç gelen bir temizlik hatırlatıcısı, hiç hatırlatıcı gelmemesinden daha kötüdür. Kudos almak güzeldir ama asla acil değildir. Clean Beans bu farklılıkları bir kez, bir dizi teslimat profilinde tanımlar ve doğru profili her isteğe ekler.
supabase/functions/_shared/delivery.ts
Tür listesindeki member_lapsed profili, bir Journey webhook’undan gönderilen bir push’a aittir ve bu kılavuzda ele alınmaz. Her ayarın yaptığı:
  • ttl, çevrimdışı bir cihaz için push’un ne kadar süre bekletileceğidir. Temizlik hatırlatıcısı “1 saat içinde” dediği için bir saat sonra bırakılır.
  • thread_id ve android_group, ilgili push’ları bildirim listesinde birlikte gruplar.
  • ios_interruption_level, bir push’un ne kadar ısrarcı olduğunu kontrol eder. time_sensitive Odak modlarını aşabilir. passive sessizce gelir.
  • ios_relevance_score, iOS bildirim özetinde push’ları sıralar. Clean Beans 1.0 değerini kritik mesajlar için ayırır ve hiç kritik mesaj göndermez.
Uygulama kurulumu. iOS, time_sensitive değerine yalnızca uygulama bu capability’yi bildirirse uyar.
app.json
Öğrenilen bir ders: collapse_id. Clean Beans önce özete ve gecikmiş görev hatırlatıcısına aynı collapse_id değerini verdi, böylece hatırlatıcı özetin yerini alacaktı. iOS’ta, bildirim listesinde hâlâ duran bir push’un yerini alan push, banner ve ses olmadan yerinde değiştirilir. Hatırlatıcı fark edilmedi ve amacına ulaşamadı, bu yüzden ayar kaldırıldı. collapse_id değerini yalnızca canlı skor gibi sessiz bir güncelleme istediğinizde kullanın.

Uygulama simgesinde sayı gösterin \

İki görev push’u, uygulama simgesi rozetini başlıklarındaki sayıya ayarlar.
supabase/functions/send-overdue-reminders/index.ts
Rozet sayısı olan Clean Beans uygulama simgesi

Uygulama simgesi rozeti kaç görevin geciktiğini gösterir.

Increase yerine SetTo kullanılır, çünkü rozet okunmamış bildirimlerin değil görevlerin sayısıdır. Öğleden sonraki hatırlatıcı sabahki sayının yerini alır.
OneSignal SDK’sı uygulama her açıldığında rozeti otomatik olarak temizler, bu yüzden uygulamanın onu sıfırlamak için koda ihtiyacı yoktur. Uygulama açıkken gelen bir push rozetini asla göstermez. Android’de API ile ayarlanabilecek sayısal bir rozet yoktur.

Idempotent istekler

Anahtarların nasıl çalıştığı ve ne kadar süre geçerli olduğu.

Kesinti seviyeleri

Odak modları ve dört seviye.

Rozetler

Her platformda rozet davranışı.