Kotlin Multiplatform SDK'da kullanıcı özelliklerini 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:

import com.adapty.kmp.Adapty
import com.adapty.kmp.models.AdaptyProfile
import com.adapty.kmp.models.AdaptyProfileParameters

val builder = AdaptyProfileParameters.Builder()
    .withEmail("[email protected]")
    .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.

Adapty SDK’nın bir mobil uygulamaya nasıl entegre edildiğini gerçek bir örnekle görmek ister misiniz? Tam kurulumu, paywall’ların gösterimini, satın alma işlemlerini ve diğer temel işlevleri içeren ö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.

import com.adapty.kmp.models.AdaptyProfileParameters

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

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

import com.adapty.kmp.models.AdaptyProfileParameters

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.

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.