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

# Kullanıcılar

> OneSignal'de Kullanıcıların nasıl çalıştığını, kullanıcı tanımlama, OneSignal ID, External ID ve Aboneliklerin ve kullanıcı özelliklerinin kanallar genelinde nasıl yönetildiğini anlayın.

## Genel Bakış

OneSignal'de bir **Kullanıcı**, mesajlaşma kanallarınız (mobil push, web push, e-posta ve SMS) genelinde bir veya daha fazla [Aboneliği](./subscriptions) olan bir bireyi temsil eder.

* Her Kullanıcı en fazla **20 Aboneliğe** sahip olabilir.
* Her Kullanıcıya otomatik olarak bir **OneSignal ID** (UUID v4) atanır.
* Kullanıcılar, onlara bir **External ID** atanana kadar **anonim** olarak başlar. External ID atamak Abonelikleri birbirine bağlar ve kullanıcı uygulamanızda zaten varsa mevcut OneSignal ID'yi değiştirebilir.
* **Kullanıcılar ve Aboneliklerin farklı özellikleri vardır.** Örneğin, **Etiketler** Kullanıcı düzeyinde saklanırken, **abonelik durumu** (katılım/çıkış) Aboneliğe aittir.
* Kullanıcı bağlamı değiştiğinde — örneğin, giriş yapma (anonim → tanımlanmış) veya hesap değiştirme (KullanıcıA → KullanıcıB) — **Abonelik eski Kullanıcıdan yenisine yeniden atanır**.
  * Abonelik artık yeni Kullanıcının özelliklerini devralacaktır.
  * Önceki Kullanıcıya bağlı özellikler (Etiketler, dil veya External ID gibi) artık geçerli olmayacaktır.

**Örnek:**

* KullanıcıA, `premium=true` Etiketi'ne sahip
* KullanıcıB, `premium=false` Etiketi'ne sahip
* Bir Abonelik KullanıcıA'dan KullanıcıB'ye geçerse, artık `premium=true` ile ilişkilendirilmeyecek ve bunun yerine KullanıcıB'nin özelliklerini yansıtacaktır.

<Frame>
  <iframe width="560" height="315" src="https://www.youtube.com/embed/yZM6zn7nLDw?si=oT7ncbhX0sNtmKML" 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>

### Anonim ve tanımlanmış kullanıcılar

* **Anonim kullanıcı:** External ID'ye sahip değil → her Abonelik kendi OneSignal ID'sine sahip ayrıdır (ayrı Kullanıcılar olarak değerlendirilir).
* **Tanımlanmış kullanıcı:** External ID'ye sahip → OneSignal tüm Abonelikleri tek bir OneSignal ID altında birleştirir.

**Örnek: Anonim kullanıcı**

* Web push Aboneliği → `OneSignal_ID_1`
* Mobil Abonelik → `OneSignal_ID_2`
* E-posta Aboneliği → `OneSignal_ID_3`
* SMS Aboneliği → `OneSignal_ID_4`
* **Sonuç:** Dört Kullanıcı (her Abonelik benzersiz özelliklere sahip ayrı bir Kullanıcıdır)

**Örnek: Tanımlanmış kullanıcı**

* `External_ID_A` External ID'sine sahip Web push Aboneliği → `OneSignal_ID_1`
* Aynı `External_ID_A` ile Mobil Abonelik → `OneSignal_ID_1`'e birleştirildi
* Aynı `External_ID_A` ile E-posta Aboneliği → `OneSignal_ID_1`'e birleştirildi
* Aynı `External_ID_A` ile SMS Aboneliği → `OneSignal_ID_1`'e birleştirildi
* **Sonuç:** Dört Aboneliği olan Bir Kullanıcı (tümü aynı Kullanıcıya bağlı)

<Note>
  Her zaman bir External ID atayın. Bu, kanallar ve cihazlar genelindeki Aboneliklerin tek bir Kullanıcı profili altında birleşmesini sağlar ve çoğaltmayı önler.

  * Kararlı, genel olmayan tanımlayıcılar kullanın (örneğin, dahili kullanıcı kimliğiniz veya e-posta adresiniz).
  * Uygulama yaşam döngünüzün başlarında `OneSignal.login` çağrısı yapın.
