> 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] → Data Sources → Segments**.
2. 选择 **Add Segment**.
3. 在 **Name** 字段中，为该细分输入一个描述性名称。
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] → Participants**.
2. 搜索你想添加到用户细分的特定参与者。
3. 选择其姓名以打开参与者个人资料。
4. 在 *Segments* 卡片上，选择 **Add Segment**.
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] → Data Sources→ Segments**.
2. 找到要添加用户的细分名称。
3. 将光标悬停在要添加参与者的细分名称上，然后选择 **Add Users**.
4. 选择导入类型 **Users**.
5. 使用 [example CSV](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv)，创建一个列表，列出所有要加入特定用户细分的参与者。
6. 选择 **Select File** 并选择准备好的 CSV 文件。
7. 使用下拉列表，选择要将这些参与者添加到的细分。
8. 选择 **Start Import**.
   {% 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] → Participants**.
2. 找到你要从用户细分中移除的特定参与者。
3. 选择其姓名以打开参与者个人资料。
4. 在用户概览的左下角，选择 ![](https://1186853034-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d05e21635c52fff94d35ca4c6b05c1deecc699ef%2F768d04f4d7e1b5b745577812f7d67db99d988bfc34749b6e575a04438d6cee36.svg?alt=media) **\[取消]** 位于参与者不应再加入的细分右侧。
   {% 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> 顺序很重要！要执行设置操作，必须先包含清除 <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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
