Kullanıcı Kimliklendirme

identify, traits ve id uzunluk sözleşmesi

Kimliklendirme, Selwise'in anonim bir tarayıcıyı gerçek bir müşteriyle eşleştirmesini sağlar. Müşteri seviyesindeki her özellik buna dayanır.

Neden gerekli

Kimliklendirme olmadan Selwise yalnızca cihazları tanır. Aynı müşteri telefondan ve bilgisayardan girdiğinde iki ayrı kişi görünür.

ÖzellikKimliksizKimlikle
Müşteri yaşam boyu değeriCihaz başına bölünmüşGerçek toplam
"3+ sipariş vermiş" segmentiEksik yakalarDoğru
Kişisel önerilerYalnızca o cihazın geçmişiTüm geçmiş
Müşteri profiliParçalıTam
include modlu segment hedeflemeNeredeyse hiç eşleşmezÇalışır

Ne zaman çağrılır

identify şu anlarda çağrılmalıdır:

AnNeden
Kullanıcı giriş yaptığındaAna kullanım
Sayfa yüklendiğinde, kullanıcı zaten giriş yapmışsaOturum devam ediyor
Kayıt tamamlandığındaYeni müşteri

Sonuncusu unutulur: kayıt sonrası çağrılmazsa yeni müşteri bir sonraki girişine kadar anonim kalır.

Kullanım

window.Selwise?.identify('MUSTERI-1001', {
  plan: 'premium',
  sehir: 'İstanbul',
});

İlk parametre kimlik, ikincisi isteğe bağlı özelliklerdir. Metot imzası ve dönüş değeri: JavaScript API. Çağrı { success, merged } döndürür: merged: true, bu çağrıda yeni bir cihazın (ziyaretçi kimliğinin) müşteriye bağlandığını söyler. HTTP karşılığı ve hata durumları: Kullanıcı Kimliklendirme API'si.

Kimliği değiştirmeden yalnızca özellik güncellemek için setTraits kullanın. setTraits tanınmış bir müşteri gerektirir: o tarayıcıda daha önce identify çağrılmamışsa false döner ve hiçbir şey yazılmaz.

E-posta adresi

İkinci parametrede email alanı bir özellik değildir; kişinin kimliğine bağlanır:

window.Selwise?.identify('MUSTERI-1001', { email: 'ayse@example.com' });
  • Adres sunucuda karma olarak kimliğe yazılır. Farklı cihazlarda aynı e-postayla gelen kişi aynı profilde buluşur.
  • Adres, kişinin iletişim kaydına izinsiz olarak eklenir: kişiye ulaşılabilir olduğunu söyler, pazarlama izni yerine geçmez.
  • Adres, özellikler arasında ve olay kayıtlarında düz metin olarak saklanmaz.
  • Adres gibi görünmeyen bir değer (örneğin önceden karma alınmış bir metin) yok sayılır.

Her sayfada çağırmak

Giriş yapmış kullanıcının kimliğini her sayfa şablonuna yazan platformlarda identify her sayfada çağrılabilir. Aynı kişi, aynı tarayıcı ve aynı adres için sunucunun onayladığı ikinci çağrı istek atmaz. Kimlik veya adres değiştiğinde çağrı yeniden gönderilir.

Çıkış

Kullanıcı çıkış yaptığında data layer'a bir çıkış olayı gönderin:

window.selwiseLayer = window.selwiseLayer || [];
window.selwiseLayer.push({ event: 'user_logout' });

Bu, çıkış olayını kaydeder ve tarayıcıdaki kullanıcı kimliğini unutur; sonraki olaylar ve siparişler artık o kişiye yazılmaz. Ziyaretçi kimliği korunur, bu yüzden deney atamaları ve sıklık sınırları değişmez.

Kendi dataLayer'ınızdaki login veya sign_up olayını Selwise'in giriş ya da kayıt olayına eşlediyseniz ve olay user_id taşıyorsa, kimliklendirme otomatik yapılır. Eşlenmiş bir çıkış olayı da kimliği unutturur.

