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

# Etiketler

> Gelişmiş segmentasyon ve kişiselleştirilmiş mesajlaşma için kullanıcı özelliklerini depolamak ve olayları izlemek üzere OneSignal Veri Etiketlerini kullanın.

Veri Etiketleri, OneSignal'da özel özellikleri depolamanıza ve kullanıcı davranışını izlemenize olanak tanıyan anahtar-değer çiftleridir. Güçlü segmentasyon ve kişiselleştirmeyi mümkün kılarlar.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/t82DSCUXShk?si=KH_u3zB2N5ci8GLT" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

Etiketleri şunlar için kullanın:

* `subscription_tier` veya `name` gibi kullanıcı özelliklerini depolama
* `purchases`, `clicks` veya `levels` gibi davranışları izleme
* Mesajlar ve Journeys için kullanıcıları segmentlere ayırma
* Mesaj içeriğini kişiselleştirme

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/Z-rYqwEUU0M?si=Qjx2dMdFXwXSuZJR" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

***

## Veri Etiketi Değer Biçimlendirme Kuralları

Tüm Etiket değerleri **dizeler** olmalıdır. Yine de sayıları, zaman damgalarını ve boolean benzeri değerleri depolayabilirsiniz—sadece bunları dizeye dönüştürün!

| Değer Türü    | Biçim Örneği                        | Notlar                                                                                     |
| ------------- | ----------------------------------- | ------------------------------------------------------------------------------------------ |
| Dize Etiketi  | `"free"`, `"VIP"`                   | Kullanıcı türleri, ayrıcalıklar, durumlar için                                             |
| Sayı          | `"42"`, `"3.14"`                    | Sayısal filtreleri etkinleştirir (`büyüktür`, `küçüktür`)                                  |
| Zaman Damgası | `"1685400000"`                      | Unix zaman damgası (saniye cinsinden). [Zaman Operatörleri](./time-operators) ile kullanın |
| Boolean       | `"true"` / `"false"`, `"1"` / `"0"` | Yük boyutunu azaltmak için `"1"`/`"0"` kullanın                                            |

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/YTp-jLcajJ0?si=uSRn2cQ7Yur5MAp0" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<Warning>
  **Desteklenmez:** Diziler, nesneler, iç içe değerler veya JSON blob'ları. Karmaşık verileri depolamanız gerekiyorsa, [Özel Olaylar](./custom-events)'ı kullanın.
</Warning>

### Kısıtlı Anahtar Kelimeler

Aşağıdaki anahtar kelimeler kısıtlıdır ve etiket anahtarları olarak kullanılmamalıdır çünkü mesaj kişiselleştirme için dahili olarak kullanılırlar:
`message`, `notification`, `subscription`, `user`, `template`, `app`, `org`, `dynamic_content`, `data_feed`, `journey`, `custom_data`

Daha fazla ayrıntı için [Mesaj Kişiselleştirme](./message-personalization) bölümüne bakın.

### Etiketler vs Özel Olaylar

[Tags](/docs/en/add-user-data-tags) and [Custom Events](/docs/en/custom-events) are both ways to add data to your users. However, there are some key differences:

