# 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, que são baseados em características compartilhadas. Ao segmentar seus participantes, você pode entender melhor seus interesses, acompanhar suas atividades e fornecer com mais precisão valor que corresponda às suas necessidades.

{% tabs %}
{% tab title="Fatores demográficos" %}
Critérios comuns de segmentação incluem fatores demográficos como:

* Idade
* Gênero
* Localização
* Setor de trabalho
* 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
* 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 %}

#### **Passo 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] → Fontes de Dados → Segmentos**.
2. Selecione **Adicionar Segmento**.
3. No **campo Nome** insira um nome descritivo para o segmento.
4. Selecione **Adicionar**.
   {% endstep %}

{% step %}

#### **Passo 2: Adicionar um único 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] → Participantes**.
2. Procure 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 *cartão Segmentos* selecione **Adicionar Segmento**.
5. Escolha o segmento de usuários no qual você gostaria de incluir este participante.
   {% endstep %}

{% step %}

#### **Passo 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] → 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 que fossem incluídos em um segmento de usuários específico.
6. Selecione **Selecionar Arquivo** e escolha seu 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 %}

#### **Passo 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] → Participantes**.
2. Encontre o participante específico que você deseja remover de 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 %}

#### Segmentação via Advocate API e UTT

A REST API do Advocate e a biblioteca UTT Javascript 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 do usuário na chamada da API ou no método UTT.

Você pode encontrar mais detalhes sobre o uso dessas Operações em nossa biblioteca UTT Javascript e métodos de API em nossa [Documentação da API do Usuário](https://integrations.impact.com/impact-brand/reference/user).

{% tabs %}
{% tab title="Operadores" %}
Os seguintes operadores são a base para as *Operações*, que são usadas 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.                                     | `minhaChaveDeSegmento`  |
| Excluir      | Incluir a *chave do segmento* com um `~` na 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. | `~minhaChaveDeSegmento` |
| Limpar       | Incluir uma *chave*, com um `~` na 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, construídas usando os *Operadores*disponíveis

| , permitem que você gerencie de quais segmentos um usuário é membro. | Descrição                                                                                                                                                                                                                                          | Exemplo                                                                                         |
| -------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Adicionar                                                            | Operação                                                                                                                                                                                                                                           | `Adiciona um participante a um segmento. Quaisquer outros segmentos existentes serão mantidos.` |
| { "id" : "abc\_123", ... "segments" : \["A"] }                       | <p>Definir</p><p><strong>Defina o(s) segmento(s) para um participante. Quaisquer outros segmentos existentes serão removidos.</strong> Importante: <em>Operador</em> <em>(\~)</em> A ordem importa! Para executar uma operação de definição, o</p> | `limpar`                                                                                        |
| deve ser incluído primeiro.                                          | { "id" : "abc\_123", ... "segments" : \["\~","A" ] }                                                                                                                                                                                               | `Remover`                                                                                       |
| Limpar                                                               | Remover um participante de um segmento. Quaisquer outros segmentos existentes serão mantidos.                                                                                                                                                      | `{ "id" : "abc_123", ... "segments" : ["~*"] }`                                                 |
| {% endtab %}                                                         |                                                                                                                                                                                                                                                    |                                                                                                 |
| {% endtabs %}                                                        |                                                                                                                                                                                                                                                    |                                                                                                 |