</Note>

***

## Kullanıcı özellikleri

| Özellik                | Açıklama                                                                                                                                                                                                                           |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **External ID**        | Kullanıcıyı sisteminizle birleştirmek için atadığınız benzersiz tanımlayıcı.                                                                                                                                                       |
| **OneSignal ID**       | Her kullanıcı için OneSignal tarafından otomatik oluşturulan UUID v4. External ID atandığında değişebilir.                                                                                                                         |
| **Takma Adlar**        | `mixpanel_id : 1234` gibi anahtar-değer çiftleri. [Takma Adlar](./aliases)'a bakın.                                                                                                                                                |
| **Kanal**              | Kullanıcının sahip olduğu [Abonelikler](./subscriptions), Push, E-posta veya SMS gibi.                                                                                                                                             |
| **Ülke**               | [ISO 3166-1 Alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) formatında ülke kodu.                                                                                                                                       |
| **E-posta**            | En son E-posta Aboneliğinden gelen e-posta.                                                                                                                                                                                        |
| **İlk oturum**         | Kullanıcının OneSignal'de ilk oluşturulduğu zaman.                                                                                                                                                                                 |
| **IP Adresi**          | En son güncellenmiş Abonelikten.                                                                                                                                                                                                   |
| **Dil**                | [ISO 639-1 formatında](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes) kullanıcının dili. API veya `setLanguage` aracılığıyla güncellenebilir.                                                                       |
| **Son oturum**         | Uygulama etkileşiminin en son zaman damgası.                                                                                                                                                                                       |
| **Konum**              | Mobil aboneliklerin GPS koordinatları (konum takibi etkinse). [Konuma Dayalı Bildirimler](./location-triggered-event)'e bakın.                                                                                                     |
| **Telefon**            | En son SMS Aboneliğinden gelen telefon numarası.                                                                                                                                                                                   |
| **Etiketler**          | Özel meta veriler (örneğin tercihler, davranış). [Veri Etiketleri](./add-user-data-tags)'ne bakın.                                                                                                                                 |
| **Test Kullanıcı adı** | Bir Kullanıcıyı test kullanıcısı olarak işaretlerken atanan etiket. Kontrol paneli veya API'deki `test_user_name` özelliği aracılığıyla ayarlanır. [Test Abonelikleri](./find-set-test-subscriptions#test-subscriptions)'ne bakın. |
| **Saat Dilimi**        | SDK tarafından ayarlanan [IANA TZ formatında](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones) `timezone_id`. API aracılığıyla güncellenebilir.                                                                       |

## OneSignal ID

**OneSignal ID**, bir kullanıcıyı benzersiz şekilde temsil etmek için oluşturulan dahili bir UUID v4'tür. Şu gibi senaryolarda otomatik olarak oluşturulur:

* İlk kez mobil uygulama açılışı (veya yeniden yükleme sonrası)
* Yeni web push Aboneliği
* [Create user](/reference/create-user) veya [CSV Import](./import) aracılığıyla Kullanıcı/Abonelik oluşturma
* Tarayıcı önbelleğini temizleme ve siteye geri dönme
* `OneSignal.logout` ile çıkış yapma

`OneSignal.login` aracılığıyla bir **External ID** kullanıldığında, mevcut Aboneliğe bağlı olan mevcut OneSignal ID, o External ID ile ilişkili olanla değiştirilir. Platformlar genelinde (Push, E-posta, SMS) Abonelikler, aynı External ID'yi paylaşıyorlarsa aynı OneSignal ID altında birleştirilecektir.

### Yeniden atama ve davranış

Bir kullanıcı uygulamayı yeniden yüklerse veya önbelleği temizlerse, yeni bir OneSignal ID ve Abonelik oluşturulur. Ancak, `OneSignal.login` çağrısı yapmak yeni Aboneliği orijinal kullanıcı profiline geri bağlar.

`OneSignal.User.addEmail` veya `addSms` aracılığıyla eklenen Abonelikler, mevcut OneSignal ID'yi devralacaktır.

SDK referansları:

