Android SDK'da kullanıcıları tanımlama

Kullanıcı satın almalarını nasıl yöneteceğiniz, uygulamanızın kimlik doğrulama modeline göre değişir:

• Uygulamanız backend kimlik doğrulaması kullanmıyorsa ve kullanıcı verilerini depolamıyorsa, anonim kullanıcılarla ilgili bölüme bakın.
• Uygulamanızda backend kimlik doğrulaması varsa (veya olacaksa), tanımlanmış kullanıcılarla ilgili bölüme 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ımlanmış (customer user ID ile) olabilirler.
• Adapty’deki profilleri kendi iç 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 şunlardır:

Anonim kullanıcılar

Backend kimlik doğrulamanız yoksa uygulama kodunda kimlik doğrulamayı yönetmenize gerek yoktur:

1. SDK uygulamanın ilk açılışında etkinleştirildiğinde, Adapty kullanıcı için yeni bir profil oluşturur.
2. Kullanıcı uygulamada bir şey satın aldığında, bu satın alma Adapty profiliyle ve mağaza hesabıyla ilişkilendirilir.
3. Kullanıcı uygulamayı yeniden yüklediğinde veya yeni bir cihaza yüklediğinde, Adapty etkinleştirme sırasında yeni bir anonim profil oluşturur.
4. Kullanıcı uygulamanızda daha önce 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ılarda her kurulumda yeni profil oluşturulur; ancak bu bir sorun değildir çünkü Adapty analizinde yeni kurulum olarak neyin sayılacağını yapılandırabilirsiniz.

Anonim kullanıcılar için kurulumları cihaz kimliklerine göre saymanız gerekir. Bu durumda, yeniden kurulumlar dahil olmak üzere bir cihazdaki her uygulama kurulumu bir kurulum olarak sayılır.

Tanımlanmış kullanıcılar

Uygulamada kullanıcıları tanımlamak için iki seçeneğiniz vardır:

• Giriş/kayıt sırasında: Kullanıcılar uygulamanız başladıktan sonra oturum açıyorsa, kimlik doğruladıklarında identify() metodunu customer user ID ile çağırın.

• SDK etkinleştirmesi sırasında: Uygulama başladığında zaten bir customer user ID’niz varsa, activate() çağrısında gönderin.

Giriş/kayıt sırasında

Kullanıcıları uygulama başladı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 bunu 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.

Adapty.identify("YOUR_USER_ID") { error -> // Unique for each user
    if (error == null) {
        // successful identify
    }
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID", error -> {
    if (error == null) {
        // successful identify
    }
});

SDK etkinleştirmesi sırasında

SDK’yı etkinleştirdiğinizde zaten bir customer user ID biliyorsanız, identify metodunu ayrıca çağırmak yerine activate metodunda gönderebilirsiniz.

Customer user ID’yi bilmenize rağmen yalnızca etkinleştirmeden sonra ayarlarsanız, etkinleştirme sırasında Adapty yeni bir anonim profil oluşturacak ve identify metodunu çağırdıktan sonra mevcut profile geçecektir.

Mevcut bir customer user ID (daha önce kullandığınız) veya yeni bir tane iletebilirsiniz. Yeni bir tane iletirseniz, etkinleştirme sırasında oluşturulan yeni profil otomatik olarak customer user ID’ye bağlanır.

AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withCustomerUserId("user123") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.
    .build()

new AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withCustomerUserId("user123") // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.
    .build();

Kullanıcı oturumunu kapatma

Kullanıcıların oturumunu kapatmak için bir düğmeniz varsa, logout metodunu kullanın.

Adapty.logout { error ->
    if (error == null) {
        // successful logout
    }
}

Adapty.logout(error -> {
    if (error == null) {
        // successful logout
    }
});

Giriş yapmadan satın alma izni verme

Kullanıcılarınız uygulamanıza giriş yapmadan önce ve sonra satın alma yapabiliyorsa, giriş yaptıktan sonra erişimlerini koruduklarından emin olmanız gerekir:

1. Oturumu kapalı bir kullanıcı satın alma yaptığında, Adapty bunu anonim profil kimliğine bağlar.
2. 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ı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 metodunu çağırabilir veya verilerin otomatik olarak 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 monetizasyonunda başarılar dileriz!

Adapty’den daha fazla yararlanmak için şu konuları inceleyebilirsiniz:

• Test: Her şeyin beklendiği gibi çalıştığından emin olun
• Onboarding’ler: Onboarding’lerle kullanıcıları etkileyin ve elde tutmayı artırın
• Entegrasyonlar: Tek satır kodla pazarlama attribution ve analiz hizmetleriyle entegre olun
• Özel profil özellikleri belirleme: Kullanıcı profillerine özel özellikler ekleyin ve segment’ler oluşturun; böylece A/B testleri başlatabilir veya farklı kullanıcılara farklı paywall’lar gösterebilirsiniz