| Feature        |                   Tags                   |                                          Custom Events                                         |
| -------------- | :--------------------------------------: | :--------------------------------------------------------------------------------------------: |
| Data usage     |     Segmentation and personalization     | Trigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys |
| Data retention |                 Lifetime                 |        30+ days ([lifetime storage is available](/docs/en/billing-faq#streaming-events))       |
| Data format    |       Key-value strings or numbers       |                                              JSON                                              |
| Data source    |     OneSignal SDK, API, or CSV import    |                               OneSignal SDK, API, or integrations                              |
| Data access    | Segmentation and message personalization |        Journeys 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

***

## Önerilen Etiket Stratejileri

Veri Etiketleri, **mesajlarda veya hedef kitle segmentasyonunda kullanmak** istediğiniz bilgileri temsil etmelidir. Tam kullanıcı profilleri veya günlükleri depolamak için değildirler—bunun için arka uç veritabanınızı kullanın.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/DeCnQYA21TY?si=YnAv50tpiiVdNEX7" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

### Olaya Dayalı Davranış Etiketleri

Kullanıcı eylemlerini etiketlerle izleyin. Journeys'leri, takipleri veya hatırlatmaları tetiklemek için harikadır.

| Key               | Value Example              | Description                                                                     |
| ----------------- | -------------------------- | ------------------------------------------------------------------------------- |
| `cart_update`     | `"1685400000"`             | Last time user added something to cart. Use [Time Operators](./time-operators). |
| `last_order`      | `"1684100000"`             | Last completed purchase timestamp                                               |
| `amount_spent`    | `"100"`                    | Total spent—stringified number, no currency symbol                              |
| `social_share`    | `"2"`                      | Count of social shares or referrals                                             |
| `tutorial_status` | `"step2"` or `"completed"` | Tutorial progress—use readable or numbered string values                        |

### Oyun Aktivitesi Etiketleri

Oyunlar tarafından kullanıcı performansına göre kişiselleştirmek için kullanılır.

| Key          | Value Example | Description               |
| ------------ | ------------- | ------------------------- |
| `points`     | `"1250"`      | Experience or game points |
| `level`      | `"8"`         | Current game level        |
| `high_score` | `"3000"`      | Highest score achieved    |

### Hesap Durumu Etiketleri

Kullanıcıları hesap katmanına veya durum değişikliğine göre hedeflemek için bunları kullanın.

| Key               | Value Example           | Description                       |
| ----------------- | ----------------------- | --------------------------------- |
| `user_type`       | `"free"`, `"premium"`   | Subscription or access tier       |
| `has_downgraded`  | `"1"` or `"1685400000"` | Boolean or timestamp of downgrade |
| `user_privileges` | `"admin"`, `"guest"`    | Role-based segmentation           |

<Note>
  Bireysel kullanıcıları tanımlamak için **Harici Kimlik** kullanın. Bu amaç için etiketleri kullan**mayın**. [Harici Kimlik](./users#external-id) ve [Takma Adlar](./aliases)'a bakın.
</Note>

### Kişiselleştirme Etiketleri

[Değişken Değiştirme](./message-personalization) kullanarak ada dayalı mesaj özelleştirmesi için harikadır.

| Key          | Value Example     | Description            |
| ------------ | ----------------- | ---------------------- |
| `first_name` | `"Jon"`           | First name             |
| `last_name`  | `"Smith"`         | Last name              |
| `user_name`  | `"PokeCatcher22"` | Display or screen name |

### Konum ve Demografik Etiketler

Kullanıcıları bölgeye veya yaşa göre segmentlere ayırın.

| Key          | Value Example   | Description                                                                       |
| ------------ | --------------- | --------------------------------------------------------------------------------- |
| `region`     | `"New York"`    | Metro area, optionally use [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) |
| `postcode`   | `"94105"`       | Zip or postal code                                                                |
| `location`   | `"Downtown LA"` | Custom string location                                                            |
| `birthdate`  | `"915148800"`   | Unix timestamp in seconds (birth date)                                            |
| `birth_year` | `"1998"`        | Four-digit birth year                                                             |
| `age_range`  | `"18-35"`       | Useful for general audience segmentation                                          |

## Etiketleri Ekleme, Güncelleme ve Kaldırma

Kullanım durumunuza ve teknik kurulumunuza bağlı olarak aşağıdaki yöntemlerden herhangi birini kullanarak Etiketleri yönetebilirsiniz.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/e5B3nJyr_ao?si=PfVu4bHMkQJydc41" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

<br />

<Columns cols={2}>
  <Card title="SDK Methods (Recommended)">
    Set tags in real time from your app or website as users perform actions.

    * → [Mobile SDK Reference](./mobile-sdk-reference#data-tags)
    * → [Web SDK Reference](./web-sdk-reference#data-tags)
  </Card>

  <Card title="REST API" href="/reference/update-user">
    Add, update, or remove tags server-side using our REST API.
  </Card>

  <Card title="Journeys" href="./journeys-overview">
    Automatically apply tags as users move through Journey steps.
  </Card>

  <Card title="CSV Import" href="./import">
    Bulk update Tags by uploading a CSV with `external_id` or `subscription_id`.
  </Card>

  <Card title="Web Category Prompts" href="./permission-requests">
    Prompt users to self-select interests, which are stored as tags.
  </Card>

  <Card title="In-App Messages" href="./in-app-messages-setup">
    Collect or update tags based on in-app message click actions.
  </Card>

  <Card title="Manual Entry">
    Directly edit tags from the OneSignal Dashboard.

    * Go to **Audience > Users > User Profile > Tags**
  </Card>

  <Card title="Third-Party Integrations" href="./integrations">
    Some integrations support syncing tags automatically.

    * Segment, HubSpot, Mixpanel, and others
  </Card>
</Columns>

***

## SSS

### Kullanıcı başına kaç etiket ayarlayabilirim?

Planınıza bağlıdır. [Plan limitlerini](https://onesignal.com/pricing) görün veya kotanızı artırmak için [satış ekibiyle iletişime geçin](https://onesignal.com/contact).

### Plan limitlerini aşarsam etiketlerime ne olur?

Bir OneSignal uygulaması içinde mevcut etiket sayısında limit yoktur. Limit, her bir kullanıcı üzerinde aynı anda kaç etiketin ayarlanabileceğine uygulanır.

Limitinde veya üzerinde olan kullanıcılar için etiketleri **ekleyemez veya güncelleyemezsiniz**. Önce etiketleri silmeli, ardından yenilerini eklemek için ikinci bir istek göndermelisiniz.

Zaten ayarlanmış etiketler kalıcı olacaktır.

Örnek:

Plan limitiniz = kullanıcı başına 20 etiket.

* Kullanıcının 19 etiketi var:
  * ✅ 1 yeni etiket ekle = başarılı
  * ❌ 2+ yeni etiket ekle = başarısız
* Kullanıcının 20 etiketi var:
  * ❌ Herhangi bir yeni etiket ekle = başarısız
  * ✅ 1+ mevcut etiketi güncelle = başarılı

### Etiket kullanımını nerede kontrol edebilirim?

* Kontrol Paneli: **Hedef Kitle > Kullanıcılar > Etiketler sütunu**
* Tam görünüm için [kullanıcıları dışa aktarın](./exporting-data)

### Etiket kullanımını nasıl azaltırım?

* SDK veya API kullanarak etiketleri kaldırın
* Toplu silme için [CSV İçe Aktarma](./import)'yı kullanın
* Daha az, daha yeniden kullanılabilir etiketler kullanın (örn. `status:active`)

<Info>
  Need help?

  Chat with our Support team or email `support@onesignal.com`

  Please include:

  * Details of the issue you're experiencing and steps to reproduce if available
  * Your OneSignal App ID
  * The External ID or Subscription ID if applicable
  * The URL to the message you tested in the OneSignal Dashboard if applicable
  * Any relevant [logs or error messages](/docs/en/capturing-a-debug-log)

  We're happy to help!
</Info>

***