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

# Takma Adlar

> Kendi benzersiz tanımlayıcılarınızı kullanarak farklı platformlar ve cihazlar arasında kullanıcıları tanımlamak ve izlemek için OneSignal'da özel takma adları nasıl kullanacağınızı öğrenin. Takma adlar, birden fazla kaynaktan kullanıcı verilerini birleştirmeye yardımcı olur ve entegrasyonlar, kullanıcı veri yönetimi ve işlemsel mesajlaşma için gereklidir.

Özel takma adlar, kendi dahili kimliklerinizi kullanarak çapraz platform kullanıcı takibi ve tanımlamayı etkinleştirerek OneSignal'daki kullanıcılara özel anahtar-değer tanımlayıcıları atamanıza olanak tanır.

<Warning>
  **Önemli**: Özel takma adları kullanmadan **önce** bir [Harici Kimlik](./users) ayarlamalısınız.

  OneSignal, kullanıcıları tanımlamak için benzersiz bir `onesignal_id` kullanır. Bu kimlik, yalnızca aynı `external_id`'ye sahipse [Abonelikler](./subscriptions) arasında tutarlı kalır.

  Özel takma adlar Abonelikleri birbirine bağla**maz**—doğru çalışmak için `external_id`'ye güvenirler. Bu olmadan, takma adlar cihazlar veya platformlar arasında aynı kullanıcıyla ilişkilendirilmeyecektir.
</Warning>

***

## Özel takma ad nedir?

Özel takma ad, şu şekilde bir `anahtar : değer` çiftidir:

* `alias_label` (anahtar), tüm kullanıcılar arasında tutarlı, statik bir tanımlayıcıdır (örn. `facebook_id`, `firebase_id`, `crm_user_id`).
* `alias_id` (değer), o etiket için belirli kullanıcının kimliğidir (örn. `facebook_id: 3453443`, `firebase_id: test3555`).

Bu, OneSignal kullanıcı kayıtlarını diğer platformlarınızdan veya veritabanlarınızdan tanımlayıcılara bağlamanıza olanak tanır.

***

## Takma adları neden kullanmalısınız?

1. Kullanıcıları birden fazla platform ve veritabanı arasında tanımlayın.
2. [Mesaj Oluşturma REST API](/reference/create-message)'sini kullanarak hedefli işlemsel mesajlar gönderin.
3. Kullanıcı REST API'leri aracılığıyla kullanıcıları alın, güncelleyin veya silin.

***

## Takma Adları Nasıl Ayarlanır

Takma adları OneSignal SDK'sını kullanarak veya REST API aracılığıyla ayarlayabilirsiniz.

### SDK Kullanımı

Uygulamanızda şu adımları izleyin:

1. Harici Kimliği Ayarlayın
   Kullanıcı kaydını ilişkilendirmek için `OneSignal.login(externalId)`'yi çağırın.

2. Özel takma adları ayarlayın
   Tek bir takma ad eklemek için `OneSignal.User.addAlias(label, id)` veya birden fazla ayarlamak için `OneSignal.User.addAliases({ label1: id1, label2: id2 })` kullanın.

3. Çıkış yapın (isteğe bağlı)
   O cihaz veya oturum için harici kimliği ve ilişkili takma adları kaldırmak için `OneSignal.logout()` kullanın.

**Örnek**:

```javascript theme={null}
OneSignal.login("user_123");

OneSignal.User.addAliases({
  facebook_id: "3453443",
  firebase_id: "test3555"
});

// Daha sonra, kullanıcı çıkış yaptığında
OneSignal.logout();
```

***

### REST API Kullanımı

API aracılığıyla özel takma adlar ayarlamak için [Takma Ad Oluştur](/reference/create-alias) uç noktasını kullanın. Bu yöntem genellikle sunucu tarafı kullanıcı yönetimi için arka uç sistemlerinde kullanılır.

**Örnek İstek**:

```json theme={null}
POST /aliases
{
  "subscription_id": "abc123",
  "aliases": {
    "facebook_id": "3453443",
    "crm_user_id": "XYZ789"
  }
}
```

***

## En İyi Uygulamalar

* Herhangi bir takma ad atamadan önce her zaman `external_id`'yi ayarlayın.
* Ekipler arasında karışıklığı önlemek için istikrarlı, açıklayıcı etiketler kullanın (örn. `crm_user_id`, `legacy_user_id`).
* Takma ad değerleri olarak e-posta adresleri veya telefon numaraları gibi hassas bilgileri kullanmaktan kaçının.
* Cihaz çıkışı veya kullanıcı değiştirme olaylarında takma adları temizlemek için `logout()` kullanın.

***

<Check>
  Özel takma adlar öğreticisi tamamlandı!
  Sonraki adımlar:

  * Henüz yapmadıysanız [Kullanıcılar](./users) ve [Abonelikler](./subscriptions) belgelerimizi inceleyin.
  * API aracılığıyla takma adları kullanma hakkında daha fazla ayrıntı için [REST API](/reference/create-alias) belgelerimizi keşfedin.
  * Sistemler arasında kullanıcı verilerini senkronize etmek için [Entegrasyonlar](./integrations)'ı kurun.
</Check>

***