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

# Özel olaylar

> Özel Olaylar ile kullanıcı davranışlarını izleyin ve bunları Journey'leri tetiklemek, Wait Until adımlarıyla akışı kontrol etmek ve mesajları gerçek zamanlı olarak kişiselleştirmek için kullanın.

## Ö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)

<Warning>
  Ö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](#tags-vs-custom-events) bölümüne bakın.
</Warning>

### Özel Olay yapısı

Özel Olaylar aşağıdaki alanları içerir:

<ParamField body="name" type="string" required>
  Olay adı. Maksimum `128` karakter.
</ParamField>

<ParamField body="properties" type="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.
</ParamField>

<ParamField body="external_id" type="string">
  Kullanıcının Harici Kimliği. [Create Custom Events API](/reference/create-custom-events) kullanılırken bir kullanıcı tanımlayıcısı gereklidir. `external_id` veya `onesignal_id` sağlanmalıdır.
</ParamField>

<ParamField body="timestamp" type="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](/reference/create-custom-events).
</ParamField>

<ParamField body="idempotency_key" type="string">
  Mükerrer olay işlemeyi önlemek için kullanılan benzersiz bir UUID. Bkz. [Create Custom Events API](/reference/create-custom-events).
</ParamField>

<Warning>
  Olay boyut sınırları:

  * Maksimum olay yükü: 2024 bayt
  * Maksimum istek boyutu (birden fazla olay): 1 MB
</Warning>

***

## Özel Olayları OneSignal'a gönderme

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

### API ve SDK'lar

<Columns cols={2}>
  <Card title="Create Custom Events API" icon="server" href="/reference/create-custom-events">
    Olayları arka ucunuzdan gönderin.
  </Card>

  <Card title="Mobile/Web SDKs" icon="mobile" href="./mobile-sdk-reference#custom-events">
    Olayları istemci tarafında takip edin.
  </Card>
</Columns>

Örnek Özel Olay yükü:

```json JSON theme={null}
{
  "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"
    }
  ]
}
```

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

<Columns cols={3}>
  <Card title="Twilio Segment" icon="share-nodes" href="./segment-onesignal-integration">
    Segment ve OneSignal arasında etkinlikleri ve kitleleri yönlendirin.
  </Card>

  <Card title="Amplitude" icon="chart-line" href="./amplitude">
    Kohortları senkronize edin ve Amplitude'den özel etkinlikleri içe aktarın.
  </Card>

  <Card title="Mixpanel" icon="chart-mixed" href="./mixpanel">
    Kohortları senkronize edin ve Mixpanel'den özel etkinlikleri içe aktarın.
  </Card>

  <Card title="Snowflake" icon="snowflake" href="./snowflake">
    Snowflake ambarınızdan özel etkinlikleri içe aktarın.
  </Card>

  <Card title="Google BigQuery" icon="database" href="./bigquery">
    BigQuery veri kümelerinden özel etkinlikleri içe aktarın.
  </Card>

  <Card title="Apache Kafka" icon="bolt" href="./kafka">
    Kafka konularından özel etkinlikleri akışla alın.
  </Card>
</Columns>

<Card title="Tüm özel etkinlik kaynaklarına göz atın" icon="grid-2" href="./integrations#custom-event-sources">
  OneSignal'a özel etkinlikleri içe aktaran veritabanlarının, ambarların ve akış platformlarının tam listesine bakın.
</Card>

<Tip>
  **Geliştirici kaynağı yok mu?** Özel etkinlikleri doğrudan bir [Google Sheets](./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.
</Tip>

### 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

<Frame caption="OneSignal panelinde Data > Custom Events altındaki Event List sekmesi">
  <img src="https://mintcdn.com/onesignal/MWGmj5X1CnFliD-c/images/dashboard/event-list.png?fit=max&auto=format&n=MWGmj5X1CnFliD-c&q=85&s=2b9cae667bed4b54974326ffa0830907" width="3302" height="1888" data-path="images/dashboard/event-list.png" />
</Frame>

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

<Frame caption="OneSignal panelinde Data > Custom Events altındaki Event Activity sekmesi">
  <img src="https://mintcdn.com/onesignal/MWGmj5X1CnFliD-c/images/dashboard/event-activity.png?fit=max&auto=format&n=MWGmj5X1CnFliD-c&q=85&s=8e355c907b598f1ac5a446e3536b9eea" width="3302" height="1888" data-path="images/dashboard/event-activity.png" />
</Frame>

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

<Warning> Akış otomatik olarak yenilenmez. Yeni olaylar gönderdikten sonra manuel olarak yenileyin. </Warning>

***

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

<Card title="Journey ayarları" icon="gear" href="./journeys-settings#entry-rules">
  Özel Olaylarla kullanıcıları Journey'lere ekleyin.
</Card>

### 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

<Info> Bir son kullanma penceresi tanımlayabilirsiniz. Kullanıcı zamanında olayı tetiklemezse, bir yedek mesaj gönderebilir veya Journey'den çıkabilirsiniz. </Info>

<Card title="Journey Wait Until adımı" icon="stopwatch" href="./journeys-actions#wait-until">
  Bir Özel Olay gerçekleşene kadar kullanıcıları bekletin.
</Card>

### Olay özellikleriyle Journey'leri kişiselleştirme

Journey şablonlarınızda Liquid kullanarak olay özelliklerine referans verin.

Örnek:

```liquid Liquid theme={null}
Thanks for purchasing {{ journey.first_event.properties.item }}!
```

<Card title="Özel Olay kişiselleştirmesi" icon="bolt" href="./personalization-custom-event">
  Journey'leri kişiselleştirmek için olay özelliklerini kullanma rehberi.
</Card>

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

Bir Özel Olayın gerçekleşmesine dayalı bir segment oluşturun.

<Note>
  Ö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
</Note>

<Warning>
  Mevcut sınırlamalar:

  * Email Warm Up veya A/B testleri ile desteklenmez
  * Journey'leri çalıştıramaz
  * Diğer segment filtreleriyle birleştirilemez
</Warning>

<Card title="Segmentasyon" icon="filter" href="./segmentation">
  Segmentasyon için kapsamlı rehber.
</Card>

***

## Plan kullanılabilirliği ve saklama maliyetleri

Özel Olaylar tüm ücretli planlarda mevcuttur.

<Card title="Faturalandırma SSS" icon="receipt" href="./billing-faq#streaming-events">
  Olay saklama ve fiyatlandırma hakkında bilgi edinin.
</Card>

***

## Etiketler ve Özel Olaylar

[Etiketler](/docs/en/add-user-data-tags) ve [Özel Etkinlikler](/docs/en/custom-events) kullanıcılarınıza veri eklemenin her ikisi de yoludur. Ancak bazı temel farklar vardır:

| Özellik        |                     Etiketler                    |                                           Özel Etkinlikler                                          |
| -------------- | :----------------------------------------------: | :-------------------------------------------------------------------------------------------------: |
| Veri kullanımı |          Segmentasyon ve kişiselleştirme         | Segment olmadan Yolculukları tetikleme, Bekle adımları, doğrudan Yolculuklar içinde kişiselleştirme |
| Veri tutma     |                     Ömür boyu                    |           30+ gün ([ömür boyu depolama mevcuttur](/docs/en/billing-faq#streaming-events))           |
| Veri formatı   |        Anahtar-değer dizgiler veya sayılar       |                                                 JSON                                                |
| Veri kaynağı   | OneSignal SDK, API veya entegrasyonlar (sınırlı) |                                OneSignal SDK, API veya entegrasyonlar                               |
| Veri erişimi   |       Segmentasyon ve mesaj kişiselleştirme      |             Yolculuklar 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

***