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

# Event Stream veri referansı

> Event Streams ve Webhooks'ta mevcut tüm event, message, user ve subscription özellikleri için şema referansı. Her alan için Liquid sözdizimi içerir.

[Liquid sözdizimi kullanarak](./using-liquid-syntax) event stream verilerine erişin. Herhangi bir alanı Event Stream gövdesine dahil etmek için `{{ }}` içine sarın. [Örneklere](./event-streams#example-body) bakın.

<Warning>
  Journey'ler ve API gönderimleri için mesaj verileri 30 gün boyunca saklanır. 30 günden sonra gerçekleşen etkileşim olayları (tıklamalar, açılmalar, abonelik iptalleri) boş mesaj özelliklerine sahip olabilir. Verileri kurtarmak için etkileşim olayındaki `message.id`'yi tam mesaj verilerini içeren orijinal `sent` olayıyla ilişkilendirin.
</Warning>

## `event` özellikleri

Her olay aşağıdaki temel alanları içerir. `event.data.*` altındaki kanala özgü alanlar yalnızca uygulanabilir olduğunda eklenir — [Kanala özgü alanlar](#channel-specific-fields) bölümüne bakın.

<ParamField body="event.kind" type="string">
  Kanal ve eylemi birleştiren olay türü (örn. `message.push.clicked`, `message.email.bounced`). Değerlerin tam listesi için aşağıdaki [olay türü referansı](#event-kind-reference) bölümüne bakın. **Liquid:** `{{ event.kind }}`
</ParamField>

<ParamField body="event.id" type="UUID">
  UUID v4 formatında her bir olay için OneSignal tarafından oluşturulan benzersiz tanımlayıcı. Bu ID'yi idempotent teslimat takibi için kullanın. Mesaj veya şablon tanımlayıcısı için [`message.id`](#message-id) veya [`message.template_id`](#template-id) kullanın. **Liquid:** `{{ event.id }}`
</ParamField>

<ParamField body="event.timestamp" type="integer">
  Olayın UNIX zaman damgası. **Liquid:** `{{ event.timestamp }}`
</ParamField>

<ParamField body="event.datetime" type="string">
  ISO 8601 dizesi olarak UTC'de olayın okunabilir zamanı (örn. "2024-02-21T23:45:15.228Z"). **Liquid:** `{{ event.datetime }}`
</ParamField>

<ParamField body="event.app_id" type="UUID">
  OneSignal [App ID](./keys-and-ids). **Liquid:** `{{ event.app_id }}`
</ParamField>

<ParamField body="event.subscription_device_type" type="string">
  Abonelik türü (örn. `iOS`, `Android`, `Chrome`, `Email`, `SMS`). **Liquid:** `{{ event.subscription_device_type }}`
</ParamField>

<ParamField body="event.subscription_id" type="UUID">
  OneSignal [Subscription ID](./subscriptions). **Liquid:** `{{ event.subscription_id }}`
</ParamField>

<ParamField body="event.onesignal_id" type="UUID">
  OneSignal [User ID](./users). **Liquid:** `{{ event.onesignal_id }}`
</ParamField>

<ParamField body="event.external_id" type="string">
  OneSignal [External ID](./users) takma adı olarak ayarlanan Kullanıcı ID'niz. Ayarlanmamışsa boş olabilir. **Liquid:** `{{ event.external_id }}`
</ParamField>

### Kanala özgü alanlar

Bu `event.data.*` alanları yalnızca belirli olay türleri için mevcuttur.

#### Uygulama içi mesaj olayları

`message.iam.*` olaylarıyla eklenir. Ayrıntılar için [Uygulama içi mesaj Event Streams](./iam-event-streams) bölümüne bakın.

<ParamField body="event.data.page_name" type="string">
  Görüntülenen uygulama içi mesaj sayfasının veya kartının adı. **Liquid:** `{{ event.data.page_name }}`
</ParamField>

<ParamField body="event.data.page_id" type="string">
  Görüntülenen uygulama içi mesaj sayfası veya kartı için benzersiz tanımlayıcı. **Liquid:** `{{ event.data.page_id }}`
</ParamField>

<ParamField body="event.data.target_name" type="string">
  Tıklanan düğme veya görüntü blok öğesinin adı. Öğe bir [uygulama içi tıklama eylemi](./iam-click-actions) içermelidir. **Liquid:** `{{ event.data.target_name }}`
</ParamField>

<ParamField body="event.data.target_id" type="string">
  Tıklanan düğme veya görüntü blok öğesi için benzersiz tanımlayıcı. **Liquid:** `{{ event.data.target_id }}`
</ParamField>

#### Live Activity olayları

`message.live_activity.*` olaylarıyla eklenir.

<ParamField body="event.data.live_activity_id" type="string">
  Belirli bir Live Activity için benzersiz tanımlayıcı (örn. "Knicks vs Cavs - Oct 22 7PM"). **Liquid:** `{{ event.data.live_activity_id }}`
</ParamField>

<ParamField body="event.data.live_activity_type" type="string">
  Live Activity kategorileri için gruplama etiketi (örn. "Knicks\_games"). **Liquid:** `{{ event.data.live_activity_type }}`
</ParamField>

#### Başarısız olaylar

`message.push.failed` ve `message.email.failed` olaylarıyla eklenir.

<ParamField body="event.data.failure_reason" type="string">
  Mesajın gönderilememe nedeni. Yaygın nedenler için [Push Mesaj Raporları](./push-notification-message-reports#failure-message-troubleshooting) veya [E-posta Mesaj Raporları](./email-message-reports#why-are-my-emails-marked-as-failed) bölümüne bakın. **Liquid:** `{{ event.data.failure_reason }}`
</ParamField>

### Olay türü referansı

Her metriğin ayrıntılı tanımları için [Metrik Sözlüğü](./analytics-metrics-glossary) bölümüne bakın.

| Mesaj Olay Türü (OneSignal)      | Olay adı (veri setinde)              | Olay Açıklaması                                                                                                                                                                                                               |
| -------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Push Gönderildi                  | `message.push.sent`                  | Push bildirimi push hizmetlerine (FCM, APNS, vb.) başarıyla gönderildi.                                                                                                                                                       |
| Push Alındı                      | `message.push.received`              | Push bildirimi alıcı tarafından alındı. Tüm platformlarda mevcut değildir. Daha fazla ayrıntı için [Onaylanmış Teslimat](./confirmed-delivery) bölümüne bakın.                                                                |
| Push Tıklandı                    | `message.push.clicked`               | Kullanıcı cihazda uygulamayı açmak için push bildirimine dokundu.                                                                                                                                                             |
| Push Başarısız                   | `message.push.failed`                | Push gönderilemedi. Ayrıntılar için [Push Mesaj Raporları](./push-notification-message-reports) bölümüne bakın.                                                                                                               |
| Push Abonelikten Çıkıldı         | `message.push.unsubscribed`          | Kullanıcı push [aboneliğinden](./subscriptions) çıktı. [Push abonelik durumları ne zaman güncellenir?](./subscriptions#when-do-push-subscription-statuses-update%3F) bölümüne bakın.                                          |
| Uygulama İçi Gösterim            | `message.iam.impression`             | Uygulama İçi Mesaj cihazda başarıyla görüntülendi.                                                                                                                                                                            |
| Uygulama İçi Tıklandı            | `message.iam.clicked`                | Kullanıcı Uygulama İçi Mesaj'daki bir öğeye dokundu.                                                                                                                                                                          |
| Uygulama İçi Sayfa Görüntülendi  | `message.iam.page_displayed`         | Uygulama İçi Mesaj sayfası görüntülendi. Karusel takibi için yararlıdır.                                                                                                                                                      |
| E-posta Gönderildi               | `message.email.sent`                 | E-posta başarıyla gönderildi.                                                                                                                                                                                                 |
| E-posta Alındı                   | `message.email.received`             | E-posta alıcı tarafından alındı.                                                                                                                                                                                              |
| E-posta Açıldı                   | `message.email.opened`               | E-posta alıcı tarafından açıldı. Ayrıntılar için [E-posta Mesaj Raporları](./email-message-reports) bölümüne bakın.                                                                                                           |
| E-posta Bağlantısı Tıklandı      | `message.email.clicked`              | Kullanıcı e-postadaki bir bağlantıya dokundu.                                                                                                                                                                                 |
| E-postadan Abonelik İptal Edildi | `message.email.unsubscribed`         | Kullanıcı [abonelikten çıkma bağlantısı](./unsubscribe-links-email-subscriptions) aracılığıyla e-postadan aboneliğini iptal etti.                                                                                             |
| E-posta Spam Olarak Bildirildi   | `message.email.reported_as_spam`     | Kullanıcı e-postayı spam olarak bildirdi. Gmail izlemek için [Google Postmaster Tools](./google-postmaster-tools) gerektirir. Daha fazla ayrıntı için [E-posta teslim edilebilirliği](./email-deliverability) bölümüne bakın. |
| E-posta Geri Döndü               | `message.email.bounced`              | E-posta kalıcı hata nedeniyle gönderene döndü. Ayrıntılar için [E-posta Mesaj Raporları](./email-message-reports) bölümüne bakın.                                                                                             |
| E-posta Başarısız                | `message.email.failed`               | E-posta teslim edilemedi. Ayrıntılar için [E-posta Mesaj Raporları](./email-message-reports) bölümüne bakın.                                                                                                                  |
| E-posta Bastırıldı               | `message.email.suppressed`           | E-posta adresi [Bastırma listesinde](./email-deliverability) olduğu için e-posta gönderilemedi.                                                                                                                               |
| SMS Gönderildi                   | `message.sms.sent`                   | SMS alıcıya gönderildi.                                                                                                                                                                                                       |
| SMS Başarısız                    | `message.sms.failed`                 | SMS gönderilemedi. Ayrıntılar için [SMS Mesaj Raporları](./sms-message-reports) bölümüne bakın.                                                                                                                               |
| SMS Teslim Edildi                | `message.sms.delivered`              | SMS başarıyla teslim edildi.                                                                                                                                                                                                  |
| SMS Teslim Edilemedi             | `message.sms.undelivered`            | SMS gönderilemedi. Ayrıntılar için [SMS Mesaj Raporları](./sms-message-reports) bölümüne bakın.                                                                                                                               |
| Live Activity Gönderildi         | `message.live_activity.sent`         | Live Activity FCM/APNS'ye başarıyla gönderildi.                                                                                                                                                                               |
| Live Activity Teslim Edildi      | `message.live_activity.delivered`    | Live Activity alıcı tarafından alındı.                                                                                                                                                                                        |
| Live Activity Abonelik İptali    | `message.live_activity.unsubscribed` | Kullanıcı Live Activities aboneliğini iptal etti.                                                                                                                                                                             |
| Live Activity Başarısız          | `message.live_activity.failed`       | Live Activity gönderilemedi.                                                                                                                                                                                                  |
| Live Activity Tıklandı           | `message.live_activity.clicked`      | Live Activity kullanıcı tarafından tıklandı.                                                                                                                                                                                  |

### Örnek olay nesnesi

Tüm olay alanlarını yakalamak için bu Liquid şablonunu Event Stream gövdenize kopyalayın:

```json JSON theme={null}
{
  "event.kind": "{{ event.kind }}",
  "event.id": "{{ event.id }}",
  "event.timestamp": "{{ event.timestamp }}",
  "event.datetime": "{{ event.datetime }}",
  "event.app_id": "{{ event.app_id }}",
  "event.subscription_device_type": "{{ event.subscription_device_type }}",
  "event.subscription_id": "{{ event.subscription_id }}",
  "event.onesignal_id": "{{ event.onesignal_id }}",
  "event.external_id": "{{ event.external_id }}",
  "event.data.page_name": "{{ event.data.page_name }}",
  "event.data.page_id": "{{ event.data.page_id }}",
  "event.data.target_name": "{{ event.data.target_name }}",
  "event.data.target_id": "{{ event.data.target_id }}",
  "event.data.failure_reason": "{{ event.data.failure_reason }}"
}
```

<Accordion title="Örnek oluşturulmuş çıktı">
  Liquid oluşturma sonrası bir push tıklama olayının görünümü:

  ```json JSON theme={null}
  {
    "event.kind": "message.push.clicked",
    "event.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "event.timestamp": 1708559115,
    "event.datetime": "2024-02-21T23:45:15.228Z",
    "event.app_id": "your-onesignal-app-id",
    "event.subscription_device_type": "iOS",
    "event.subscription_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "event.onesignal_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "event.external_id": "user_12345",
    "event.data.page_name": "",
    "event.data.page_id": "",
    "event.data.target_name": "",
    "event.data.target_id": "",
    "event.data.failure_reason": ""
  }
  ```

  `event.data.page_name` gibi kanala özgü alanlar, bunları içermeyen olay türleri için boştur.
</Accordion>

***

## `message` özellikleri

`message` nesnesi, son kullanıcıya gönderilen mesajı (ID, şablon, içerik ve URL'ler dahil) açıklar.

<ParamField body="message.id" type="UUID">
  OneSignal tarafından oluşturulan mesaj ID'si. **Liquid:** `{{ message.id }}`
</ParamField>

<ParamField body="message.name" type="string">
  Gösterge panosunda veya API `name` özelliği kullanılarak ayarlanan mesajın adı. **Liquid:** `{{ message.name }}`
</ParamField>

<ParamField body="message.title" type="object">
  Push mesajı başlığı veya e-posta konusu. Push için `{'en':'Your title'}` gibi yerelleştirilmiş bir nesne döndürür. E-posta için konu satırını düz dize olarak döndürür. Gösterge panosu veya API `headings` / `email_subject` özellikleriyle ayarlanır. **Liquid:** `{{ message.title }}`
</ParamField>

<ParamField body="message.contents" type="object">
  Push veya SMS mesaj içeriği (50 karakterde kesilir). E-posta içerikleri (`email_body`) sağlanmaz. Gösterge panosu veya API `contents` özelliğiyle ayarlanır. **Liquid:** `{{ message.contents }}`
</ParamField>

<ParamField body="message.template_id" type="UUID">
  Journey'ler veya API `template_id` özelliği aracılığıyla gönderilen bir mesaj için şablon ID'si. **Liquid:** `{{ message.template_id }}`
</ParamField>

<ParamField body="message.url" type="string">
  Web ve uygulama bağımsız tek bir URL kullanırken mesajın başlatma URL'si. Bkz. [URL'ler, Bağlantılar ve Derin Bağlantılar](./links). **Liquid:** `{{ message.url }}`
</ParamField>

<ParamField body="message.app_url" type="string">
  Ayrı web ve uygulama URL'leri kullanırken uygulamaya özgü başlatma URL'si. Bkz. [URL'ler, Bağlantılar ve Derin Bağlantılar](./links). **Liquid:** `{{ message.app_url }}`
</ParamField>

<ParamField body="message.web_url" type="string">
  Ayrı web ve uygulama URL'leri kullanırken web'e özgü başlatma URL'si. Bkz. [URL'ler, Bağlantılar ve Derin Bağlantılar](./links). **Liquid:** `{{ message.web_url }}`
</ParamField>

<ParamField body="message.live_activity_event_kind" type="string">
  Live Activity eylem türü: `start`, `update` veya `end`. Yalnızca `message.live_activity.*` olayları için mevcuttur. **Liquid:** `{{ message.live_activity_event_kind }}`
</ParamField>

### Örnek mesaj nesnesi

Tüm mesaj alanlarını yakalamak için bu Liquid şablonunu Event Stream gövdenize kopyalayın:

```json JSON theme={null}
{
  "message.id": "{{ message.id }}",
  "message.name": "{{ message.name }}",
  "message.title": "{{ message.title }}",
  "message.contents": "{{ message.contents }}",
  "message.template_id": "{{ message.template_id }}",
  "message.url": "{{ message.url }}",
  "message.app_url": "{{ message.app_url }}",
  "message.web_url": "{{ message.web_url }}"
}
```

<Accordion title="Örnek oluşturulmuş çıktı">
  Bir push bildirimi mesajı:

  ```json JSON theme={null}
  {
    "message.id": "f3c9cd09-10d7-4f59-b9bc-66e16607f1d5",
    "message.name": "weekly-promo-push",
    "message.title": "{'en':'Flash Sale: 50% Off Today'}",
    "message.contents": "{'en':'Shop now and save on select items'}",
    "message.template_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "message.url": "https://example.com/sale",
    "message.app_url": "",
    "message.web_url": ""
  }
  ```

  Bir e-posta mesajı — `message.title` konu satırının düz dizesidir ve `message.contents` e-posta gövdesi içeriği Event Stream verilerine dahil edilmediğinden boştur:

  ```json JSON theme={null}
  {
    "message.id": "e2d3c4b5-a6f7-8901-bcde-f12345678901",
    "message.name": "onboarding-welcome-email",
    "message.title": "Welcome to Acme — here's how to get started",
    "message.contents": "",
    "message.template_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "message.url": "",
    "message.app_url": "",
    "message.web_url": ""
  }
  ```
</Accordion>

***

## `user` özellikleri

`user` nesnesi, mesajı alan kullanıcıya ait profil düzeyindeki verileri içerir.

<ParamField body="user.onesignal_id" type="string">
  Kullanıcının OneSignal ID'si. **Liquid:** `{{ user.onesignal_id }}`
</ParamField>

<ParamField body="user.external_id" type="string">
  Kullanıcının External ID'si. **Liquid:** `{{ user.external_id }}`
</ParamField>

<ParamField body="user.tags" type="object">
  Kullanıcının [etiketleri](./add-user-data-tags). Tüm nesneye `{{ user.tags }}` ile veya belirli bir etikete `{{ user.tags.your_tag }}` ile erişin. Eksik etiketleri işlemek için varsayılan değer kullanın: `{{ user.tags.your_tag | default: '' }}`.
</ParamField>

<ParamField body="user.language" type="string">
  Kullanıcının dil kodu. **Liquid:** `{{ user.language }}`
</ParamField>

***

## `subscription` özellikleri

Bu özellikler mesajı alan [aboneliği](./subscriptions) açıklar.

<ParamField body="user.subscription.id" type="string">
  Aboneliğin OneSignal ID'si. **Liquid:** `{{ user.subscription.id }}`
</ParamField>

<ParamField body="user.subscription.app_id" type="string">
  OneSignal App ID. **Liquid:** `{{ user.subscription.app_id }}`
</ParamField>

<ParamField body="user.subscription.subscription_token" type="string">
  Aboneliğin platforma özgü tokeni. **E-posta** için e-posta adresi. **SMS** için E.164 formatında telefon numarası. **Push** için push token. **Liquid:** `{{ user.subscription.subscription_token }}`
</ParamField>

<ParamField body="user.subscription.session_count" type="number">
  Bu abonelik için kaydedilen toplam oturum sayısı. **Liquid:** `{{ user.subscription.session_count }}`
</ParamField>

<ParamField body="user.subscription.language" type="string">
  Abonelikte ayarlanan dil kodu. **Liquid:** `{{ user.subscription.language }}`
</ParamField>

<ParamField body="user.subscription.game_version" type="string">
  Abonelik tarafından bildirilen uygulama veya oyun sürümü. **Liquid:** `{{ user.subscription.game_version }}`
</ParamField>

<ParamField body="user.subscription.last_active" type="number">
  Aboneliğin en son oturumunun UNIX zaman damgası. **Liquid:** `{{ user.subscription.last_active }}`
</ParamField>

<ParamField body="user.subscription.play_time" type="number">
  Bu abonelik için kaydedilen toplam oyun süresi (saniye cinsinden). **Liquid:** `{{ user.subscription.play_time }}`
</ParamField>

<ParamField body="user.subscription.amount_spent" type="number">
  Bu abonelik için kaydedilen toplam uygulama içi satın alma tutarı. **Liquid:** `{{ user.subscription.amount_spent }}`
</ParamField>

<ParamField body="user.subscription.created_at" type="number">
  Aboneliğin oluşturulduğu zamanın UNIX zaman damgası. **Liquid:** `{{ user.subscription.created_at }}`
</ParamField>

<ParamField body="user.subscription.subscribed" type="boolean">
  Aboneliğin şu anda etkin olup olmadığı. **Liquid:** `{{ user.subscription.subscribed }}`
</ParamField>

<ParamField body="user.subscription.sdk" type="string">
  Aboneliğin cihazındaki OneSignal SDK sürümü. **Liquid:** `{{ user.subscription.sdk }}`
</ParamField>

<ParamField body="user.subscription.device_model" type="string">
  Cihaz donanım modeli (örn. "iPhone14,2", "Pixel 7"). **Liquid:** `{{ user.subscription.device_model }}`
</ParamField>

<ParamField body="user.subscription.device_os" type="string">
  Cihaz işletim sistemi ve sürümü (örn. "iOS 17.2", "Android 14"). **Liquid:** `{{ user.subscription.device_os }}`
</ParamField>

***

## İlgili sayfalar

<Columns cols={2}>
  <Card title="Event Streams" icon="bolt" href="./event-streams">
    Kurulum, gövde şablonları ve hata ayıklama dahil Event Streams'i kurun ve yapılandırın.
  </Card>

  <Card title="Liquid sözdizimi kullanımı" icon="code" href="./using-liquid-syntax">
    Event Stream gövdelerini kişiselleştirmek için kullanılan Liquid sözdizimi referansı.
  </Card>

  <Card title="Uygulama içi mesaj Event Streams" icon="message" href="./iam-event-streams">
    Uygulama içi mesaj olay verileri ve karusel takibi hakkında ayrıntılar.
  </Card>

  <Card title="Metrik Sözlüğü" icon="chart-bar" href="./analytics-metrics-glossary">
    Kanallar genelinde tüm mesaj olay metriklerinin tanımları.
  </Card>
</Columns>

***

## SSS

### Neden bazı olay verileri eksik veya boş?

Journey'ler ve API gönderimleri için mesaj verileri 30 gün boyunca saklanır. Bir kullanıcı mesaj gönderildikten 30 günden fazla sonra etkileşimde bulunursa (tıklama, açma, abonelik iptali), ilgili mesaj özellikleri boş olabilir. Bunu çözmek için etkileşim olayındaki `message.id`'yi tam mesaj verilerini içeren orijinal `sent` olayıyla ilişkilendirin.

### `event.id` ile `message.id` arasındaki fark nedir?

`event.id` bireysel olay için benzersiz bir tanımlayıcıdır (örn. belirli bir tıklama). `message.id` gönderilen mesajın tanımlayıcısıdır — birden fazla olay aynı `message.id`'yi paylaşabilir (örneğin, aynı push bildirimi için bir `sent` olayı ve bir `clicked` olayı).

### Push ve e-posta için `message.title` formatı nedir?

Push bildirimleri için `message.title`, `{'en':'Your title'}` gibi yerelleştirilmiş bir nesne döndürür. E-posta için konu satırını düz dize olarak döndürür. Format kanala göre değişir.

### Özel Olaylar Event Streams'e dahil midir?

Hayır. Event Streams **mesaj olaylarını** (gönderildi, tıklandı, açıldı, geri döndü vb.) içerir — [Özel Olayları](./custom-events) değil. Özel Olaylar, OneSignal'a *gönderdiğiniz* kullanıcı eylemleridir. Event Streams, mesaj teslimi ve etkileşim verilerini OneSignal'dan *dışa aktarır*.

### Event Stream gövdemde belirli bir etikete nasıl başvurabilirim?

Tam etiket anahtarıyla `{{ user.tags.your_tag_key }}` kullanın. Bir etiket ayarlanmadığında hataları önlemek için varsayılan değer ekleyin: `{{ user.tags.your_tag_key | default: '' }}`. Daha fazla ayrıntı için [Liquid sözdizimi kullanımı](./using-liquid-syntax) bölümüne bakın.

***