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.
| Özellik | Kimliksiz | Kimlikle |
|---|---|---|
| Müşteri yaşam boyu değeri | Cihaz başına bölünmüş | Gerçek toplam |
| "3+ sipariş vermiş" segmenti | Eksik yakalar | Doğru |
| Kişisel öneriler | Yalnızca o cihazın geçmişi | Tüm geçmiş |
| Müşteri profili | Parçalı | Tam |
include modlu segment hedefleme | Neredeyse hiç eşleşmez | Çalışır |
Ne zaman çağrılır
identify şu anlarda çağrılmalıdır:
| An | Neden |
|---|---|
| Kullanıcı giriş yaptığında | Ana kullanım |
| Sayfa yüklendiğinde, kullanıcı zaten giriş yapmışsa | Oturum devam ediyor |
| Kayıt tamamlandığında | Yeni 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önderin | Göndermeyin |
|---|---|
Sistem içi müşteri kimliği (12345, MUSTERI-1001) | Düz e-posta adresi |
| Kararlı bir UUID | Oturum 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ı
429alı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
- Sitenizde giriş yapın.
- Panelde Site Users sayfasını açın.
- Kendi profilinizin oluştuğunu görün.
- 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
