> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md).

# 管理员工 Advocate 用户分群

细分是将您的 Advocate 项目的参与者划分为基于共同特征的用户细分或群组的过程。通过对参与者进行细分，您可以更好地了解他们的兴趣，跟踪他们的活动，并更准确地提供符合其需求的价值。

{% tabs %}
{% tab title="人口统计因素" %}
常见的细分标准包括以下人口统计因素：

* 年龄
* 性别
* 位置
* 工作行业
* 工作单位
* 收入
  {% endtab %}

{% tab title="关系因素" %}
您也可以根据与您的业务关系相关的多种特征来细分用户，例如：

* 会员状态
* 订阅计划等级
* 上次购买日期
* 注册日期
* 设备
  {% endtab %}
  {% endtabs %}

#### 管理用户细分

在您的 Advocate 项目中，您可以创建新的用户细分，将单个参与者添加到用户细分中，批量将参与者添加到用户细分中，以及从用户细分中移除参与者。

{% stepper %}
{% step %}
**步骤 1：创建用户细分**

1. 在左侧导航菜单中，选择 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → 数据源 → 细分**.
2. 选择 **添加细分**.
3. 在 **名称** 字段中，输入该细分的描述性名称。
4. 选择 **添加**.
   {% endstep %}

{% step %}
**步骤 2：将单个参与者添加到用户细分**

1. 在左侧导航菜单中，选择 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → 参与者**.
2. 搜索您想要添加到用户细分中的特定参与者。
3. 选择他们的姓名以加载其参与者资料。
4. 在 *细分* 卡片中，选择 **添加细分**.
5. 选择您想要将该参与者包含在内的用户细分。
   {% endstep %}

{% step %}
**步骤 3：批量将参与者添加到用户细分**

1. 在左侧导航菜单中，选择 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → 数据源→ 细分**.
2. 找到您想要添加用户到其中的细分名称。
3. 将光标悬停在您想要添加参与者的细分名称上，然后选择 **添加用户**.
4. 选择导入类型 **用户**.
5. 使用 [示例 CSV](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv)，创建您希望包含在特定用户细分中的所有参与者列表。
6. 选择 **选择文件** 并选择您准备好的 CSV 文件。
7. 使用下拉列表选择您想要将这些参与者添加到其中的细分。
8. 选择 **开始导入**.
   {% endstep %}

{% step %}
**步骤 4：从用户细分中移除参与者**

1. 在左侧导航菜单中，选择 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → 参与者**.
2. 找到您想要添加到用户细分中的特定参与者。
3. 选择他们的姓名以加载其参与者资料。
4. 在用户概览的左下角，选择 ![](/files/0e61567b8a836f0b527386fa1c15c90d09c888ab) **\[取消]** 位于该参与者不应再所属细分的右侧。
   {% endstep %}
   {% endstepper %}

#### Advocate API 和 UTT 细分

Advocate REST API 和 UTT Javascript 库也可用于以编程方式管理参与者所属的细分。

通过在 API 调用或 UTT 方法的用户对象中包含以下一个或多个“操作”（细分名称和运算符的组合），即可访问此功能。

有关在我们的 UTT Javascript 库和 API 方法中使用这些操作的更多详细信息，您可以在我们的 [用户 API 文档](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user).

{% tabs %}
{% tab title="运算符" %}
以下运算符是用户细分的基础 *运营*，用于管理参与者所属的细分。

| 运算符          | 说明                                                                    | 示例              |
| ------------ | --------------------------------------------------------------------- | --------------- |
| 添加           | 仅提供细分键会尝试将参与者添加到该细分中。如果参与者已经属于该细分，则不会执行任何操作。                          | `mySegmentKey`  |
| 删除           | 包含 *细分键* 以及前面的 `~` 将告知 Advocate 从该细分中移除该参与者。如果参与者本来就不属于该细分，则不会执行任何操作。 | `~mySegmentKey` |
| 清除           | 包含一个 *键*，并在前面加上 `~` ，将告知 Advocate 从该参与者当前所属的所有细分中将其移除。                | `~`             |
| {% endtab %} |                                                                       |                 |

{% tab title="运营" %}
以下操作，使用可用的 *运算符*，可让您管理用户所属的细分。

| 操作            | 说明                                                                                                                     | 示例                                                  |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| 添加            | 将参与者添加到某个细分中。任何其他现有细分都将保留。                                                                                             | `{ "id" : "abc_123", ... "segments" : ["A"] }`      |
| 设置            | <p>为参与者设置细分。任何其他现有细分都将被移除。</p><p><strong>重要：</strong> 顺序很重要！要执行 set 操作，应先包含 clear。 <em>运算符</em> <em>(\~)</em> 应先包含</p> | `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| 删除            | 从某个细分中移除参与者。任何其他现有细分都将保留。                                                                                              | `{ "id" : "abc_123", ... "segments" : ["~A"] }`     |
| 清除            | 清除为参与者配置的所有细分。                                                                                                         | `{ "id" : "abc_123", ... "segments" : ["~*"] }`     |
| {% endtab %}  |                                                                                                                        |                                                     |
| {% endtabs %} |                                                                                                                        |                                                     |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/zh/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
