# Gerenciar Segmentos de Usuários do Advocate
Segmentação é o processo de dividir os participantes do seu programa Advocate em segmentos de usuários, ou grupos, com base em características em comum. Ao segmentar seus participantes, você pode entender melhor seus interesses, acompanhar suas atividades e fornecer com mais precisão um valor que corresponda às suas necessidades.
{% tabs %}
{% tab title="Fatores demográficos" %}
Os critérios comuns de segmentação incluem fatores demográficos como:
* Idade
* Gênero
* Localização
* Setor de atuação
* Local de trabalho
* Renda
{% endtab %}
{% tab title="Fatores de relacionamento" %}
Você também pode segmentar usuários com base em uma série de características relacionadas ao relacionamento deles com sua empresa, como:
* Status de associação
* Nível do plano de assinatura
* Data da última compra
* Data de cadastro
* Dispositivo
{% endtab %}
{% endtabs %}
#### Gerenciar segmentos de usuários
No seu programa Advocate, você pode criar novos segmentos de usuários, adicionar participantes individuais a segmentos de usuários, adicionar participantes a segmentos de usuários em massa e remover participantes de segmentos de usuários.
{% stepper %}
{% step %}
**Etapa 1: Criar um segmento de usuários**
1. No menu de navegação à esquerda, selecione  **\[Engage] → Fontes de dados → Segmentos**.
2. Selecione **Adicionar segmento**.
3. No **Nome** campo, insira um nome descritivo para o segmento.
4. Selecione **Adicionar**.
{% endstep %}
{% step %}
**Etapa 2: Adicionar um único participante a um segmento de usuários**
1. No menu de navegação à esquerda, selecione  **\[Engajar] → Participantes**.
2. Pesquise o participante específico que você deseja adicionar a um segmento de usuários.
3. Selecione o nome dele para carregar o perfil do participante.
4. Na *Segmentos* card, selecione **Adicionar segmento**.
5. Escolha o segmento de usuários no qual você gostaria de incluir este participante.
{% endstep %}
{% step %}
**Etapa 3: Adicionar participantes em massa a um segmento de usuários**
1. No menu de navegação à esquerda, selecione  **\[Engage] → Fontes de dados→ Segmentos**.
2. Encontre o nome do segmento ao qual você deseja adicionar usuários.
3. Passe o cursor sobre o nome do segmento ao qual você deseja adicionar participantes e selecione **Adicionar usuários**.
4. Escolha o tipo de importação **Usuários**.
5. Usando o [CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), crie uma lista de todos os participantes que você gostaria de incluir em um segmento de usuários específico.
6. Selecione **Selecionar arquivo** e escolha o arquivo CSV preparado.
7. Use a lista suspensa para selecionar o segmento ao qual você deseja adicionar esses participantes.
8. Selecione **Iniciar importação**.
{% endstep %}
{% step %}
**Etapa 4: Remover um participante de um segmento de usuários**
1. No menu de navegação à esquerda, selecione  **\[Engajar] → Participantes**.
2. Encontre o participante específico que você deseja adicionar a um segmento de usuários.
3. Selecione o nome dele para carregar o perfil do participante.
4. No canto inferior esquerdo da visão geral do usuário, selecione  **\[Cancelar]** à direita do segmento do qual o participante não deve mais fazer parte.
{% endstep %}
{% endstepper %}
#### API do Advocate e segmentação UTT
A API REST do Advocate e a biblioteca Javascript UTT também podem ser usadas para gerenciar programaticamente de quais segmentos os participantes fazem parte.
Essa funcionalidade pode ser acessada incluindo uma ou mais das seguintes "operações" (uma combinação do nome do segmento e um operador) no objeto de usuário da chamada da API ou do método UTT.
Você pode encontrar mais detalhes sobre como usar essas operações em nossa biblioteca Javascript UTT e nos métodos da API em nossa [Documentação da API de Usuário](https://integrations.impact.com/impact-brand/reference/user).
{% tabs %}
{% tab title="Operadores" %}
Os operadores a seguir são a base para a segmentação de usuários *Operações*, que são usados para gerenciar de quais segmentos um participante faz parte.
| Operador | Descrição | Exemplo |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Adicionar | Fornecer apenas a chave do segmento tentará adicionar o participante ao segmento. Se o participante já fizer parte do segmento, nenhuma ação será executada. | `mySegmentKey` |
| Excluir | Incluir a *chave do segmento* com um `~` na frente dela informará ao Advocate para remover o participante do segmento. Se o participante já não fizer parte do segmento, nenhuma ação será executada. | `~mySegmentKey` |
| Limpar | Incluir uma *chave*, com um `~` na frente dela, informará ao Advocate para remover o participante de todos os segmentos dos quais ele faz parte atualmente. | `~` |
| {% endtab %} | | |
{% tab title="Operações" %}
As seguintes operações, criadas usando os *Operadores*, permitem que você gerencie de quais segmentos um usuário faz parte.
| Operação | Descrição | Exemplo |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
| Adicionar | Adiciona um participante a um segmento. Quaisquer outros segmentos existentes serão mantidos. | `{ "id" : "abc_123", ... "segments" : ["A"] }` |
| Definir | Defina o(s) segmento(s) de um participante. Quaisquer outros segmentos existentes serão removidos.
Importante: A ordem importa! Para executar uma operação de definição, o sinal de limpar Operador (\~) deve ser incluído primeiro.
| `{ "id" : "abc_123", ... "segments" : ["~","A" ] }` |
| Remover | Remove um participante de um segmento. Quaisquer outros segmentos existentes serão mantidos. | `{ "id" : "abc_123", ... "segments" : ["~A"] }` |
| Limpar | Limpa todos os segmentos configurados para um participante. | `{ "id" : "abc_123", ... "segments" : ["~*"] }` |
| {% endtab %} | | |
| {% endtabs %} | | |
---
# Agent Instructions: 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:
```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.