Kullanıcıların satın alımları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 depolamı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.
• Anonim (customer user ID olmaksızın) veya tanımlanmış (customer user ID ile) olabilirler.
• Adapty’deki profilleri kendi kimlik doğrulama sisteminizle çapraz referanslamak için customer user ID sağlarsınız.

Anonim ve tanımlanmış kullanıcılar arasındaki farklar:

	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ında 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 yüklemesine bağlıdır	Tanımlanmış kullanıcı verisi uygulama yüklemeleri arasında korunur

Anonim kullanıcılar

Backend kimlik doğrulamanız yoksa uygulama kodunda kimlik doğrulamayla ilgilenmenize gerek yoktur:

1. SDK uygulamanın ilk başlatılmasında etkinleştirildiğinde Adapty kullanıcı için yeni bir profil oluşturur.
2. Kullanıcı uygulamada herhangi 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 cihazdan yüklediğinde Adapty, etkinleştirmede yeni bir anonim profil oluşturur.
4. Kullanıcı uygulamanızda daha önce satın alım yapmışsa, varsayılan olarak bu satın alımlar SDK etkinleştirildiğinde App Store’dan otomatik olarak senkronize edilir.

Anonim kullanıcılarda her yüklemede yeni profil oluşturulur; ancak bu bir sorun değildir çünkü Adapty analitiğinde yeni yükleme olarak neyin sayılacağını yapılandırabilirsiniz.

Anonim kullanıcılar için yüklemeleri cihaz ID’lerine göre saymanız gerekir. Bu durumda, yeniden yüklemeler dahil bir cihazdaki her uygulama yüklemesi bir yükleme 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 giriş yapıyorsa, kimlik doğruladıklarında bir customer user ID ile identify() çağırın.

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

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’lerini ayarlamak için identify metodunu kullanın.

• Bu customer user ID’yi daha önce kullanmadıysanız, Adapty onu 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.

Adapty.identify("YOUR_USER_ID") // Unique for each user
    .onSuccess {
        // successful identify
    }
    .onError { error ->
        // handle the error
    }

SDK etkinleştirmesi sırasında

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

Customer user ID’yi bilmenize rağmen onu yalnızca etkinleştirmeden sonra ayarlıyorsanız, bu, etkinleştirme sırasında Adapty’nin yeni bir anonim profil oluşturacağı ve identify çağrısından sonra mevcut profile geçeceği anlamına gelir.

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 ile ilişkilendirilir.

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ıları çıkış yaptırma

Kullanıcıları çıkış yaptırmak için bir butonunuz varsa logout metodunu kullanın.

Adapty.logout()
    .onSuccess {
        // successful logout
    }
    .onError { error ->
        // handle the error
    }

Giriş yapmadan satın almaya izin verme

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

1. Çıkış yapmış bir kullanıcı satın alım yaptığında Adapty bunu anonim profil ID’siyle ilişkilendirir.
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 alım kayıt öncesinde yapılmışsa), Adapty customer user ID’yi mevcut profille ilişkilendirir; böylece 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şiminden sonra gerçek access level’ı almanız gerekir. Tanımlama işleminden hemen sonra getProfile çağırabilir ya da veriler otomatik senkronize olsun diye profil güncellemelerini dinleyebilirsiniz.

Sonraki adımlar

Tebrikler! Uygulamanıza uygulama içi ödeme mantığını eklediniz! Uygulama monetizasyonunuzda başarılar diliyoruz!

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

• Test etme: Her şeyin beklendiği gibi çalıştığından emin olun
• Entegrasyonlar: Tek satır kodla pazarlama attribution ve analitik servisleriyle entegre olun
• Özel profil özellikleri ayarlama: Kullanıcı profillerine özel özellikler ekleyin ve segment’ler oluşturun; böylece A/B testi başlatabilir veya farklı kullanıcılara farklı paywall’lar gösterebilirsiniz