> 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
A segmentação é o processo de dividir os participantes do seu programa Advocate em segmentos de usuários, ou grupos, com base em características compartilhadas. Ao segmentar seus participantes, você pode entender melhor os interesses deles, acompanhar sua atividade e fornecer com mais precisão um valor que corresponda às necessidades deles.
{% tabs %}
{% tab title="Fatores demográficos" %}
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 várias características relacionadas ao relacionamento deles com a 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ário**
1. No menu de navegação à esquerda, selecione  **\[Engage] → Fontes de dados → Segmentos**.
2. Selecione **Adicionar segmento**.
3. Na **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ário**
1. No menu de navegação à esquerda, selecione  **\[Engage] → Participantes**.
2. Pesquise o participante específico que você deseja adicionar a um segmento de usuário.
3. Selecione o nome dele para carregar o perfil do participante.
4. Na *Segmentos* cartão, selecione **Adicionar segmento**.
5. Escolha o segmento de usuário no qual você gostaria de incluir este participante.
{% endstep %}
{% step %}
**Etapa 3: Adicionar participantes em massa a um segmento de usuário**
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 [exemplo de CSV](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ário 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ário**
1. No menu de navegação à esquerda, selecione  **\[Engage] → Participantes**.
2. Encontre o participante específico que você deseja adicionar a um segmento de usuário.
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 ao qual o participante não deve mais pertencer.
{% endstep %}
{% endstepper %}
#### Segmentação da API Advocate e do UTT
A API REST do Advocate e a biblioteca JavaScript do UTT também podem ser usadas para gerenciar programaticamente de quais segmentos os participantes são membros.
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 o uso dessas Operações em nossa biblioteca JavaScript do UTT e nos métodos da API em nossa [Documentação da API de Usuário](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user).
{% tabs %}
{% tab title="Operadores" %}
Os operadores a seguir são a base da segmentação de usuários *Operações*, que são usados para gerenciar de quais segmentos um participante é membro.
| 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á tomada. | `mySegmentKey` |
| Excluir | Incluindo a *chave do segmento* com um `~` à sua frente informará ao Advocate para remover o participante do segmento. Se o participante já não fizer parte do segmento, nenhuma ação será tomada. | `~mySegmentKey` |
| Limpar | Incluindo uma *chave*, com um `~` à sua frente, informará ao Advocate para remover o participante de todos os segmentos dos quais ele atualmente faz parte. | `~` |
| {% endtab %} | | |
{% tab title="Operações" %}
As seguintes Operações, criadas usando os *Operadores*disponíveis, permitem que você gerencie de quais segmentos um usuário é membro.
| Operação | Descrição | Exemplo |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
| Adicionar | Adiciona um participante a um segmento. Quaisquer outros segmentos existentes serão mantidos. | `{ "id" : "abc_123", ... "segments" : ["A"] }` |
| Defina | Define 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 clear 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.