Ana içeriğe atla
Özel olaylar şu anda Erken Erişim aşamasındadır. Erişim istemek için support@onesignal.com ile iletişime geçin ve şunları belirtin:
  • Şirket adınız
  • Etkinleştirmek istediğiniz OneSignal App ID(s)

​
Genel Bakış

Özel Olaylar, uygulamanızdan, web sitenizden veya harici sistemlerden anlamlı kullanıcı eylemlerini izlemenizi ve bunlara gerçek zamanlı olarak tepki vermenizi sağlar. OneSignal dışında gerçekleşen davranışlar için kullanıcı olayları gönderin ve daha hedefli, ilgili ve zamanında mesajlaşma sunmak için kullanın. Şunları yapabilirsiniz:
  • OneSignal SDK’larını kullanarak uygulamanızdan veya web sitenizden doğrudan olay gönderin
  • Entegrasyonlarınızdan, CDP’nizden veya veri ambarınızdan olayları içe aktarın
  • Gerçek zamanlı davranışa dayalı olarak Journey’leri tetiklemek, Wait Until adımlarını etkinleştirmek ve kullanıcıları segmentlere ayırmak için kullanın (segmentasyon seçeneği yakında gelecek)
Örnek kullanım senaryoları:
  • Kullanıcı kaydolur → Onboarding Journey’ini başlat
  • Kullanıcı ödemeyi terk eder → Hatırlatma veya teklif gönder
  • Oyuncu yeni seviyeye ulaşır → Uygulama içi ödül gönder
  • Kullanıcı hesabı iptal etmeye çalışır → Geri kazanma kampanyası tetikle

​
Özel Olay nedir?

Özel Olay, işletmeniz için önemli olan izlenen herhangi bir kullanıcı eylemi — veya eylemsizliği — dir. Yaygın örnekler şunları içerir:
  • Satın alma yapma
  • Oyun seviyesini tamamlama
  • Antrenman başlatma
  • Abonelik iptali
Her olay, ekstra bağlam sağlamak için özellikler içerebilir. Özel Olay yapısı:
  • name (string, zorunlu) — Olay adı, maksimum 128 karakter
  • properties (object, isteğe bağlı) — JSON formatında bağlam verileri
  • Kullanıcı tanımlayıcısı (zorunlu) — external_id veya onesignal_id
Örnek: 
{
  "events": [
    {
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      }
    }
  ]
}
Özel Olaylar şunlar olabilir:
  • Üretilmiş uygulamanızdan veya sitenizden gerçek zamanlı olarak (OneSignal Mobile/Web SDK’lar)
  • Alınmış Segment, Amplitude veya Databricks gibi entegrasyonlardan (yakında gelecek)
  • İçe aktarılmış ambarınızdan veya CDP’nizden (yakında gelecek)

​
Etiketler ve Özel Olaylar

Tags and Custom Events are both ways to add data to your users. However, there are some key differences:
FeatureTagsCustom Events
Data usageSegmentation and personalizationTrigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys
Data retentionLifetime30+ days (lifetime storage is available)
Data formatKey-value strings or numbersJSON
Data sourceOneSignal SDK, API, or integrations (limited)OneSignal SDK, API, or integrations
Data accessSegmentation and message personalizationJourneys and Journey-message-template personalization, Segmentation (Coming soon)
The key distinction between Tags and Custom Events is in their depth and use cases. Tags are properties of a user, such as Name, Account Status, or Location. Events are thing that the user has done, such as Purchasing an Item, Completing a Level, or Inviting a Friend. Both tags and events can be used for segmentation and personalization. In practice, you will likely use both:
  • Tags for user properties that are static and don’t change often
  • Custom Events for real-time scenarios, complex segmentation, and more sophisticated journey workflows

​
Özel Olayları OneSignal’a alma

Olayları API’lerimizle doğrudan oluşturabilir veya diğer sistemlerden alabilirsiniz.
Tüm olaylar — ister SDK’dan oluşturulmuş ister Veri Ambarından alınmış olsun — faturalama amaçları için aynı şekilde ele alınır.

​
OneSignal API ve SDK’lar

Olayları şu yollarla gönderin: Örnek: API ile gönderme
curl
curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Content-Type: application/json' \
  --data '{
  "events": [
    {
      "name": "completed_onboarding",
      "external_id": "user_12345",
      "properties": {
        "plan": "Pro",
        "time_to_complete": 600
      }
    }
  ]
}'
​
name
string
required
Olayın tanımlayıcısı veya adı. Maksimum 128 karakter.
​
external_id
string
Olay için hedeflenen kullanıcının harici kimliği. Kullanıcının Harici Kimliği veya OneSignal Kimliği gereklidir.
​
properties
object
Olayla ilgili isteğe bağlı parametreler (örn., plan adı, ürün kimliği, fiyat).
Bu olay, external_id user_12345 olan kullanıcıyı, özel olay giriş kuralı tetikleyicisi veya bekleme eylemi olarak completed_onboarding olan bir Journey’e hemen ekleyecektir.

