Özel olaylar - OneSignal

Ö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
Dönüşümleri ölçme ve onları sağlayan mesajlara atfetme
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:

string

gerekli

Olay adı. Maksimum 512 bayt. Adlar bayt olarak ölçülür; bu nedenle çok baytlı karakterlerden oluşan bir ad, karakter sayısının gösterdiğinden daha erken sınıra ulaşır.

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.

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.

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.

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

Olay adı sınırları

Her uygulama en fazla 1.000 benzersiz Özel Olay adı gönderebilir. Uygulamanızın halihazırda kullandığı bir ad altında gönderilen olaylar her zaman kabul edilir; bu nedenle sınıra ulaşmak, halihazırda göndermekte olduğunuz olayları asla kesintiye uğratmaz. Bir uygulama 1.000 ada ulaştığında, yeni bir ad altında gönderilen olaylar reddedilir. OneSignal isteği değil, yalnızca ilgili olayı reddeder; bu nedenle aynı toplu gönderimdeki diğer olaylar normal şekilde işlenir. API, bir errors dizisiyle birlikte HTTP 202 döndürür ve reddedilen her olay too many event names hata kodunu taşır. Reddedilen bir olay depolanmaz, faturalandırılmaz ve bir Journey tetikleyemez, bir mesajı kişiselleştiremez veya bir Segmentte kullanılamaz. Ancak Data > Events & Conversions bölümünde, “This app has reached its limit of unique event names” nedeniyle başarısız olarak işaretlenmiş şekilde görünür; böylece hangi adların reddedildiğini görebilirsiniz. Yer açmak için artık kullanmadığınız bir Özel Olay adını silin. Bir adı silmek, adın yerini boşaltır ve o ad altında depolanan olayları kalıcı olarak siler.

Custom Events sayfası, herhangi bir olay reddedilmeden önce, uygulamanız 900 benzersiz olay adını geçtiğinde sizi uyarır.

Ad sınırı, OneSignal’ın her olayı ne kadar süreyle tuttuğundan ayrıdır. Saklama için Özel olay depolama ve saklama sayfasına bakın.

Sınıra ulaşmamak için olayları adlandırma

Olay adı ne olduğunu söyler. Değişen her şey özelliklere aittir. Ada bir kimlik, fiyat veya başka bir değişken değer koymak, her gönderimde yeni bir benzersiz ad oluşturur ve 1.000 sınırını hızla tüketir.

{
  "name": "purchase_completed",
  "properties": { "product_id": "SKU-4412", "price": 24.99, "currency": "USD" }
}

{
  "name": "purchase_completed_SKU-4412_24.99"
}

Özellikler Journey’lerde, Dönüşümlerde ve Segmentlerde kullanılabilir.

Yer açmak için bir olay adını silme

Bir Özel Olay adını silmek, adın yerini boşaltır ve o ad altında depolanan olayları kalıcı olarak siler. Bu işlem geri alınamaz.

Artık kullanmadığınız olayları bulun

Data > Events & Conversions bölümüne gidin ve Event List sekmesini açın. Ayrıntı görünümünü açmak için bir olay seçin. Usage paneli, olaya referans veren her Journey ve Segmenti gösterir; son gerçekleşme zaman damgası ise olayın hâlâ gelip gelmediğini gösterir.

Olayı hâlâ kullanan her şeyden kaldırın

Usage altında listelenen bir olay canlıdır. Önce bu Journey’leri ve Segmentleri güncelleyin veya kaldırın; aksi takdirde adı silmek bunların davranışını etkiler.

Adı silin

Olay adının yanındaki satır menüsünü açın, Delete seçeneğini seçin ve onaylayın. Özel Olayları silmek için izne ihtiyacınız vardır. Seçenek görünmüyorsa, hesabınızda bu izni veren bir role sahip birinden yardım isteyin.

Sayfayı yenileyin

Silme işlemi arka planda çalışır ve birkaç dakika sürebilir. Sayfa kendiliğinden güncellenmez; bu nedenle adın silindiğini ve yerin boşaldığını doğrulamak için Refresh List seçeneğini seçin.

Özel Olayları OneSignal’a gönderme

