Ana içeriğe atla
Ö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.
Önemli: Özel takma adları kullanmadan önce bir Harici Kimlik 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 arasında tutarlı kalır.Özel takma adlar Abonelikleri birbirine bağlamaz—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.

​
Ö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’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: 
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 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: 
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.
Özel takma adlar öğreticisi tamamlandı! Sonraki adımlar:
  • Henüz yapmadıysanız Kullanıcılar ve Abonelikler belgelerimizi inceleyin.
  • API aracılığıyla takma adları kullanma hakkında daha fazla ayrıntı için REST API belgelerimizi keşfedin.
  • Sistemler arasında kullanıcı verilerini senkronize etmek için Entegrasyonlar’ı kurun.