> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Örnek uygulama: güvenilir ve doğru davranan push

> Clean Beans örnek uygulamasının idempotency anahtarlarıyla yinelenen push'ları nasıl önlediği, her push türü için teslimatı nasıl ayarladığı ve uygulama simgesi rozetlerini nasıl belirlediği.

Bu sayfa, gerçek bir uygulamayı baştan sona takip eden [Örnek uygulama: eksiksiz bir OneSignal entegrasyonu](https://documentation.onesignal.com/docs/tr/example-full-integration-overview.md) 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.

```typescript supabase/functions/_shared/idempotency.ts theme={null}
/** Name-based UUID (version 5) per RFC 9562. */
export async function uuidV5(name: string, namespace: string): Promise<string> {
  const ns = uuidToBytes(namespace);
  const nameBytes = new TextEncoder().encode(name);
  const input = new Uint8Array(ns.length + nameBytes.length);
  input.set(ns);
  input.set(nameBytes, ns.length);

  const digest = new Uint8Array(await crypto.subtle.digest('SHA-1', input));
  const bytes = digest.slice(0, 16);
  bytes[6] = (bytes[6] & 0x0f) | 0x50; // version 5
  bytes[8] = (bytes[8] & 0x3f) | 0x80; // RFC variant

  const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('');
  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
}

export function idempotencyKey(...parts: string[]): Promise<string> {
  return uuidV5(parts.join(':'), CLEAN_BEANS_NAMESPACE);
}
```

| Push | Anahtarın oluşturulduğu öğeler | Sonuç |
| - | - | - |
| Günlük özet | tür, kullanıcı kimliği, kullanıcının yerel tarihi | Kullanıcı başına günde bir özet |
| Gecikmiş görev hatırlatıcısı | tür, kullanıcı kimliği, kullanıcının yerel tarihi | Kullanıcı başına günde bir hatırlatıcı |
| Temizlik hatırlatıcısı | tür, saat, sıralanmış alıcı kimlikleri | Saatlik çalıştırma başına grup başına bir hatırlatıcı |
| Haftalık e-posta | tür, hane kimliği, çalıştırma tarihi | Çalıştırma başına hane başına bir e-posta |
| Katılım onaylandı | tür, kullanıcı kimliği, hane kimliği, onay zamanı | Onay başına bir push |

Grup halinde gönderimde anahtar tüm grubu kapsar.

```typescript supabase/functions/send-cleaning-reminder/index.ts theme={null}
const batchKey = await idempotencyKey(
  'upcoming_cleaning',
  utcHourSlot(now),
  [...batch].sort().join(','),
);
```

> [!NOTE]
>
> 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.

```typescript supabase/functions/_shared/delivery.ts theme={null}
export const DELIVERY: Record<
  'daily_digest' | 'overdue_reminder' | 'upcoming_cleaning' | 'session_completed' | 'kudos' | 'join_approved' | 'member_lapsed',
  DeliveryProfile
> = {
  // Morning digest. Expires after 6h — by then the overdue nudge has taken
  // over. Grouped with the nudge under the same thread.
  daily_digest: {
    ttl: 6 * HOUR,
    thread_id: 'tasks',
    android_group: 'tasks',
    ios_interruption_level: 'active',
    ios_relevance_score: 0.6,
  },

  // Afternoon nudge. Arrives as its own alert, grouped with the digest.
  overdue_reminder: {
    ttl: 6 * HOUR,
    thread_id: 'tasks',
    android_group: 'tasks',
    ios_interruption_level: 'active',
    ios_relevance_score: 0.8,
  },

  // "Cleaning time in 1 hour". Only meaningful until the window starts,
  // so it expires after 1h. Time-sensitive: it is tied to a time the user
  // scheduled themselves, so it may break through Focus modes.
  upcoming_cleaning: {
    ttl: 1 * HOUR,
    thread_id: 'schedule',
    android_group: 'schedule',
    ios_interruption_level: 'time_sensitive',
    ios_relevance_score: 0.9,
  },

  // ...
};
```

| Push | Çevrimdışı cihaz için saklanma süresi | Gruplandığı yer | iOS kesinti seviyesi | İlgililik |
| - | - | - | - | - |
| Günlük özet | 6 saat | `tasks` | Active | 0.6 |
| Gecikmiş görev hatırlatıcısı | 6 saat | `tasks` | Active | 0.8 |
| Temizlik hatırlatıcısı | 1 saat | `schedule` | Time Sensitive | 0.9 |
| Oturum tamamlandı | 24 saat | `household` | Active | 0.4 |
| Kudos | 3 gün | `household` | Passive | 0.7 |
| Katılım onaylandı | 3 gün | `household` | Active | 0.8 |

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.

```json app.json theme={null}
{
  "expo": {
    "ios": {
      "entitlements": {
        "com.apple.developer.usernotifications.time-sensitive": true
      }
    }
  }
}
```

> [!WARNING]
>
> **Öğ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.

```typescript supabase/functions/send-overdue-reminders/index.ts theme={null}
// App icon badge = number of overdue tasks. The OneSignal SDK clears the
// badge automatically the next time the app is opened.
ios_badgeType: 'SetTo',
ios_badgeCount: taskCount,
```

![Rozet sayısı olan Clean Beans uygulama simgesi](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-badge.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=08c9bc46b557e4e15819cd0ec42488cf)

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.

> [!NOTE]
>
> 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.

> [card] [Idempotent istekler](https://documentation.onesignal.com/reference/idempotent-notification-requests.md)
>
> Anahtarların nasıl çalıştığı ve ne kadar süre geçerli olduğu.

> [card] [Kesinti seviyeleri](https://documentation.onesignal.com/docs/tr/ios-focus-modes-and-interruption-levels.md)
>
> Odak modları ve dört seviye.

> [card] [Rozetler](https://documentation.onesignal.com/docs/tr/badges.md)
>
> Her platformda rozet davranışı.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.