Kotlin Multiplatform SDK'da kullanıcı nitelikleri ayarlama

Uygulamanızın kullanıcısına e-posta, telefon numarası gibi isteğe bağlı özellikler ekleyebilirsiniz. Bu özellikleri kullanıcı segmentleri oluşturmak veya CRM’de görüntülemek için kullanabilirsiniz.

Kullanıcı özelliklerini ayarlama

Kullanıcı özelliklerini ayarlamak için .updateProfile() metodunu çağırın:


val builder = AdaptyProfileParameters.Builder()
    .withEmail("email@email.com")
    .withPhoneNumber("+18888888888")
    .withFirstName("John")
    .withLastName("Appleseed")
    .withGender(AdaptyProfile.Gender.FEMALE)
    .withBirthday(AdaptyProfile.Date(1970, 1, 3))
  
Adapty.updateProfile(builder.build())
    .onSuccess {
        // profile updated successfully
    }
    .onError { error ->
        // handle the error
    }

updateProfile metoduyla daha önce ayarladığınız özelliklerin sıfırlanmayacağını unutmayın.

Tip

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek dünyadan bir örnekle görmek ister misiniz? Paywall gösterme, satın alma yapma ve diğer temel işlevler dahil olmak üzere tam kurulumu sergileyen örnek uygulamalarımıza göz atın.

İzin verilen anahtarlar listesi

AdaptyProfileParameters.Builder için izin verilen anahtarlar <Key> ve değerler <Value> aşağıda listelenmiştir:

AnahtarDeğer

email

phoneNumber

firstName

lastName

String
genderEnum; izin verilen değerler: AdaptyProfile.Gender.FEMALE, AdaptyProfile.Gender.MALE, AdaptyProfile.Gender.OTHER
birthdayDate

Özel kullanıcı özellikleri

Kendi özel özelliklerinizi tanımlayabilirsiniz. Bunlar genellikle uygulamanızın kullanımıyla ilgilidir. Örneğin, fitness uygulamalarında haftalık egzersiz sayısı, dil öğrenme uygulamalarında kullanıcının bilgi düzeyi gibi. Bu özellikleri segmentlerde kullanarak hedefli paywall’lar ve teklifler oluşturabilir, analitik aracılığıyla hangi ürün metriklerinin gelire en çok etki ettiğini de keşfedebilirsiniz.


val builder = AdaptyProfileParameters.Builder()
builder.withCustomAttribute("key1", "value1")

Mevcut bir anahtarı silmek için .withRemovedCustomAttribute() metodunu kullanın:


val builder = AdaptyProfileParameters.Builder()
builder.withRemovedCustomAttribute("key2")

Bazen daha önce hangi özel özelliklerin eklendiğini öğrenmeniz gerekebilir. Bunun için AdaptyProfile nesnesinin customAttributes alanını kullanın.

Warning

customAttributes değerinin güncel olmayabileceğini unutmayın. Kullanıcı özellikleri farklı cihazlardan herhangi bir zamanda gönderilebileceğinden, sunucudaki özellikler son senkronizasyondan bu yana değişmiş olabilir.

Sınırlar

  • Kullanıcı başına en fazla 30 özel özellik
  • Anahtar adları en fazla 30 karakter olabilir. Anahtar adında alfanümerik karakterler ve şu simgeler kullanılabilir: _ - .
  • Değer, en fazla 50 karakterlik bir string veya float olabilir.