Tüm olaylar, kaynağına bakılmaksızın faturalama amaçları için aynı şekilde ele alınır.

API ve SDK’lar

Create Custom Events API

Olayları arka ucunuzdan gönderin.

Mobile/Web SDKs

Olayları istemci tarafında takip edin.

Ö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"
    },
    {
      "name": "add_to_cart",
      "properties": {
        "item": "Hoodie",
        "size": "medium",
        "color": "black",
        "price": 49.99
      },
      "external_id": "user_12345",
      "timestamp": "2025-10-21T19:12:10.000Z",
      "idempotency_key": "789a0123-b45c-67d8-e901-234567890abc"
    },
    {
      "name": "signup_completed",
      "properties": {
        "plan": "pro",
        "trial": true
      },
      "external_id": "user_67890",
      "timestamp": "2025-10-21T19:15:44.000Z",
      "idempotency_key": "def01234-5678-90ab-cdef-012345678901"
    }
  ]
}

Entegrasyonlar

OneSignal, özel olay içe aktarmak için veri ambarları, veritabanları ve akış platformları dahil olmak üzere 25’ten fazla harici veri kaynağına bağlanır; özel kod gerekmez.

Twilio Segment

Segment ve OneSignal arasında etkinlikleri ve kitleleri yönlendirin.

Amplitude

Kohortları senkronize edin ve Amplitude’den özel etkinlikleri içe aktarın.

Snowflake

Snowflake ambarınızdan özel etkinlikleri içe aktarın.

Google BigQuery

BigQuery veri kümelerinden özel etkinlikleri içe aktarın.

Apache Kafka

Kafka konularından özel etkinlikleri akışla alın.

Tüm özel etkinlik kaynaklarına göz atın

OneSignal’a özel etkinlikleri içe aktaran veritabanlarının, ambarların ve akış platformlarının tam listesine bakın.

Geliştirici kaynağı yok mu? Özel etkinlikleri doğrudan bir Google Sheets elektronik tablosundan içe aktarın; kod gerekmez. Etkinlik verilerinizi bir sayfaya ekleyin ve OneSignal otomatik olarak içe aktarır. Erken deneme veya mühendislik desteği olmayan ekipler için idealdir.

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

Olayları gönderdikten sonra, Data > Events & Conversions 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.
Usage: 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, Custom Events sayfasında anında görünür. Ancak olayların bir kullanıcının profilinde Activity Timeline > Custom Events altında görünmesi 5 dakikaya kadar sürebilir. Bunun nedeni, Custom Events sayfasının son alımları yansıtması, kullanıcı profilinin ise uzun vadeli depolama tarafından desteklenmesidir.

Ö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.

Dönüşümleri ölçme

Mesajlaşmanızın iş etkisini ölçmek için bir Özel Olayı dönüşüm metriği olarak tanımlayın. OneSignal, kanallar arası son temas atıf modeli kullanarak dönüşümleri, onları sağlayan push, e-posta, SMS, uygulama içi ve RCS mesajlarına geri atfeder. Bunu, olayın nasıl ölçüleceğini seçtiğiniz Settings > Analytics > Conversion Metrics bölümünde ayarlayın:

Count, olayın ne sıklıkta gerçekleştiğini takip eder (örneğin, 15 satın alma).
Value, sayısal bir olay özelliğini toplar (örneğin, bir price özelliğinden 1.250 $ gelir).

Dönüşümler, genel dönüşümler panosunda ve mesaj, şablon ve Journey raporlarında görünür.

Bir olayın dönüşüm olarak sayılıp sayılmaması, saklama ayarından bağımsızdır. Saklama süresi, olay depolanmayacak şekilde ayarlanmış olsa bile bir olay dönüşüm metriğine sayılabilir.

Dönüşüm metrikleri

Atıf pencereleri, atıf modeli ve kurulum talimatları.

