在 iOS SDK 中设置用户属性

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

设置用户属性

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

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

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

允许的键列表

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

键值

键	值
email phoneNumber firstName lastName	String
gender	枚举类型，允许的值为：`female`、`male`、`other`
birthday	Date

phoneNumber

firstName

lastName

String

gender 枚举类型，允许的值为：female、male、other

birthday Date

自定义用户属性

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

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

要移除已有的键，请使用 .withRemoved(customAttributeForKey:) 方法：

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

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

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

限制

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