> ## 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.
# Live Activities
> Kilit ekranına ve Dynamic Island'a doğrudan gerçek zamanlı güncellemeler sunmak için OneSignal ile iOS Live Activities'i nasıl kullanacağınızı öğrenin. Spor skorları, teslimatlar ve daha fazlası gibi etkinlikler için sorunsuz takibi etkinleştirin.
Live Activities, iOS ve iPadOS uygulamalarınızın Kilit Ekranı ve Dynamic Island'a gerçek zamanlı güncellemeler sunmasına olanak tanıyarak kullanıcıları uygulamayı açmaya gerek kalmadan bilgilendirir. iOS 16.1'de tanıtılan ve iOS 17'ye genişletilen Live Activities, teslimat takibi, oyun skorları veya transit güncellemeleri gibi zamana duyarlı bilgiler için mükemmeldir.
Live Activities bir iOS özelliğidir, ancak [Android Live Notifications](./android-live-notifications) ile benzer yetenekler elde edebilirsiniz.
***
## Live Activities neden kullanılır?
Live Activities, gerçek zamanlı, işlemsel veya zamana bağlı güncellemeler için harikadır.
* 8 saate kadar görünür
* Geçici — ilk Live Activity'yi göstermek için izin gerekmez
* Kilit Ekranı ve Dynamic Island gibi premium cihaz yüzeylerinde oldukça ilgi çekici ve görünür
[Blogumuzdaki kullanım durumları hakkında daha fazla bilgi edinin →](https://onesignal.com/blog/new-live-activities-support-to-help-you-drive-loyalty-faster)
***
## OneSignal neden kullanılır?
OneSignal, Live Activities'i şunları yöneterek basitleştirir:
* Geçici push token yönetimi
* Tek bir API çağrısıyla milyonlarca cihaza ölçekleme
* Gerçek zamanlı analitik ve performans içgörüleri
* Push, E-posta, SMS ve Uygulama İçi Mesajlarla çapraz kanal orkestrasyonu
Live Activities, 10.000'den fazla katılmış aboneye sahip Ücretsiz planlar hariç tüm planlarda mevcuttur. [Fiyatlandırmaya bakın](https://onesignal.com/pricing) veya yardım için `support@onesignal.com` ile iletişime geçin.
***
## Live Activities ile başlarken
### Gereksinimler
* iOS 16.1+ veya iPadOS 17+
* OneSignal [Mobile SDK entegre edildi](./mobile-sdk-setup)
* [Live Activities Geliştirici Kılavuzumuz](./live-activities-developer-setup)'a göre kurulum tamamlandı
* Tıklama takibi ve Onaylanmış Teslimat için iOS SDK sürümü **5.2.15 veya üzeri** gereklidir
### Live Activities nasıl çalışır
* **Görünür Süre**: 8 saate kadar aktif ([ Update Live Activity API](/reference/update-live-activity-api)'deki `dismissal_date` parametresi kullanılarak kaldırılabilir).
* **İzin Gerekmez**: İlk activity geçicidir; gelecekler kullanıcı ayarlarına bağlıdır.
* **Limit**: Uygulamada aynı anda en fazla 5 Live Activity.
* **Uzaktan Başlatma**: iOS 17.2+'dan itibaren push aracılığıyla desteklenir.
* **Tanıtım Dışı Kullanım**: Kullanıcıya değer sağlamalıdır—reklamlar için tasarlanmamıştır.
### Bir Live Activity oluşturma ve güncelleme
Live Activities 2 şekilde başlatılabilir:
1. [Start Live Activity API](/reference/start-live-activity)'mizi yani "push-to-start"'ı kullanarak.
2. Uygulama içinde tetikleyerek ([Live Activities Geliştirici Kurulumu](./live-activities-developer-setup)).
[Update Live Activity API](/reference/update-live-activity-api)'yi kullanın ve ilişkili tüm cihazları güncellemek için `activity_id`'yi iletin.
Live Activities aşağıdaki şekillerde sona erebilir:
* Belirli bir `activityId` için güncelleme göndermeyi durdurmak üzere OneSignal sunucusuna bir istek gönderir.
* Live Activity'yi ekrandan **kaldırmaz**. 4 saat sonra veya kullanıcı eylemi ile otomatik olarak kaldırılacaktır.
Daha fazla güncellemeyi durdurmak için `event: end` alanını kullanın ve Live Activity'yi ekrandan kaldırmak için bir `dismissal_date` ekleyin:
* Live Activity, 4 saat sonra veya kullanıcı eylemi ile ekrandan otomatik olarak kaldırılacaktır.
* Daha erken kaldırmak için sonraki 4 saat içinde **gelecek** bir `dismissal_date` zamanı ayarlayın.
* Kullanıcının ekranından hemen kaldırmak için **geçmiş** bir `dismissal_date` zamanı ayarlayın. Live Activity'nin programatik olarak kaldırılması için kullanıcının "Allow"a tıklamış olması gerekir.
* Kullanıcı Live Activity'yi manuel olarak kapatır, örneğin kaydırarak.
* Kullanıcı iOS Ayarlarında Live Activity iznini iptal eder.
SDK metodu Live Activity'yi görsel olarak kapatmaz.
* Geliştiriciler API'yi `dismissal_date` ile veya yerel iOS metodlarını (örn. `activity.end(dismissalPolicy: .immediate)`) kullanmalıdır.
* Live Activity'nin programatik olarak kaldırılması için kullanıcının "Allow"a tıklamış olması gerekir.
***
## Analiz ve raporlama
OneSignal, Live Activities'inizin performansını ölçmenize ve optimize etmenize yardımcı olan kapsamlı analizler sağlar. Teslimat oranları, tıklamalar, başarısızlıklar ve abonelik değişiklikleri gibi önemli metrikleri izleyin.
**Mevcut temel metrikler:**
* **Gönderildi**: OneSignal'dan Apple Push Notification servisi'ne (APNs) gönderilen Live Activities
* **Onaylanmış Teslimat**: Cihazlara teslim edildiği onaylanan Live Activities (iOS SDK 5.2.15+ gerektirir)
* **Başarısız**: Teslim edilemeyip başarısız olan Live Activities
* **Abonelik İptal Edildi**: Kullanıcılar Live Activities'i reddettiğinde veya devre dışı bıraktığında abonelik iptal edildi olarak işaretlenen abonelikler
* **Tıklandı**: Tüm Live Activities'teki toplam tıklama sayısı
Mesaj raporları, kitle aktivitesi, veri dışa aktarımı ve performans analizi hakkında ayrıntılı bilgi için [Live Activities Analiz kılavuzumuza](./live-activities-analytics) bakın.
***
## En iyi uygulamalar ve yönergeler
### İşlevsellik
* Live Activities'i işlemsel veya bağlamsal güncellemeler için kullanın (örn. ETA, skor, zamanlayıcı).
* Kullanıcılar durumları veya değişiklikleri kontrol etmek için sürekli uygulamanıza gitmek yerine, telefonlarına bir bakışta güncellemeler alabilirler.
* Tanımlanmış bir başlangıç ve sonu olan olaylar veya görevler. Reklam görüntülemek veya tamamen promosyon amaçlı hizmet vermek için Live Activity kullanmayın. Ne değer sağlıyorsunuz?
* Cihaz pilini korumak için aşırı güncellemelerden kaçının.
* Bir Live Activity'nin 8 saatten uzun olmayan bir olay veya görev için olduğundan ve yalnızca kullanıcıya faydalı olduğu sürece gösterildiğinden emin olun.
### UI/UX
* Tüm Live Activity sunumlarını destekleyin: Compact, Minimal, Expanded, Lock Screen.
* Marka, boşluk ve koyu/açık temaları doğru kullanın.
* Netlik ve dokunma hedeflerine öncelik verin. Dynamic Island'a dikkat çekmeye çalışmayın.
* Bir Live Activity'de hassas bilgileri görüntülemekten kaçının.
Live Activities için en iyi uygulamalar hakkında daha fazla bilgi için Apple'ın [Live Activities İnsan Arayüzü Yönergelerine](https://developer.apple.com/design/human-interface-guidelines/live-activities) bakın.
### Hedefleme ve ölçekte gönderme
Bir Live Activity'nin beklendiğinde göründüğünden emin olun, genellikle bir kullanıcı bir eylem gerçekleştirdiğinde (örn. bir olayı takip etmek için) veya güncellemeleri kontrol etmek için uygulamayı açtığında (örn. güncellenmiş teslimat zamanı).
* Spor oyunları, konserler veya diğer canlı etkinlikler gibi olaylar için kullanıcı segmentlerini hedefleyin.
* Kişisel veya işlemsel olaylar için bireysel kullanıcıları hedefleyin.
Kullanıcıları nasıl hedefleyeceğiniz hakkında ayrıntılar [OneSignal API belgeleriyle mesaj gönderme](reference/create-message)'de bulunabilir.
Live Activities'i güncellerken, Apple'ın güncellemenin ne kadar acil olduğunu belirlemek için kullandığı bir "öncelik" ayarlama seçeneğiniz vardır. Apple'ın yüksek öncelik bayrağını çok sık kullanan istekleri kısıtlayacağı dahili eşikleri vardır. Bu dahili eşik nedeniyle, Apple kısıtlamayı önlemek için normal ve yüksek önceliğin karışımını seçmeyi önerir. Önceliğin nasıl ayarlanacağına ilişkin ayrıntılar [Update Live Activity API referansımızda](/reference/update-live-activity-api) bulunabilir.
Kullanım durumunuz daha sık yüksek öncelikli güncellemelere dayanıyorsa, [Apple'ın Geliştirici Belgelerinde](https://developer.apple.com/documentation/activitykit/starting-and-updating-live-activities-with-activitykit-push-notifications#Determine-the-update-frequency) yönlendirildiği gibi Info.plist dosyanıza `NSSupportsLiveActivitiesFrequentUpdates` anahtarını Boolean türünde YES olarak ayarlanmış şekilde ekleyebilirsiniz. Live Activity push bütçesini aştığında kullanıcılara bir diyalog sunulacak ve Live Activity'nin devam etmesine izin verirlerse, sorunsuz bir kullanıcı deneyimi için bütçe otomatik olarak artırılacaktır.
***
## SSS
### Planımda Live Activities'e erişimim var mı?
Live Activities, 10.000'den fazla katılmış aboneye sahip Ücretsiz planlar hariç tüm planlarda mevcuttur. Ücretsiz Planda 10.000'den fazla katılmış aboneniz varsa, Live Activities'i kullanmak için yükseltme yapabilirsiniz. [Fiyatlandırmaya bakın](https://onesignal.com/pricing) veya yardım için `support@onesignal.com` ile iletişime geçin.
### Yüksek öncelikli güncellemeler için bütçe nedir?
Apple, yüksek öncelikli (`priority: 10`) güncellemeler için sabit bir sınır sağlamaz, ancak dinamik bir sistem düzeyinde bütçe uygularlar. Kısa bir süre içinde çok fazla yüksek öncelikli güncelleme göndermek, güncellemelerin geciktirildiği veya düşürüldüğü kısıtlamaya neden olabilir.
Kısıtlama riskini azaltmak için:
* Öncelik düzeylerinin karışımını kullanın: Apple, denge için hem `priority: 5` (standart) hem de `priority: 10` (yüksek) kullanılmasını önerir.
* `priority: 10`'u yalnızca zamana duyarlı veya kritik güncellemeler için ayırın (örn. sipariş durumu değişiklikleri, oyun skorları).
Kullanım durumunuz sık güncellemeler gerektiriyorsa:
* Uygulamanızın `Info.plist` dosyasına `NSSupportsLiveActivitiesFrequentUpdates` anahtarını Boolean `YES` olarak ayarlanmış şekilde ekleyin.
* Bu bütçe aşıldığında, iOS kullanıcıdan ek güncellemelere izin vermesini isteyebilir. Kullanıcı kabul ederse, Apple sorunsuz bir deneyim sürdürmek için izin verilen güncelleme sınırını otomatik olarak genişletecektir.
Daha fazla ayrıntı için [Apple'ın Geliştirici Belgelerine](https://developer.apple.com/documentation/activitykit/starting-and-updating-live-activities-with-activitykit-push-notifications#Determine-the-update-frequency) bakın.
### OneSignal Panosunda Live Activities'i nerede görebilirim?
Live Activities yalnızca Live Activities API'lerimiz aracılığıyla gönderilebilir. Ancak, Live Activities için filtreledikten sonra panoda Gönderilen Mesajlar'da geçmişte gönderilen Live Activities'i (30 güne kadar) görüntüleyebilirsiniz. Burada hangi Live Activities'in gönderildiğini, hangi güncellenmiş bilgilerin gönderildiğini ve güncellemeyi alan kitle boyutunu görebileceksiniz.
### Hangi cihazlar Live Activities ile çalışır?
Apple, [iOS 16+](https://support.apple.com/guide/iphone/supported-models-iphe3fa5df43/16.0/ios/16.0) ve [iPadOS 17+](https://support.apple.com/guide/ipad/ipad-models-compatible-with-ipados-17-ipad213a25b2/ipados) ile çalışan tüm cihazlarla güncellenmiş bir uyumluluk kılavuzu tutar.
***
Artık Live Activities hakkında bilmeniz gereken her şeyle donatılmış olmalısınız.
[Live Activities Geliştirici Belgelerimizi](./live-activities-developer-setup) takip ederek Live Activities'inizi kurmaya başlayın.
***