> ## 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: etiketler, özel olaylar ve Conversion Metrics

> Clean Beans örnek uygulamasının mevcut durum için etiketleri, eylemler için özel olayları ve mesajların başarısını ölçmek için Conversion Metrics'i nasıl kullandığı.

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.

Kimlik, OneSignal'a birinin kim olduğunu söyler. Etiketler ve olaylar ise o kişinin nasıl biri olduğunu ve ne yaptığını söyler. Clean Beans, her biri farklı bir iş için olmak üzere üç tür veri kullanır.

| Veri | Neyi tanımlar | Ne için kullanılır |
| - | - | - |
| **Etiketler** | Kullanıcının mevcut durumu | Mesajları kişiselleştirme ve segment oluşturma |
| **Özel olaylar** | Kullanıcının az önce yaptığı bir şey | Journeys'i tetikleme ve dönüşümleri ölçme |
| **Conversion Metrics** | Hangi mesajların bir olaya yol açtığı | Mesajlarınızın neler başardığını raporlama |

## Etiketler: kullanıcının mevcut durumu \\

Oturum açıldıktan sonra, her temizlik oturumundan sonra ve profil düzenlendikten sonra uygulama, Supabase'ten birkaç bilgi toplar ve bunları etiket olarak yazar.

```typescript src/lib/onesignalSync.ts theme={null}
// ── 5. Push tags to OneSignal ────────────────────────────
const tags: Record<string, string> = {
  user_name: profile.name || '',
  streak_count: String(profile.streak_count ?? 0),
  last_clean_ts: lastCleanTs,
  last_room_cleaned: lastRoomCleaned,
  avatar_filename: avatarFilename,
  household_name: householdName,
  weekly_leader: weeklyLeader,
};

OneSignal.User.addTags(tags);
```

| Etiket | Örnek | Tipik kullanım |
| - | - | - |
| `user_name` | `George` | Uygulama içi mesajlarda ve e-postalarda selamlama |
| `streak_count` | `5` | "Devam eden seri" gibi segmentler |
| `last_clean_ts` | `1720454400` | [Zaman operatörleri](https://documentation.onesignal.com/docs/tr/time-operators.md) kullanılarak "7 gündür etkin değil" gibi segmentler |
| `last_room_cleaned` | `Kitchen` | Kişiselleştirilmiş metin |
| `avatar_filename` | `baked_bean.png` | Bir mesajda kullanıcının avatarını gösterme |
| `household_name` | `The Smiths` | Kişiselleştirilmiş metin |
| `weekly_leader` | `George` | Liderlik tablosu mesajları |

> [!NOTE]
>
> Etiket değerleri dizedir. OneSignal'ın zaman operatörlerinin karşılaştırabilmesi için zaman damgalarını Unix saniyesi olarak saklayın.

## Özel olaylar: az önce ne oldu \\

Uygulama, bir temizlik oturumu başladığında bir olay, bittiğinde ise başka bir olay kaydeder.

```typescript src/lib/onesignalSync.ts theme={null}
OneSignal.User.trackEvent('cleaning_session_started', {
  external_id: ctx.external_id,
  user_name: ctx.user_name,
  household_name: ctx.household_name,
  room_name: roomName,
});
```

```typescript src/lib/onesignalSync.ts theme={null}
OneSignal.User.trackEvent('cleaning_session_completed', {
  external_id: ctx.external_id,
  user_name: ctx.user_name,
  household_name: ctx.household_name,
  room_name: roomName,
  tasks_completed: stats.tasksCompleted,
  minutes_cleaned: Math.round(stats.minutesCleaned),
});
```

Tamamlanma olayı `tasks_completed` ve `minutes_cleaned` olmak üzere iki sayı taşır. Bunlar dize olarak değil sayı olarak gönderilir, çünkü Conversion Metrics yalnızca OneSignal'ın sayı olarak gördüğü bir özelliği toplayabilir.

Oturum ekranı, kullanıcı neyi temizlediğini onayladığı anda olayı tetikler ve etiketleri yeniler.

```typescript app/clean-session.tsx theme={null}
// Fire session completed custom event and sync updated tags to OneSignal
if (room) {
  trackSessionCompleted(room.name, { tasksCompleted: ids.length, minutesCleaned: mins }).catch(console.warn);
}
syncOneSignalTags();
```

## Conversion Metrics: mesajlarınızın başardıkları \\

Bir Conversion Metric, özel bir olayı sayar ve onu kendisinden önce gelen mesajlara atfeder. Yukarıdaki olayla Clean Beans, her hatırlatıcının kaç temizlik oturumuna yol açtığını ve bunun toplam kaç dakikalık temizliğe karşılık geldiğini görebilir.

![Temizlik oturumları için dönüşüm metriklerini gösteren bir OneSignal mesaj raporu](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-conversion-metrics.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=fbb4363265a1b330198afdc0a37feefd)

Kendisine atfedilen temizlik oturumlarını ve dakikaları gösteren bir push mesajı raporu.

**Kontrol paneli kurulumu.** **Settings > Analytics > Conversion Metrics** bölümüne gidin ve her satır için bir metrik oluşturun.

| Metrik adı | Özel olay | Bir değer izle | Özellik |
| - | - | - | - |
| Cleaning sessions | `cleaning_session_completed` | Hayır | |
| Minutes cleaned | `cleaning_session_completed` | Evet | `minutes_cleaned` |
| Tasks completed | `cleaning_session_completed` | Evet | `tasks_completed` |

> [!WARNING]
>
> "Track a value for each event" seçeneği yalnızca olay sayı türünde bir özellikle ulaştıktan sonra görünür ve yalnızca metrik oluşturulurken açılabilir. Önce olayı gerçek bir oturumdan gönderin, **Data > Events & Conversions** bölümüne ulaştığını kontrol edin, ardından iki değer metriğini oluşturun.

> [!NOTE]
>
> Conversion Metrics, kullanımdan kaldırılmakta olan Custom Outcomes'ın (`OneSignal.Session.addOutcome()`) yerini alır. Clean Beans başlangıçta Outcomes kullanmayı planlıyordu ve geliştirmeye başlamadan önce geçiş yaptı. Özel metrikler ücretli bir plan gerektirir. Tıklamalar ve uygulama oturumları tüm planlarda izlenir.

> [card] [Etiketler](https://documentation.onesignal.com/docs/tr/add-user-data-tags.md)
>
> Etiket ekleyin, kaldırın ve kullanın.

> [card] [Özel olaylar](https://documentation.onesignal.com/docs/tr/custom-events.md)
>
> SDK'dan veya backend'inizden olay gönderin.

> [card] [Dönüşüm metrikleri](https://documentation.onesignal.com/docs/tr/conversion-metrics.md)
>
> Atıf pencereleri ve raporlama.


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