Ö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
Özel olay segmentleri kullanıcı tabanlıdır. Kendisi de kullanıcı tabanlı olan Journeys dışında mesaj gönderirken, dahil etme veya hariç tutma için abonelik tabanlı segmentlerle birleştirilemezler.
Zamana dayalı filtreler (“son X gün içinde gerçekleşti”), olayın orijinal olarak gerçekleştiği zamanı değil, OneSignal tarafından alındığı zamanı referans alır. Geçmiş olayları içe aktarıyorsanız ve orijinal olay zamanına göre segmentlere ayırmanız gerekiyorsa, olay zamanını unix zaman damgası olarak saklamak için bir Etiket kullanın. Etiket filtresi, dinamik zamana dayalı karşılaştırmalar için bir “Time Elapsed” operatörünü destekler. Etiketlerin kullanıcı düzeyinde olduğunu, bu nedenle yalnızca en son değerin saklandığını unutmayın.

Segmentasyon

Segmentasyon için kapsamlı rehber.

Plan kullanılabilirliği ve saklama maliyetleri

Özel Olaylar tüm ücretli planlarda kullanılabilir. Olay göndermek ücretsizdir. OneSignal yalnızca depoladığınız olaylar için faturalandırır; Segmentlerin ve kullanıcı profillerinin ihtiyaç duyduğu şey budur.

Özel olay depolama ve saklama

Depolamayı açın, olay başına saklama süresi ayarlayın ve depolanan olaylarınızı yönetin.

Faturalama SSS

Olay depolamanın faturanızda nasıl görüneceği.

Etiketler ve Özel Olaylar

Etiketler ve Özel Olaylar, her ikisi de kullanıcılarınıza veri eklemenin yollarıdır. Ancak bazı temel farklar vardır:

Özellik	Etiketler	Özel Olaylar
Veri kullanımı	Segmentasyon ve kişiselleştirme	Segment olmadan Journey’leri tetikleme, Wait Until adımları, doğrudan Journey’ler içinde kişiselleştirme
Veri saklama	Ömür boyu	Sınırsız (min. 30 gün)
Veri formatı	Anahtar-değer dizeleri veya sayılar	JSON
Veri kaynağı	OneSignal SDK, API veya CSV içe aktarma	OneSignal SDK, API veya entegrasyonlar
Veri erişimi	Segmentasyon ve mesaj kişiselleştirme	Journey’ler ve Journey-mesaj-şablonu kişiselleştirmesi, Segmentasyon (Yakında)

Etiketler ve Özel Olaylar arasındaki temel ayrım, derinlikleri ve kullanım senaryolarındadır. Etiketler bir kullanıcının özellikleridir; örneğin Ad, Hesap Durumu veya Konum. Olaylar ise kullanıcının yaptığı şeylerdir; örneğin Bir Ürün Satın Alma, Bir Seviyeyi Tamamlama veya Bir Arkadaş Davet Etme. Hem etiketler hem de olaylar 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 journey iş akışları için Özel Olaylar

​Özel Olaylar nedir?

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

​Özel Olay yapısı

​Olay adı sınırları

​Sınıra ulaşmamak için olayları adlandırma

​Yer açmak için bir olay adını silme

​Özel Olayları OneSignal’a gönderme

​API ve SDK’lar

Create Custom Events API

Mobile/Web SDKs

​Entegrasyonlar

Twilio Segment

Amplitude

Snowflake

Google BigQuery

Apache Kafka

Tüm özel etkinlik kaynaklarına göz atın

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

​Event List sekmesi

​Event Activity sekmesi

​Özel Olayları OneSignal’da kullanma

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

Journey ayarları

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

Journey Wait Until adımı

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

Özel Olay kişiselleştirmesi

​Dönüşümleri ölçme

Dönüşüm metrikleri

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

Segmentasyon

​Plan kullanılabilirliği ve saklama maliyetleri

Özel olay depolama ve saklama

Faturalama SSS

​Etiketler ve Özel Olaylar

Özel Olaylar nedir?

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

Özel Olay yapısı

Olay adı sınırları

Sınıra ulaşmamak için olayları adlandırma

Yer açmak için bir olay adını silme

Özel Olayları OneSignal’a gönderme

API ve SDK’lar

Entegrasyonlar

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

Event List sekmesi

Event Activity sekmesi

Özel Olayları OneSignal’da kullanma

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

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

Olay özellikleriyle Journey’leri kişiselleştirme

Dönüşümleri ölçme

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

Plan kullanılabilirliği ve saklama maliyetleri

Etiketler ve Özel Olaylar