Kimlik olarak ne gönderilmeli

GönderinGöndermeyin
Sistem içi müşteri kimliği (12345, MUSTERI-1001)Düz e-posta adresi
Kararlı bir UUIDOturum kimliği
—Sepet kimliği

Kimlik kararlı olmalı

Kullanıcı her giriş yaptığında değişen bir değer (oturum kimliği gibi) gönderirseniz her giriş yeni bir müşteri oluşturur ve müşteri verisi anlamsızlaşır. Kimlik, kişinin ömrü boyunca aynı kalmalıdır.

Uzunluk sınırı: 64 karakter

Kimlik en fazla 64 karakter olabilir. Bu, platform genelinde tek bir sınırdır ve giriş noktalarında doğrulanır.

Daha uzun bir kimlik gönderirseniz istek reddedilir ve hata mesajı sınırı söyler.

Bu sınır neden var

Sipariş ve event tablolarındaki kimlik sütunları 64 karakterdir. Daha önce kimliklendirme daha uzun değerleri kabul ediyor, sonra o kullanıcının ilk siparişinde veritabanı hatası veriyordu. Sınırı giriş noktasına taşımak, hatayı sessiz bir başarısızlıktan anlaşılır bir doğrulama mesajına çevirdi.

Kimliğiniz daha uzunsa kısa ve kararlı bir türev üretin (örneğin kimliğin karmasının ilk 32 karakteri) ve her yerde aynısını kullanın.

Cihazlar nasıl birleşir

identify çağrıldığında, o andaki ziyaretçi kimliği müşteri profiline bağlanır. Aynı kimlikle başka bir cihazdan çağrıldığında o cihaz da aynı profile bağlanır ve geçmişleri birleşir.

Birleşme geriye dönük çalışır: kullanıcı giriş yapmadan önce yaptığı gezinme de profile eklenir.

Müşteri numarası tarayıcıdan geldiği için birleşmenin sınırları var:

  • Bir müşteriye aynı ağdan (aynı ev ya da ofis bağlantısı) bir haftada en fazla 5 tarayıcı bağlanır; fazlası kimliklenir ama profile birleşmez. Telefon, bilgisayar ve tablet bunun çok altında kalır.
  • Bir tarayıcı bir günde en fazla 5 farklı müşteri numarasıyla tanıtılabilir; fazlası 429 alır.
  • Profilde kayıtlı e-posta imzasız bir çağrıyla değişmez.

Müşteri numarasının gerçekten sizin sunucunuzdan geldiğini kanıtlamak ve bu sınırların ötesinde koruma için: İmzalı Kimlik.

Sipariş verisiyle tutarlılık

Sipariş gönderirken kullandığınız müşteri kimliği ile identify ile gönderdiğiniz kimlik aynı olmalıdır. Farklıysa siparişler müşteriye bağlanmaz ve profil boş görünür.

Sipariş gönderimi: Sipariş Takibi.

Kurulumu doğrulama

  1. Sitenizde giriş yapın.
  2. Panelde Site Users sayfasını açın.
  3. Kendi profilinizin oluştuğunu görün.
  4. Bir test siparişi verin ve profile bağlandığını kontrol edin.

Bu üç adım, kimliklendirmenin çalıştığının en hızlı kanıtıdır.

Onay ile ilişkisi

identify çağrısı çerez onayı denetiminden geçmez: widget onu ziyaretçinin onay durumuna bakmadan sunucuya gönderir. Onay denetimine takılan, çağrının ürettiği identify olayıdır (diğer olaylar gibi, onay gelene kadar bekletilir). Onay vermemiş bir ziyaretçiyi ne zaman kimliklendireceğiniz sizin hukuki değerlendirmenizdir; denetimi isteyen mağazalar çağrıyı onay verildikten sonra yapar:

// onay banner'ınızın "kabul" işleyicisinde
window.Selwise?.grantConsent();
window.Selwise?.identify('MUSTERI-1001');

Bkz. Onay Yönetimi.

Son güncelleme: 23 Ekim 2026