在 Kotlin Multiplatform SDK 中设置用户属性

您可以为应用用户设置可选属性，例如电子邮件、电话号码等。您可以使用这些属性来创建用户市场细分，或直接在 CRM 中查看。

设置用户属性

要设置用户属性，请调用 .updateProfile() 方法：

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 方法设置的属性不会被重置。

想了解 Adapty SDK 如何集成到移动应用中的真实示例？请查看我们的示例应用，其中展示了完整的配置过程，包括显示付费墙、完成购买以及其他基本功能。

允许的键列表

AdaptyProfileParameters.Builder 的允许键 <Key> 及其对应值 <Value> 如下所示：

键值

email

phoneNumber

firstName

lastName

String
gender枚举，允许的值为：AdaptyProfile.Gender.FEMALE、AdaptyProfile.Gender.MALE、AdaptyProfile.Gender.OTHER
birthdayDate

自定义用户属性

您可以设置自定义属性，这些属性通常与您的应用使用情况相关。例如，对于健身应用，可以是每周锻炼次数；对于语言学习应用，可以是用户的知识水平，等等。您可以在市场细分中使用这些属性来创建针对性付费墙和优惠，也可以在数据分析中用它们来找出哪些产品指标对收入影响最大。

import com.adapty.kmp.models.AdaptyProfileParameters

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

要删除已有的键，请使用 .withRemovedCustomAttribute() 方法：

import com.adapty.kmp.models.AdaptyProfileParameters

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

有时您需要了解哪些自定义属性已经被设置过。为此，可以使用 AdaptyProfile 对象的 customAttributes 字段。

请注意，customAttributes 的值可能不是最新的，因为用户属性可以随时从不同设备发送，因此服务器上的属性可能在上次同步后已发生变更。

限制

  • 每个用户最多 30 个自定义属性
  • 键名最长 30 个字符，键名可包含字母数字字符及以下任意字符：_ - .
  • 值可以是字符串或浮点数，最长不超过 50 个字符。