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:

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ılarTanımlı kullanıcılar
Satın alma yönetimiMağaza düzeyinde satın alma geri yüklemeCustomer user ID aracılığıyla cihazlar arası satın alma geçmişini koruma
Profil yönetimiHer yeniden yüklemede yeni profilOturumlar ve cihazlar arasında aynı profil
Veri kalıcılığıAnonim kullanıcı verisi uygulama kurulumuna bağlıdırTanı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:

  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 cihazdan yüklediğinde, Adapty etkinleştirmede yeni bir anonim profil oluşturur.
  4. 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.

identify-diagram.webp

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:

  1. Çıkış yapmış bir kullanıcı satın alma yaptığında, Adapty bunu anonim profil ID’siyle ilişkilendirir.
  2. 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