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

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 arka uç kimlik doğrulaması kullanmıyor ve kullanıcı verilerini depolamıyorsa, anonim kullanıcılar bölümüne bakın.
• Uygulamanız arka uç kimlik doğrulamasına sahipse (veya ileride sahip 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 olmadan) veya tanımlanmış (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ımlanmış kullanıcılar arasındaki farklar:

Anonim kullanıcılar

Arka uç kimlik doğrulamanız yoksa, uygulama kodunda kimlik doğrulamayı işlemenize 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 profili ve mağaza hesabıyla ilişkilendirilir.
3. Kullanıcı uygulamayı yeniden yüklediğinde veya yeni bir cihaza yüklediğinde, Adapty aktivasyonda yeni bir anonim profil oluşturur.
4. Kullanıcı uygulamanızda daha önce satın alma yapmışsa, varsayılan olarak satın alımları SDK aktivasyonunda App Store’dan otomatik olarak senkronize edilir.

Anonim kullanıcılarda her yüklemede yeni profiller oluşturulacaktır, 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 de dahil olmak üzere bir cihazdaki her uygulama yüklemesi bir yükleme olarak sayılır.

Tanımlanmış kullanıcılar

Kullanıcıları uygulamada 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 bir customer user ID ile çağırın.

• SDK aktivasyonu sırasında: Uygulama başlatıldığında zaten depolanmış bir customer user ID’niz varsa, bunu activate() çağrısında 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 kaydolduktan 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.

do {
    try await Adapty.identify("YOUR_USER_ID") // Unique for each user
} catch {
    // handle the error
}

// User IDs must be unique for each user
Adapty.identify("YOUR_USER_ID") { error in
    if let error {
        // handle the error
    }
}

SDK aktivasyonu sırasında

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

Bir customer user ID bilmenize rağmen bunu yalnızca aktivasyon sonrasında ayarlarsanız, aktivasyonda Adapty yeni bir anonim profil oluşturacak ve siz identify metodunu çağırdıktan sonra mevcut profile geçecektir.

Mevcut bir customer user ID (daha önce kullandığınız bir ID) veya yeni bir tane geçirebilirsiniz. Yeni bir tane geçerseniz, aktivasyonda oluşturulan yeni profil otomatik olarak customer user ID’ye bağlanacaktır.

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(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.

do {
  try await Adapty.activate(with: configurationBuilder.build())
} catch {
  // handle the error
}

// Place in the app main struct for SwiftUI or in AppDelegate for UIKit

let configurationBuilder =
    AdaptyConfiguration
        .builder(withAPIKey: "PUBLIC_SDK_KEY")
        .with(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.

Adapty.activate(with: configurationBuilder.build()) { error in
  // handle the error
}

Kullanıcı oturumunu kapatma

Kullanıcıların oturumunu kapatmak için bir butonunuz varsa, logout metodunu kullanın.

do {
    try await Adapty.logout()
} catch {
    // handle the error
}

Adapty.logout { error in
    if error == nil {
        // successful logout
    }
}

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ıklarında erişimlerini kaybetmeyeceklerinden emin olmanız gerekir:

1. Oturumu kapalı bir kullanıcı satın alma yaptığında, Adapty bunu anonim profil ID’sine 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 olmadan önce 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şinin ardından gerçek access level’ı almanız gerekir. Tanımlamanın hemen ardından getProfile metodunu çağırabilir veya verinin otomatik olarak senkronize olması için profil güncellemelerini dinleyebilirsiniz.

Sonraki adımlar

Tebrikler! Uygulamanıza uygulama içi ödeme mantığını başarıyla uyguladınız! Uygulamanızın monetizasyonunda 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
• Onboardings: Kullanıcıları onboarding’lerle etkileşime geçirin ve elde tutma oranını artırın
• Entegrasyonlar: Tek satır kodla pazarlama attribution ve analitik 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