Ana içeriğe atla

​
Özel Olaylar nedir?

Özel Olay, OneSignal’a gönderdiğiniz adlandırılmış bir kullanıcı eylemidir (veya eylemsizliğidir). Otomasyonu tetiklemek, Journey akışını kontrol etmek ve kullanıcı deneyimlerini gerçek zamanlı olarak kişiselleştirmek için uygulamanızdan, web sitenizden veya harici sistemlerden olaylar gönderirsiniz. Örnekler:
  • Onboarding tamamlama
  • Satın alma yapma
  • Sepeti terk etme
  • Abonelik iptali
  • Yeni oyun seviyesine ulaşma
OneSignal bir Özel Olay aldığında şunları yapabilirsiniz:
  • Bir Journey başlatma
  • Bir Journey’i Wait Until adımıyla devam ettirme
  • Kullanıcıları bir Journey’den çıkarma
  • Olay özellikleriyle mesajları kişiselleştirme
  • Davranışa göre kullanıcıları segmentlere ayırma (Erken Erişim)

​
Özel Olayları ne zaman kullanmalısınız?

Özel Olayları şu durumlarda kullanın:
  • Mesajlaşma, gerçek zamanlı kullanıcı davranışına yanıt vermelidir
  • Veri, gerçekleşmiş bir olayı temsil eder (kalıcı bir durum değil)
  • Kişiselleştirme veya Journey mantığı için olay özelliklerine ihtiyacınız vardır
Özel Olayları şu durumlarda kullanmayın:
  • Uzun vadeli kullanıcı özniteliklerini saklamak istiyorsanız (bunun yerine Etiketleri kullanın)
Özel Olaylar, belirli bir zamanda gerçekleşen bir şeyi temsil eder. Etiketlerin aksine, kullanıcının profilini kalıcı olarak güncellemezler — davranışı kaydederler.Ayrıntılı bir karşılaştırma için aşağıdaki Etiketler ve Özel Olaylar bölümüne bakın.

​
Özel Olay yapısı

Özel Olaylar aşağıdaki alanları içerir:
​
name
string
gerekli
Olay adı. Maksimum 128 karakter.
​
properties
object
Olayı tanımlayan isteğe bağlı parametreler (örneğin: plan adı, ürün kimliği veya fiyat). Kişiselleştirme ve Journey akış kontrolü için kullanılabilirler.
​
external_id
string
Kullanıcının Harici Kimliği. Create Custom Events API kullanılırken bir kullanıcı tanımlayıcısı gereklidir. external_id veya onesignal_id sağlanmalıdır.
​
timestamp
string
Olayın gerçekleştiği (veya gerçekleşeceği) zaman, ISO 8601 formatında bir string olarak biçimlendirilir. Bkz. Create Custom Events API.
​
idempotency_key
string
Mükerrer olay işlemeyi önlemek için kullanılan benzersiz bir UUID. Bkz. Create Custom Events API.
Olay boyut sınırları:
  • Maksimum olay yükü: 2024 bayt
  • Maksimum istek boyutu (birden fazla olay): 1 MB

​
Özel Olayları OneSignal’a gönderme

