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.
Etkinlik akışı nedir?
Bir etkinlik akışı, kullanıcıların uygulamanız içinde aldıkları bildirimlerin geçmişini görmelerini sağlar.
OneSignal, bildirimleri iletmeye odaklanır ancak şu anda her bir kullanıcıya gönderilen mesajların geçmişini saklamaz. Bu işlevselliği oluşturmak için bildirim verilerini kendiniz saklamanız gerekir—ya arka uç sunucunuzda ya da doğrudan kullanıcının cihazında.
Sunucuya kaydetme
Önerilen YaklaşımUygulamanızda arka plan işlemlerine güvenmek yerine, her bildirimi göndermek ve sunucunuzda bir kopyasını saklamak için Create notification REST API’sini kullanın. Ardından, uygulama başlatıldığında güncellemeler için sunucuyu kontrol edebilir.Veriler saklandıktan sonra, kullanıcının bildirim geçmişini istediğiniz zaman alıp görüntüleyebilirsiniz.OneSignal Event Streams kullanarak etkinlik akışı oluşturma
OneSignal’ın Event Streams özelliği, uygulamanızdan arka uç sistemlerinize veya veri ambarınıza gerçek zamanlı olayları akış halinde aktarmak için ölçeklenebilir bir yol sağlar. Bu, uygulama içinde akışı manuel olarak güncellemeden takipler, yorumlar, satın almalar veya bildirim olayları gibi uygulama içi kullanıcı davranışını yansıtan bir akış oluşturmanıza olanak tanır.Nasıl çalışır
Event Streams, şunlar dahil olmak üzere canlı olay verilerini dışa aktarır:
- Bildirim teslimatları
- Email/SMS açılmaları ve tıklamaları
- Kullanıcı tetiklemeli eylemler
Hedefler şunları içerir:
- Webhooks (HTTP uç noktalarınız)
- Amazon Kinesis
- Amazon S3
- Google Cloud Storage
- BigQuery
- Ve daha fazlası
Sisteminiz bu olayları gerçekleştikçe alır ve bunları bir akış kullanıcı arayüzünü veya analitik hattını güncellemek için kullanabilir.Event Streams ile Etkinlik Akışı kurma adımları
Event Streams'i etkinleştirin
- OneSignal Dashboard > Settings > Event Streams’e gidin.
- Webhook veya veri hattı gibi bir hedef seçin (örn., Amazon Kinesis).
- Akış olarak göndermek istediğiniz olayları seçin (örn.,
message.sent, message.delivered, message.clicked).
Olay verilerini işlemek için arka ucunuzu yapılandırın
-
Olay verilerini alan bir webhook veya tüketici oluşturun.
-
İlgili alanları çıkarmak için olay yükünü ayrıştırın:
external_id (kullanıcı kimliği)event türü (message.delivered, vb.)timestampcontents (bildirim mesajı)additional_data (herhangi bir özel meta veri)
Etkinlik Akışı girişlerini saklayın ve yapılandırın
- Bu olayları, sorgulama ve render etme için uygun bir formatta veritabanınıza kaydedin.
{
"message.id": "f3c9cd09-10d7-4f59-b9bc-66e16607f1d5",
"message.name": "the-name-you-set",
"message.title": "Claim 50% Off Today", // email subject example
"message.title": "{'en':'the message title/headings'}", // push title example
"message.contents": "{'en':'the message content'}",
"message.template_id": "the-template-uuid-if-set",
"message.url": "the-message-url",
"message.app_url": "the-message-app-url",
"message.web_url": "the-message-web-url"
}
Akışı uygulamanızda render edin
- Giriş yapmış kullanıcı için son olayları sorgulamak ve görüntülemek üzere bir ön uç bileşeni oluşturun (örn., React, SwiftUI veya Android View).
- İsteğe bağlı olarak olay türüne göre filtreler veya gruplama ekleyin.
Ek meta verilerle geliştirin
-
Bildirim gönderirken, akış bağlamı sağlamak için
additional_data ekleyin, örneğin:
{
"action": "commented",
"post_id": "xyz123"
}
-
Bu, “Jane gönderinize yorum yaptı.” gibi zengin akış girişleri oluşturmanıza olanak tanır.
Örnek kullanım senaryoları
- E-ticaret: Sipariş onaylarını, gönderi güncellemelerini ve promosyonları gösterin.
- Sosyal Uygulamalar: Beğenileri, yorumları, takipleri gösterin.
- SaaS Platformları: Görev atamalarını, bahsetmeleri veya etkinlik günlüklerini izleyin.
Faydaları
- Olay akışı yoluyla gerçek zamanlı güncellemeler
- Tamamen özelleştirilebilir mantık ve görüntüleme
- Ölçeklenebilir, arka uç odaklı mimari
