iOS SDK'da kullanıcı özelliklerini ayarlama

Uygulamanızın kullanıcıları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:

let builder = AdaptyProfileParameters.Builder()
    .with(email: "[email protected]")
    .with(phoneNumber: "+18888888888")
    .with(firstName: "John")
    .with(lastName: "Appleseed")
    .with(gender: .other)
    .with(birthday: Date())
    
do {
    try await Adapty.updateProfile(params: builder.build())
} catch {
    // handle the error
}

let builder = AdaptyProfileParameters.Builder()
    .with(email: "[email protected]")
    .with(phoneNumber: "+18888888888")
    .with(firstName: "John")
    .with(lastName: "Appleseed")
    .with(gender: .other)
    .with(birthday: Date())
    
Adapty.updateProfile(params: builder.build()) { error in
    if error != nil {
        // handle the error                        
    }
}

updateProfile metoduyla daha önce ayarladığınız özellikler sıfırlanmaz.

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 anahtar listesi

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

Anahtar Değer

Anahtar	Değer
email phoneNumber firstName lastName	String
gender	Enum, izin verilen değerler: `female`, `male`, `other`
birthday	Date

phoneNumber

firstName

lastName

String

gender Enum, izin verilen değerler: female, male, other

birthday Date

Ö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, hedefli paywall’lar ve teklifler oluşturmak için segmentlerde; hangi ürün metriklerinin geliri en çok etkilediğini anlamak için de analitikte kullanabilirsiniz.

do {
     builder = try builder.with(customAttribute: "value1", forKey: "key1")
} catch {
     // handle key/value validation error
}

Mevcut bir anahtarı kaldırmak için .withRemoved(customAttributeForKey:) metodunu kullanın:

do {
     builder = try builder.withRemoved(customAttributeForKey: "key2")
} catch {
     // handle error
}

Bazen daha önce hangi özel özelliklerin ayarlandığını öğ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ı alfanümerik karakterler ve şu karakterlerden herhangi birini içerebilir: _ - .
Değer, en fazla 50 karakter uzunluğunda bir string veya float olabilir.