Aşağıdaki yöntemleri kullanarak Özel Olaylar gönderin:
Tüm olaylar, kaynağına bakılmaksızın faturalama amaçları için aynı şekilde ele alınır.
Örnek Özel Olay yükü:
JSON
{
  "events": [
    {
      "name": "purchase",
      "properties": {
        "item": "T-shirt",
        "size": "small",
        "color": "blue",
        "price": 24.99
      },
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:09:32.263Z",
      "idempotency_key": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}

​
Olayların alındığını doğrulama

Olayları gönderdikten sonra, Data > Custom Events bölümünde OneSignal’a ulaştıklarını doğrulayın.

​
Event List sekmesi

Event List sekmesi, uygulamanızdaki tüm Özel Olaylara olay adına göre düzenlenmiş bir genel bakış sunar. Her olay türü için şunları görebilirsiniz:
  • Alınan toplam olay sayısı
  • En son olay (tam JSON yükü ve özellikleriyle)
  • Olay kaynağı (SDK, API veya entegrasyon)
  • Son gerçekleşme zaman damgası
Ayrıntı görünümünü açmak için bir olay seçin; burada saklama süresini de güncelleyebilirsiniz. Ayrıntı görünümü şunları içerir:
  • Kaynak Dağılımı: Kaynağa göre alınan olay sayısı. En son olay şemasını ve en son olayın zaman damgasını görüntülemek için genişletin.
  • Etkinlikler: Kaynak ve zaman damgası dahil en son 10 olay. Tam JSON yükünü incelemek için herhangi bir girişi genişletin.
  • Kullanım: Olayın şu anda nerede kullanıldığı (Journey’ler veya segmentler). Ayarlarını değiştirmek için ilgili Journey veya segmente doğrudan tıklayın.

​
Event Activity sekmesi

Event Activity sekmesi, OneSignal uygulamanıza alınan en son olayların canlı bir akışını sağlar. Şunlar için kullanın:
  • Olay adına, kaynağa veya harici kimliğe göre filtreleme
  • Tam JSON yüklerini inceleme
  • Entegrasyon sorunlarını hata ayıklama
Akış otomatik olarak yenilenmez. Yeni olaylar gönderdikten sonra manuel olarak yenileyin.

​
Özel Olayları OneSignal’da kullanma

Olaylar OneSignal’a akmaya başladıktan sonra, bunları aşağıdaki şekillerde kullanabilirsiniz:

​
Journey giriş ve çıkış kurallarını tetikleme

Olay gerçekleştiğinde kullanıcıları hemen eklemek veya çıkarmak için bir Özel Olayı Journey giriş veya çıkış kuralı olarak ayarlayın. Örnek:
  • signup_completed → Onboarding başlat veya deneme teşvik Journey’inden çıkar
  • purchase → Onay ve çapraz satış gönder veya terk edilmiş sepet Journey’inden çıkar

Journey ayarları

Özel Olaylarla kullanıcıları Journey’lere ekleyin.

​
Journey akışını kontrol etme (Wait Until)

Bir Özel Olay gerçekleşene kadar kullanıcıları bekletmek için Wait Until adımını kullanın. Örnek:
  • added_to_cart sonrasında purchase olayını bekleyin
Bir son kullanma penceresi tanımlayabilirsiniz. Kullanıcı zamanında olayı tetiklemezse, bir yedek mesaj gönderebilir veya Journey’den çıkabilirsiniz.

Journey Wait Until adımı

Bir Özel Olay gerçekleşene kadar kullanıcıları bekletin.

​
Olay özellikleriyle Journey’leri kişiselleştirme

Journey şablonlarınızda Liquid kullanarak olay özelliklerine referans verin. Örnek:
Liquid
Thanks for purchasing {{ journey.first_event.properties.item }}!

Özel Olay kişiselleştirmesi

Journey’leri kişiselleştirmek için olay özelliklerini kullanma rehberi.

​
Özel Olaylarla kullanıcıları segmentlere ayırma

Bir Özel Olayın gerçekleşmesine dayalı bir segment oluşturun.
Özel Olay segmentasyonu Erken Erişim aşamasındadır.Erişim talep etmek için support@onesignal.com adresine şunlarla birlikte e-posta gönderin:
  • Şirket adınız
  • OneSignal App ID’leriniz
Mevcut sınırlamalar:
  • Email Warm Up veya A/B testleri ile desteklenmez
  • Journey’leri çalıştıramaz
  • Diğer segment filtreleriyle birleştirilemez

Segmentasyon

Segmentasyon için kapsamlı rehber.

​
Plan kullanılabilirliği ve saklama maliyetleri

Özel Olaylar tüm ücretli planlarda mevcuttur.

Faturalandırma SSS

Olay saklama ve fiyatlandırma hakkında bilgi edinin.

​
Etiketler ve Özel Olaylar

Etiketler ve Özel Etkinlikler kullanıcılarınıza veri eklemenin her ikisi de yoludur. Ancak bazı temel farklar vardır:
ÖzellikEtiketlerÖzel Etkinlikler
Veri kullanımıSegmentasyon ve kişiselleştirmeSegment olmadan Yolculukları tetikleme, Bekle adımları, doğrudan Yolculuklar içinde kişiselleştirme
Veri tutmaÖmür boyu30+ gün (ömür boyu depolama mevcuttur)
Veri formatıAnahtar-değer dizgiler veya sayılarJSON
Veri kaynağıOneSignal SDK, API veya entegrasyonlar (sınırlı)OneSignal SDK, API veya entegrasyonlar
Veri erişimiSegmentasyon ve mesaj kişiselleştirmeYolculuklar ve Yolculuk-mesaj-şablon kişiselleştirme, Segmentasyon (Yakında)
Etiketler ve Özel Etkinlikler arasındaki temel ayrım, derinliklerinde ve kullanım durumlarındadır. Etiketler bir kullanıcının özellikleridir, örneğin Ad, Hesap Durumu veya Konum. Etkinlikler ise kullanıcının yaptığı şeylerdir, örneğin Bir Öğe Satın Alma, Seviye Tamamlama veya Arkadaş Davet Etme. Hem etiketler hem de etkinlikler segmentasyon ve kişiselleştirme için kullanılabilir. Uygulamada, muhtemelen her ikisini de kullanacaksınız:
  • Statik ve sık değişmeyen kullanıcı özellikleri için Etiketler
  • Gerçek zamanlı senaryolar, karmaşık segmentasyon ve daha sofistike yolculuk iş akışları için Özel Etkinlikler