​
Entegrasyonlar

Olaylar zaten başka bir yerde izleniyorsa, desteklenen integrations aracılığıyla içe aktarın.

​
Olayları görüntüleme ve doğrulama

Olaylar akmaya başladıktan sonra, bunları OneSignal’daki çeşitli araçlar aracılığıyla görüntüleyebilir ve sorun giderebilirsiniz.

​
Event List Sekmesi

Organizasyonunuza gidin

Event List sekmesi, olay türüne göre düzenlenmiş olaylarınızın üst düzey bir kontrol panelini sağlar. Her olay türü için, alınan toplam olay sayısını, en son alınan olayı (özellikleriyle birlikte JSON formatında gösterilir), olayın kaynağını (SDK, API veya entegrasyon) ve olay türünün en son gerçekleşme zamanını görebilirsiniz. Her olayın ayrıntı görünümünde, saklama süresini güncelleme seçeneğiniz de vardır. Alt ayrıntı görünümü, üç ana alanda ek içgörüler sunar:
  • Kaynak Dağılımı – Kaynağa göre alınan olay sayısını görüntüler, genişletme ve en son görülen olayın zaman damgası ile birlikte olayların en son şemasını görüntüleme seçeneği sunar.
  • Etkinlikler – Kaynağını ve zaman damgasını gösteren, en son alınan 10 olayı listeler. Her giriş, olayın tam JSON yükünü ortaya çıkarmak için genişletilebilir.
  • Kullanım – Belirli bir olayın OneSignal içinde nerede kullanıldığını gösterir, örneğin segmentlerde veya journey’lerde. Buradan, ayarlarına erişmek için ilgili segmente veya journey’e doğrudan tıklayabilirsiniz.

​
Event Activity Sekmesi

Organizasyonunuza gidin

Event Activity sekmesi, OneSignal uygulamanıza alınan en son olayların canlı bir akışını sağlar. Akışı 90 gün öncesine kadar olan olayları incelemek için genişletebilir ve kaynağa, olay özelliklerine veya harici kimliğe göre filtreler uygulayabilirsiniz. Bu sekme, olay kaynaklarını yapılandırırken sorunları hata ayıklamak için özellikle yararlıdır, çünkü olayların uygulamanıza beklendiği gibi ulaşıp ulaşmadığını doğrulamanıza olanak tanır. Akışın otomatik olarak yenilenmediğini unutmayın, bu nedenle yeni olaylar gönderdikten sonra en son etkinliği görmek için manuel olarak yenilemeniz gerekir.

​
Event Storage Sekmesi (Yakında Gelecek)

OneSignal Uygulamanız için olayların depolanmasını yönetmek için özel bir görünüm.

​
OneSignal’da Özel Olayları kullanma

​
Olaylarla Journey’leri tetikleme

Olay tetikli Journey’ler, segment güncellemelerini beklemeye gerek kalmadan gerçek zamanlı aktiviteye dayalı olarak kullanıcılara hemen mesaj göndermenizi sağlar. Bir kullanıcı önemli bir eylem gerçekleştirdiği anda bir Journey başlatabilirsiniz.

​
Wait Until olayı

Belirli bir özel olay veya başka bir eylem gerçekleşene kadar kullanıcıları bir Journey’de duraklatmak için Wait Until step kullanın.
Bir son kullanma penceresi de tanımlayabilirsiniz. Kullanıcı zamanında koşulu karşılamazsa, bir yedek yoldan devam edebilir, alternatif bir mesaj gönderebilir veya Journey’den çıkabilirsiniz.

​
Özel Olaylara göre Segmentasyon (Erken Erişimde)

Özel bir olayın oluşumuna dayalı bir segment oluşturabilirsiniz. Bu, OneSignal SDK’sını kullanan Uygulamanızdaki davranışa veya OneSignal dışında yakalanan olaylara dayalı olarak kullanıcıları segmentlere ayırmanızı sağlar. Custom Event Segmentation hakkında daha fazla ayrıntı Segmentation sayfasında mevcuttur. Özel Olay Segmentasyonu için Erken Erişim Programına katılmakla ilgileniyorsanız, lütfen support@onesignal.com’a veya OneSignal hesap temsilcinize ulaşın. Bu özellik Erken Erişimde olduğu sırada sınırlamalar:
  • Email Warm Up ve A/B testleri ile kullanılamaz.
  • Özel olay segmentleri Journey’leri güçlendirmek için kullanılamaz.
  • Özel olay filtrelerini henüz diğer segmentasyon filtreleriyle (kullanıcı özellikleri veya mesaj olayları gibi) birleştiremezsiniz.

​
Plan kullanılabilirliği ve saklama maliyetleri

Özel Olaylar tüm ücretli planlarda mevcuttur. Daha fazla ayrıntı için lütfen Billing FAQ’e bakın.