> 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/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md).
# 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
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/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/manage-advocate-user-segments.md?ask=&goal=
```
`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.