> 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 a atividade deles e fornecer com mais precisão um valor que atenda às necessidades deles.
{% 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 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ários**
1. No menu de navegação à esquerda, selecione  **\[Engage] → Fontes de dados → Segmentos**.
2. Selecione **Adicionar segmento**.
3. No **Nome** campo, digite 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  **\[Engage] → 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* cartão, 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 [exemplo 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ários específico.
6. Selecione **Selecionar arquivo** e escolha o arquivo CSV preparado por você.
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  **\[Engage] → 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 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 como usar essas Operações em nossa biblioteca JavaScript UTT e nos métodos da API em nossa [Documentação da API de Usuários](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 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á tomada. | `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á tomada. | `~mySegmentKey` |
| Limpar | Incluir uma *chave*, com um `~` na frente dela, 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, construídas usando os *Operadores*operadores disponíveis, 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"] }` |
| 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 de limpeza 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 | Remove 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 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/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 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.