Unity SDK'da kullanıcıları tanımlama
Bu kılavuz, kendi kimlik doğrulama sisteminiz varsa size yöneliktir. Burada, mevcut kimlik doğrulama sisteminizle uyumlu olacak şekilde Adapty’deki kullanıcı profilleriyle nasıl çalışacağınızı öğ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 arka uç kimlik doğrulaması kullanmıyorsa ve kullanıcı verilerini depolamıyorsa, anonim kullanıcılar bölümüne bakın.
- Uygulamanızın arka uç kimlik doğrulaması varsa (veya olacaksa), tanımlı 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.
- Anonim (customer user ID olmadan) veya tanımlı (customer user ID ile) olabilirler.
- Adapty’deki profilleri kendi dahili kimlik doğrulama sisteminizle çapraz referanslamak için customer user ID sağlarsınız.
Anonim ve tanımlı kullanıcılar arasındaki farklar şunlardır:
| Anonim kullanıcılar | Tanımlı 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ı verisi uygulama kurulumuna bağlıdır | Tanımlı kullanıcı verisi uygulama kurulumları arasında kalıcıdır |
Anonim kullanıcılar
Arka uç kimlik doğrulamanız yoksa, uygulama kodunda kimlik doğrulamayı yönetmenize gerek yoktur:
- SDK, uygulamanın ilk açılışında etkinleştirildiğinde, Adapty kullanıcı için yeni bir profil oluşturur.
- Kullanıcı uygulamada bir şey satın aldığında, bu satın alma Adapty profili ve mağaza hesabıyla ilişkilendirilir.
- Kullanıcı uygulamayı yeniden yüklediğinde veya yeni bir cihazdan yüklediğinde, Adapty etkinleştirmede yeni bir anonim profil oluşturur.
- Kullanıcı daha önce uygulamanızda satın alma yapmışsa, varsayılan olarak satın almalar SDK etkinleştirmesinde App Store’dan otomatik olarak senkronize edilir.
Yani anonim kullanıcılarla her kurulumda yeni profil oluşturulur; ancak bu bir sorun değildir çünkü Adapty analizlerinde yeni kurulum olarak neyin sayılacağını yapılandırabilirsiniz.
Anonim kullanıcılar için kurulumları cihaz ID’lerine göre saymanız gerekir. Bu durumda, yeniden yüklemeler dahil olmak üzere bir cihazdaki her uygulama kurulumu bir yükleme olarak sayılır.
Tanımlı 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 oturum açıyorsa, kimlik doğruladıklarında customer user ID ile
identify()çağrısı yapın. -
SDK etkinleştirmesi sırasında: Uygulama başlatılırken zaten bir customer user ID’niz varsa,
activate()çağrısı yaparken bunu gönderin.
Varsayılan olarak, Adapty şu anda başka bir Customer User ID ile ilişkilendirilmiş bir Customer User ID’den satın alma aldığında, access level paylaşılır; yani 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 kaydolduktan sonra), customer user ID’yi ayarlamak için identify metodunu kullanın.
- Bu customer user ID’yi daha önce kullanmadıysanız, Adapty bunu otomatik olarak mevcut profille ilişkilendirir.
- 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.
Adapty.Identify("YOUR_USER_ID", (error) => { // Unique for each user
if(error == null) {
// successful identify
}
});
SDK etkinleştirmesi sırasında
SDK’yı etkinleştirdiğinizde zaten bir customer user ID biliyorsanız, ayrıca identify çağrısı yapmak yerine bunu activate metodunda gönderebilirsiniz.
Customer user ID bilseniz de bunu yalnızca etkinleştirmeden sonra ayarlarsanız, etkinleştirmede Adapty yeni bir anonim profil oluşturur ve yalnızca identify çağrısı yaptıktan sonra mevcut profile geçer.
Mevcut bir customer user ID (daha önce kullandığınız) veya yeni bir tane geçirebilirsiniz. Yeni bir tane geçirirseniz, etkinleştirmede oluşturulan yeni profil otomatik olarak customer user ID ile ilişkilendirilir.
Varsayılan olarak, anonim profil oluşturma analiz kontrol panellerini etkilemez; çünkü kurulumlar cihaz ID’lerine göre sayılır.
Cihaz ID’si, bir cihazda mağazadan yapılan tek bir uygulama kurulumunu temsil eder ve yalnızca uygulama yeniden yüklendikten sonra yeniden oluşturulur. Bu, birinci veya tekrar kurulum olup olmadığına ya da mevcut bir customer user ID kullanılıp kullanılmadığına bağlı değildir.
Profil oluşturma (SDK etkinleştirmesinde veya çıkışta), oturum açma 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 gidip Installs definition for analytics ayarını yapılandırın.
using UnityEngine;
using AdaptySDK;
var builder = new AdaptyConfiguration.Builder("YOUR_API_KEY")
.SetCustomerUserId("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.
Adapty.Activate(builder.Build(), (error) => {
if (error != null) {
// handle the error
return;
}
});
Kullanıcı çıkışı
Kullanıcıların çıkış yapması için bir butonunuz varsa, logout metodunu kullanın.
Kullanıcı çıkışı, kullanıcı için yeni bir anonim profil oluşturur.
Adapty.Logout((error) => {
if(error == null) {
// successful logout
}
});
Kullanıcıları tekrar uygulamaya giriş yaptırmak için identify metodunu kullanın.
Girişsiz satın almalara izin verme
Kullanıcılarınız uygulamanıza giriş yapmadan önce ve sonra satın alma yapabiliyorsa, giriş yaptıktan sonra erişimlerini koruduğunuzdan emin olmanız gerekir:
- Çıkış yapmış 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ımlı profiliyle çalışmaya geçer.
- Yeni bir customer user ID ise (örneğin, satın alma kayıt öncesinde yapılmışsa), Adapty customer user ID’yi mevcut profile atar; böylece tüm satın alma geçmişi korunur.
- Mevcut bir customer user ID ise (customer user ID zaten bir profile bağlıysa), profil geçişinden sonra gerçek access level’ı almanız gerekir. Tanımlamadan hemen sonra
getProfileçağrısı yapabilir veya veriler otomatik senkronize olması için profil güncellemelerini dinleyebilirsiniz.
Sonraki adımlar
Tebrikler! Uygulamanızda uygulama içi ödeme mantığını hayata geçirdiniz! Uygulamanızın gelirini artırmanızı diliyoruz!
Adapty’den daha fazla yararlanmak için şu konuları inceleyebilirsiniz:
- Test etme: Her şeyin beklendiği gibi çalıştığından emin olun
- Onboardings: Onboarding’lerle kullanıcıları etkileyin ve elde tutmayı artırın
- Entegrasyonlar: Tek satır kodla pazarlama attribution ve analiz hizmetleriyle entegre edin
- Özel profil öznitelikleri ayarlama: Kullanıcı profillerine özel öznitelikler ekleyin ve segmentler oluşturun; böylece A/B testleri başlatabilir veya farklı kullanıcılara farklı paywall’lar gösterebilirsiniz