Bu kılavuz, OneSignal’i uzun süredir Mobil SDK’larımızın 2, 3 veya 4. sürümlerinde veya Web SDK’mızın v15’inde kullanan müşteriler içindir.Yeni bir müşteriyseniz veya Mobil SDK’larımızın 5. sürümüne veya Web SDK’mızın v16’sına zaten geçtiyseniz, bu kılavuzu atlayabilir ve şuraya gidebilirsiniz:
Kullanıcı Modeli ile çok kanallı mesajlaşma
Kullanıcı Modeli nedir?
Kullanıcı Modeli, bireysel cihazları hedeflemek yerine, abone oldukları tüm mesajlaşma kanallarında (mobil push, web push, e-posta, SMS ve uygulama içi) gerçek kullanıcıları hedeflemenize olanak tanır. Her Kullanıcı:- Bir veya daha fazla Kimlik Takma Adına sahiptir (örneğin external_id, özel takma ad)
- Her kanal veya cihaz için bir tane olmak üzere birden fazla Aboneliğe sahip olabilir
- Etiketler, dil ve etkinlik geçmişi gibi meta verileri içerir
Player vs. User Model
Temel kavramlar
- Kullanıcılar
- Abonelikler
- Takma Adlar
Bir Kullanıcı gerçek bir kişiyi temsil eder. Sistem tarafından oluşturulan veya özel takma adlar kullanarak bir kullanıcıyı tanımlayabilirsiniz.
onesignal_id: OneSignal tarafından otomatik oluşturulurexternal_id: SDKlogin()veya API aracılığıyla ayarlanır (ayrılmış takma ad)- Özel Takma Adlar: örneğin
user_id,email,facebook, vb.
Geçişin faydaları
- Birleşik Kimlik: Tüm cihazlar ve kanallar genelinde tek kullanıcı
- Gelişmiş Mesajlaşma: Journey’ler, uygulama içi giriş takibi ve yaşam döngüsü kampanyaları gibi güçlü özellikler
- Temiz Segmentasyon: Kullanıcıları etiketlere, abonelik durumuna, kanal etkileşimine ve daha fazlasına göre gruplandırın
- Basitleştirilmiş API: Daha az uç nokta, daha tutarlı veri modeli
Geçiş adımları
Kullanıcı Modeli geriye dönük uyumlu değildir. Geçiş, Player Model’den User Model’e tek yönlüdür.Geçiş yapmadan önce:
- Bir staging ortamında kapsamlı test edin
- Yalnızca tüm SDK’lar ve arka uç hizmetleri güncellendikten sonra geçiş yapın
1
Kullanıcıları external_id ile birleştirin
Mevcut player kayıtlarını birleşik kullanıcılara bağlamak için kimlik takma adlarını kullanın.Seçenekler:
- SDK
login(externalId) - API: Create User, Update User
- CSV: Import
2
OneSignal SDK'larınızı güncelleyin
Tüm OneSignal mobil SDK’ları v5+ ve web SDK v16+ Kullanıcı Modelini destekler.Riski en aza indirmek için aşamalı dağıtım stratejileri kullanarak SDK güncellemelerini kullanıma sunun:Aşağıdaki SDK destek tablosuna bakın.
3
Yeni User API'lerini kullanmak için arka ucunuzu güncelleyin
Kullanımdan kaldırılan Player Model API çağrılarını yeni User Model eşdeğerleriyle değiştirin.Eski uç noktaları yenileriyle eşlemek için API Referansımızı ve aşağıdaki tabloları kullanın.
SDK desteği ve geçiş kılavuzları
- Mobil SDK'lar
- Web SDK'ları
- Backend SDK'ları
API referansı
- Player Model (Kullanımdan kaldırıldı)
- User Model (Yeni)
| Eski API | Yerine kullanılacak |
|---|---|
| Add Device | Create User veya Create Subscription |
| Edit Device | Update User veya Update Subscription |
| Delete Player | Delete User veya Delete Subscription |
Sonraki adımlar
- 📘 Kullanıcılar ve Abonelikler belgelerimize bakın
- 🛠️ Yayına geçmeden önce SDK’ları güncelleyin ve staging ortamında test edin
- 💬 Yardıma mı ihtiyacınız var?
support@onesignal.comile iletişime geçin
Artık yeni Kullanıcı Modeli ile desteklenen kişiselleştirilmiş, çok kanallı mesajlaşma deneyimleri oluşturmaya hazırsınız!