Flutter SDK'da kullanıcı özniteliklerini ayarlama

Uygulama kullanıcılarınıza e-posta, telefon numarası gibi isteğe bağlı öznitelikler ekleyebilirsiniz. Bu öznitelikleri kullanarak kullanıcı segmentleri oluşturabilir ya da CRM’de görüntüleyebilirsiniz.

Kullanıcı özniteliklerini ayarlama

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

final builder = AdaptyProfileParametersBuilder()
  ..setEmail("[email protected]")
  ..setPhoneNumber("+18888888888")
  ..setFirstName('John')
  ..setLastName('Appleseed')
  ..setGender(AdaptyProfileGender.other)
  ..setBirthday(DateTime(1970, 1, 3));

try {
  await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
  // handle the error
} catch (e) {
}

updateProfile metoduyla daha önce ayarladığınız özniteliklerin 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 <Key> anahtarları ve <Value> değerleri aşağıda listelenmiştir:

AnahtarDeğer

email

phoneNumber

firstName

lastName

String
genderEnum, izin verilen değerler: female, male, other
birthdayDate

Özel kullanıcı öznitelikleri

Kendi özel özniteliklerinizi 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 seviyesi gibi. Bu öznitelikleri segmentlerde hedefli paywall’lar ve teklifler oluşturmak için kullanabilirsiniz; ayrıca hangi ürün metriklerinin geliri en çok etkilediğini bulmak için analizlerde de işe yarar.

try {
  final builder = AdaptyProfileParametersBuilder()
      ..setCustomStringAttribute('value1', 'key1')
      ..setCustomDoubleAttribute(1.0, 'key2');

await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}

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

try {
  final builder = AdaptyProfileParametersBuilder()
    ..removeCustomAttribute('key1')
    ..removeCustomAttribute('key2');

await Adapty().updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
// handle the error
} catch (e) {
}

Bazen önceden hangi özel özniteliklerin ayarlandığını öğrenmeniz gerekebilir. Bunun için AdaptyProfile nesnesinin customAttributes alanını kullanın.

customAttributes değerinin güncel olmayabileceğini aklınızda bulundurun; kullanıcı öznitelikleri farklı cihazlardan herhangi bir anda gönderilebileceğinden, sunucudaki öznitelikler son senkronizasyondan bu yana değişmiş olabilir.

Sınırlamalar

  • Kullanıcı başına en fazla 30 özel öznitelik
  • Anahtar adları en fazla 30 karakter uzunluğunda olabilir. Anahtar adı alfanümerik karakterler ve şunlardan herhangi birini içerebilir: _ - .
  • Değer, en fazla 50 karakterden oluşan bir string veya float olabilir.