* [Mobil SDK Referansı](./mobile-sdk-reference)
* [Web SDK Referansı](./web-sdk-reference)

## External ID

**External ID**, kullanıcıları cihazlar ve abonelikler genelinde izlemek için atadığınız benzersiz bir string'dir.

<Frame caption="Kullanıcıyı abonelikleri genelinde izlemek için External ID'yi kullanın.">
  <img src="https://mintcdn.com/onesignal/RWtLFPeffHrC81wI/images/docs/a30870df69f4545ec68fc9ff9902784b35ede0dd0ce7b3a5b03b8acb6bb1c748-eid.png?fit=max&auto=format&n=RWtLFPeffHrC81wI&q=85&s=bcb07ae72a25e91288a5034a3e0ecb17" width="560" height="452" data-path="images/docs/a30870df69f4545ec68fc9ff9902784b35ede0dd0ce7b3a5b03b8acb6bb1c748-eid.png" />
</Frame>

External ID'yi şu yollarla ayarlayabilir veya kaldırabilirsiniz:

* `OneSignal.login` - **Önerilen** [Mobil SDK](./mobile-sdk-reference#login-external-id) ve [Web SDK](./web-sdk-reference#login-external-id)'ye bakın
* [Create user API](/reference/create-user)
* [Transfer subscription API](/reference/transfer-subscription)
* `OneSignal.logout` (kaldırmak için)

### Kısıtlı ID'ler

External ID'ler için yer tutucu değerler veya geçici değerler kullanmayın.

Aşağıdaki değerler External ID'ler için kullanılamaz:

* `NA`
* `NULL`
* `-1`
* `0`
* `1`
* `all`
* `00000000-0000-0000-0000-000000000000`

***

## Aynı cihazda birden fazla kullanıcı

Birden fazla kullanıcı bir cihazı paylaştığında, her yeni giriş farklı bir External ID ile `OneSignal.login` çağrısını tetiklemelidir. Bu, OneSignal ID'yi ve Aboneliği yeni kullanıcıya yeniden atar.

Çıkış işlemini yönetmek için, kullanıcı bağlamını kaldırmak için aşağıdakileri yapabilirsiniz:

* `OneSignal.logout()` çağrısı yapın → External ID'yi temizler, önceki kullanıcı özelliklerini (Etiketler, Takma Adlar, vb.) kaldırır ve anonim OneSignal ID atar.
* İsteğe bağlı olarak `optOut` kullanarak bildirimleri devre dışı bırakın ve tekrar giriş yaparken `optIn` ile yeniden etkinleştirin.

***

## Aylık aktif kullanıcılar (MAU)

MAU, **faturalandırma** için kullanılır ve 30 günlük faturalandırma dönemi içinde son oturumu olan bir mobil [Abonelik](./subscriptions) olarak tanımlanır. Bu şunları içerir:

* SDK'mız aracılığıyla bir mobil Abonelik oluşturarak uygulamanızı ilk kez açan kullanıcılar
* Uygulamayı yeniden yükleyen ve tekrar açan, SDK'mız aracılığıyla başka bir mobil Abonelik oluşturan kullanıcılar
* API'miz aracılığıyla içe aktarılan kullanıcılar

### MAU faturalandırma örneği

Bir Kullanıcının şu Abonelikleri varsa:

* iOS mobil (son 30 günde etkin)
* Android mobil (son 30 günde etkin)
* Web push
* E-posta
* SMS

Yalnızca iOS ve Android mobil Abonelikler sayılır, bu da **2 MAU** ile sonuçlanır.

Abonelik durumu MAU faturalandırması için önemli değildir.

### MAU'ları azaltma (örneğin, ödeme duvarı kullanım durumları)

Mobil SDK [gizlilik yöntemlerini](./mobile-sdk-reference#privacy) kullanarak SDK başlatmayı ve Abonelik oluşturmayı geciktirebilirsiniz.

1. SDK'yı başlatmadan önce `setConsentRequired()` çağrısı yapın – bu, Aboneliğin otomatik oluşturulmasını önler
2. Kullanıcı için bir Abonelik oluşturmaya hazır olduğunuzda `setConsentGiven()` çağrısı yapın

***
