> 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 em comum. Ao segmentar seus participantes, você pode entender melhor os interesses deles, acompanhar a atividade e oferecer valor com mais precisão, de acordo com as necessidades de cada grupo.

{% tabs %}
{% tab title="Fatores demográficos" %}
Os critérios de segmentação mais comuns 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 diversas características relacionadas ao relacionamento deles com sua empresa, como:

* Status de associação
* Categoria 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 segmentos de usuários, adicionar participantes individualmente ou em massa e removê-los dos segmentos.

{% stepper %}
{% step %}
**Etapa 1: criar um segmento de usuários**

1. No menu de navegação à esquerda, selecione ![](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. Selecione **Add Segment**.
3. No campo **Name** insira um nome descritivo para o segmento.
4. Selecione **Adicionar**.
   {% endstep %}

{% step %}
**Etapa 2: adicionar um participante a um segmento de usuários**

1. No menu de navegação à esquerda, selecione ![](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. Pesquise o participante específico que você quer adicionar a um segmento de usuários.
3. Selecione o nome dele para carregar o perfil do participante.
4. No cartão *Segments* selecione **Add Segment**.
5. Escolha o segmento de usuários ao qual quer adicionar esse participante.
   {% endstep %}

{% step %}
**Etapa 3: adicionar participantes em massa a um segmento de usuários**

1. No menu de navegação à esquerda, selecione ![](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. Localize o nome do segmento ao qual quer adicionar usuários.
3. Passe o cursor sobre o nome do segmento ao qual quer adicionar participantes e selecione **Add Users**.
4. Escolha o tipo de importação **Users**.
5. Usando o [example CSV](https://assets.ctfassets.net/s68ib1kj8k5n/37p9zl8fMQvjSW05TRpEiO/8e7f524130ac29092be52f54ba04c7cb/sample-user-upload-hideClassic.csv), crie uma lista com todos os participantes que você quer incluir em um segmento de usuários específico.
6. Selecione **Select File** e escolha o arquivo CSV preparado.
7. Use a lista suspensa para selecionar o segmento ao qual quer adicionar esses participantes.
8. Selecione **Start Import**.
   {% endstep %}

{% step %}
**Etapa 4: Remover um participante de um segmento de usuários**

1. No menu de navegação à esquerda, selecione ![](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. Encontre o participante específico que você quer 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 ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d05e21635c52fff94d35ca4c6b05c1deecc699ef%2F768d04f4d7e1b5b745577812f7d67db99d988bfc34749b6e575a04438d6cee36.svg?alt=media) **\[Cancelar]** à direita do segmento do qual o participante não deve mais fazer parte.
   {% endstep %}
   {% endstepper %}

#### API 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 de um operador) no objeto do usuário da chamada da API ou do método UTT.

Você pode encontrar mais detalhes sobre como usar essas operações na 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 seguintes operadores são a base da segmentação de usuários *Operações*, usadas para gerenciar de quais segmentos um participante faz parte.

| Operador     | Descrição                                                                                                                                                                                       | Exemplo         |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| Adicionar    | Informar apenas a chave do segmento tentará adicionar o participante a ele. Se o participante já fizer parte do segmento, nenhuma ação será realizada.                                          | `mySegmentKey`  |
| Excluir      | Incluir a *chave do segmento* com um `~` na frente informará o Advocate para remover o participante do segmento. Se o participante já não fizer parte do segmento, nenhuma ação será realizada. | `~mySegmentKey` |
| Limpar       | Incluir uma *chave*, com um `~` na frente, informará o 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 com os *operadores*disponíveis, permitem gerenciar 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       | <p>Define o(s) segmento(s) de um participante. Quaisquer outros segmentos existentes serão removidos.</p><p><strong>Importante:</strong> A ordem importa! Para realizar uma operação de definição, o operador <em>Operador</em> <em>(\~)</em> de limpeza deve ser incluído primeiro.</p> | `{ "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 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=<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.
