React Native SDK'da kullanıcıları tanımlama
Bu kılavuz, kendi kimlik doğrulama sisteminiz varsa size göre hazırlanmıştır. Burada, Adapty’deki kullanıcı profilleriyle mevcut kimlik doğrulama sisteminizi nasıl uyumlu hale getireceğinizi öğreneceksiniz.
Kullanıcıların satın almalarını nasıl yöneteceğiniz, uygulamanızın kimlik doğrulama modeline bağlıdır:
- Uygulamanız backend kimlik doğrulaması kullanmıyor ve kullanıcı verisi saklamıyorsa, anonim kullanıcılar bölümüne bakın.
- Uygulamanızda backend kimlik doğrulaması varsa (veya olacaksa), tanımlanmış kullanıcılar bölümüne bakın.
Temel kavramlar:
- Profiller, SDK’nın çalışması için gereken varlıklardır. Adapty bunları otomatik olarak oluşturur.
- Profiller anonim (customer user ID’siz) veya tanımlanmış (customer user ID’li) olabilir.
- Adapty’deki profilleri kendi kimlik doğrulama sisteminizle eşleştirmek için customer user ID sağlarsınız.
Anonim ve tanımlanmış kullanıcılar arasındaki farklar şöyledir:
| Anonim kullanıcılar | Tanımlanmış kullanıcılar | |
|---|---|---|
| Satın alma yönetimi | Mağaza düzeyinde satın alma geri yükleme | Customer user ID aracılığıyla cihazlar arası satın alma geçmişini koruma |
| Profil yönetimi | Her yeniden yüklemede yeni profil | Oturumlar ve cihazlar arasında aynı profil |
| Veri kalıcılığı | Anonim kullanıcıların verileri uygulama kurulumuna bağlıdır | Tanımlanmış kullanıcıların verileri uygulama kurulumları arasında kalıcı olarak saklanır |
Anonim kullanıcılar
Backend kimlik doğrulamanız yoksa, uygulama kodunda kimlik doğrulamayı yönetmenize gerek yoktur:
- Uygulamanın ilk açılışında SDK etkinleştirildiğinde, Adapty kullanıcı için yeni bir profil oluşturur.
- Kullanıcı uygulamada herhangi bir şey satın aldığında, bu satın alma Adapty profiliyle ve mağaza hesabıyla ilişkilendirilir.
- Kullanıcı uygulamayı yeniden yüklediğinde veya yeni bir cihaza yüklediğinde, Adapty etkinleştirmede yeni bir anonim profil oluşturur.
- Kullanıcı uygulamanızda daha önce satın alma yaptıysa, SDK etkinleştirildiğinde satın almalar varsayılan olarak App Store’dan otomatik olarak senkronize edilir.
Anonim kullanıcılarda her kurulumda yeni profil oluşturulur, ancak bu sorun değildir; çünkü Adapty analitiğinde yeni kurulum olarak neyin sayılacağını yapılandırabilirsiniz.
Yedekten geri yükleme işlemleri, yeniden yüklemelerden farklı davranır. Varsayılan olarak, bir kullanıcı yedekten geri yükleme yaptığında SDK önbelleğe alınan verileri korur ve yeni bir profil oluşturmaz. Bu davranışı clearDataOnBackup ayarıyla yapılandırabilirsiniz. Daha fazla bilgi edinin.
Anonim kullanıcılar için kurulumları cihaz ID’lerine göre saymanız gerekir. Bu durumda, yeniden yüklemeler dahil olmak üzere bir cihaza yapılan her uygulama kurulumu bir kurulum olarak sayılır.
Tanımlanmış kullanıcılar
Uygulamadaki kullanıcıları tanımlamak için iki seçeneğiniz var:
-
Giriş/kayıt sırasında: Kullanıcılar uygulamanız başladıktan sonra giriş yapıyorsa, kimlik doğruladıklarında bir customer user ID ile
identify()çağırın. -
SDK etkinleştirme sırasında: Uygulama başladığında zaten bir customer user ID saklıyorsanız,
activate()çağrısında bunu gönderin.
Varsayılan olarak, Adapty başka bir Customer User ID ile ilişkili bir Customer User ID’den satın alma aldığında, access level paylaşılır ve her iki profil de ücretli erişime sahip olur. Bu ayarı, ücretli erişimi bir profilden diğerine aktaracak veya paylaşımı tamamen devre dışı bırakacak şekilde yapılandırabilirsiniz. Ayrıntılar için makaleye bakın.
Giriş/kayıt sırasında
Kullanıcıları uygulama başlatıldıktan sonra tanımlıyorsanız (örneğin, uygulamanıza giriş yaptıktan veya kayıt olduktan sonra), customer user ID’yi ayarlamak için identify metodunu kullanın.
- Bu customer user ID’yi daha önce kullanmadıysanız, Adapty onu otomatik olarak mevcut profile bağlar.
- Bu customer user ID’yi daha önce kullanıcıyı tanımlamak için kullandıysanız, Adapty bu customer user ID ile ilişkili profille çalışmaya geçer.
Customer user ID’ler her kullanıcı için benzersiz olmalıdır. Parametre değerini sabit kodlarsanız, tüm kullanıcılar tek bir kullanıcı olarak kabul edilir.
try {
await adapty.identify("YOUR_USER_ID"); // Unique for each user
// successfully identified
} catch (error) {
// handle the error
}
SDK etkinleştirme sırasında
SDK’yı etkinleştirdiğinizde zaten bir customer user ID biliyorsanız, identify’ı ayrıca çağırmak yerine bunu activate metodunda gönderebilirsiniz.
Customer user ID biliyorsanız ancak bunu yalnızca etkinleştirmeden sonra ayarlıyorsanız, etkinleştirme sırasında Adapty yeni bir anonim profil oluşturacak ve identify çağrısından sonra mevcut profile geçecektir.
Mevcut bir customer user ID (daha önce kullandığınız) veya yeni bir tane gönderebilirsiniz. Yeni bir tane gönderirseniz, etkinleştirme sırasında oluşturulan yeni profil otomatik olarak customer user ID’ye bağlanır.
Varsayılan olarak, anonim profil oluşturma, kurulumlar cihaz ID’lerine göre sayıldığı için analitik panolarını etkilemez.
Bir cihaz ID’si, cihazdaki mağazadan yapılan tek bir uygulama kurulumunu temsil eder ve yalnızca uygulama yeniden yüklendikten sonra yeniden oluşturulur. Bu, bunun ilk mi yoksa tekrar mı yükleme olduğundan ya da mevcut bir customer user ID kullanılıp kullanılmadığından bağımsızdır.
Profil oluşturma (SDK etkinleştirme veya oturum kapatma sırasında), giriş yapma veya uygulamayı yeniden yüklemeden yükseltme, ek kurulum olayı oluşturmaz.
Kurulumları cihazlar yerine benzersiz kullanıcılara göre saymak istiyorsanız, App settings bölümüne gidin ve Installs definition for analytics ayarını yapılandırın.
adapty.activate("PUBLIC_SDK_KEY", {
customerUserId: "YOUR_USER_ID" // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.
});
Kullanıcıların oturumunu kapatma
Kullanıcıların oturumunu kapatmak için bir butonunuz varsa, logout metodunu kullanın.
Kullanıcının oturumunu kapatmak, kullanıcı için yeni bir anonim profil oluşturur.
try {
await adapty.logout();
// successful logout
} catch (error) {
// handle the error
}
Kullanıcıları uygulamaya tekrar giriş yaptırmak için identify metodunu kullanın.
Giriş yapmadan satın almaya izin verme
Kullanıcılarınız uygulamanıza giriş yapmadan önce ve sonra satın alma yapabiliyorsa, giriş yaptıktan sonra erişimlerini koruyacaklarından emin olmanız gerekir:
- Oturumu kapalı bir kullanıcı satın alma yaptığında, Adapty bunu anonim profil ID’siyle ilişkilendirir.
- Kullanıcı hesabına giriş yaptığında, Adapty tanımlanmış profiliyle çalışmaya geçer.
- Yeni bir customer user ID ise (örneğin, satın alma kayıt öncesinde yapıldıysa), Adapty customer user ID’yi mevcut profile atar ve tüm satın alma geçmişi korunur.
- Mevcut bir customer user ID ise (customer user ID zaten bir profille bağlantılıysa), profil değişikliğinden sonra gerçek access level’ı almanız gerekir. Tanımlamanın hemen ardından
getProfileçağırabilir veya verilerin otomatik senkronize edilmesi için profil güncellemelerini dinleyebilirsiniz.
Sonraki adımlar
Tebrikler! Uygulamanızda uygulama içi ödeme mantığını hayata geçirdiniz! Uygulama monetizasyonunuzda başarılar dileriz!
Adapty’den daha fazla yararlanmak için şu konuları inceleyebilirsiniz:
- Test etme: Her şeyin beklendiği gibi çalıştığından emin olun
- Onboarding’ler: Onboarding’lerle kullanıcıları etkileyin ve elde tutma oranını artırın
- Entegrasyonlar: Tek satır kodla pazarlama attribution ve analitik hizmetleriyle entegre olun
- Özel profil özellikleri ayarlama: Kullanıcı profillerine özel özellikler ekleyin ve segmentler oluşturun; böylece A/B testleri başlatabilir veya farklı kullanıcılara farklı paywall’lar gösterebilirsiniz