---
title: "在 Unity SDK 中设置用户属性"
description: "了解如何使用 Adapty SDK 在 Unity 应用中更新用户属性和用户画像数据。"
---

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

### 设置用户属性 \{#setting-user-attributes\}

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

```csharp showLineNumbers
var builder = new Adapty.ProfileParameters.Builder()
        .SetFirstName("John")
        .SetLastName("Appleseed")
        .SetBirthday(new DateTime(1970, 1, 3))
        .SetGender(ProfileGender.Female)
        .SetEmail("example@adapty.io");

Adapty.UpdateProfile(builder.Build(), (error) => {
    if(error != nil) {
        // handle the error                        
    }
});
```

请注意，之前通过 `updateProfile` 方法设置的属性不会被重置。

:::tip

想看看 Adapty SDK 在移动应用中的实际集成示例吗？欢迎查看我们的[示例应用](sample-apps)，其中演示了完整的集成流程，包括展示付费墙、完成购买以及其他基本功能。

:::

### 允许的键列表 \{#the-allowed-keys-list\}

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

| 键 | 值 |
|---|-----|
| <p>email</p><p>phoneNumber</p><p>firstName</p><p>lastName</p> | String |
| gender | 枚举，允许的值为：`female`、`male`、`other` |
| birthday | Date |

### 自定义用户属性 \{#custom-user-attributes\}

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

```csharp showLineNumbers
try {
    builder = builder.SetCustomStringAttribute("string_key", "string_value");
    builder = builder.SetCustomDoubleAttribute("double_key", 123.0f);
} catch (Exception e) {
    // handle the exception
}
```

要删除现有键，请使用 `.withRemoved(customAttributeForKey:)` 方法：

```csharp showLineNumbers
try {
    builder = builder.RemoveCustomAttribute("key_to_remove");
} catch (Exception e) {
    // handle the exception
}
```

有时您需要查看已设置的自定义属性。为此，请使用 `AdaptyProfile` 对象的 `customAttributes` 字段。

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

### 限制 \{#limits\}

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