# Segmentos rastreados

> Os segmentos rastreados registram quem entra e quem sai, e quando. Inicie automações e envie webhooks com as entradas e saídas, e acompanhe o crescimento de um segmento. Alfa: aberto apenas à equipe do Emailit.

Um segmento rastreado é um [segmento](/pt/docs/segments/) que também armazena os seus membros. Quando um contato passa a corresponder às regras dele ou deixa de corresponder, o Emailit registra a mudança, para que você possa:

- iniciar [automações](#start-automations) quando alguém entra ou sai,
- receber [webhooks](#webhooks) das entradas e saídas,
- ver o [crescimento](#growth-and-the-joined-column) do segmento ao longo do tempo e quando cada contato entrou.

As contagens, a lista de contatos e as campanhas funcionam da mesma forma que em qualquer segmento: elas avaliam as regras em tempo real e nunca usam os membros armazenados.

> **Os segmentos estão em alfa:** Os segmentos, rastreados ou não, estão abertos apenas à equipe do Emailit enquanto os testamos. Consulte [Quem pode usar os segmentos](/pt/docs/segments/#who-can-use-segments).

Os segmentos rastreados estão incluídos nos planos Pro, Business e Custom e contam para o mesmo [limite de segmentos](/pt/docs/segments/#limits) que os outros segmentos.

## Criar um segmento rastreado

Ao criar um segmento, escolha **Tracked segment** em **Type**. No Pay as you go, a opção fica desativada e mostra **Upgrade**. Pela API, passe `"tracked": true` para [Criar um segmento](/pt/docs/api-reference/segments/create/).

O tipo não pode ser mudado depois, em nenhuma direção. Para rastrear um segmento existente, crie um novo segmento rastreado com as mesmas regras. **Duplicate** mantém o tipo do original.

Logo depois de ser criado, um segmento rastreado mostra **Recording current members** enquanto o Emailit armazena todos que já correspondem a ele (`tracking.status` é `syncing` na API). Essa primeira contagem não envia eventos nem inicia automações: só os contatos que entram ou saem depois dela contam como mudanças.

## Como os membros são atualizados

| O que acontece | Quando os membros são atualizados | `reason` |
| --- | --- | --- |
| Um contato é criado, editado, excluído, se inscreve ou se descadastra, ou uma etapa de automação o altera | Geralmente em até um minuto | `contact` |
| Uma importação de contatos termina, ou uma lista de contatos é excluída | Quando isso termina, para o segmento inteiro | `contact` |
| Regras que mudam com o tempo, como **Created** nos últimos 30 dias, e mudanças que não geram eventos de contato | Todos os dias às 00:30 UTC, para o segmento inteiro | `schedule` |
| Você edita a origem ou os filtros do segmento | Logo depois que você salva | `segment_updated` |

Cada entrada ou saída é registrada com o seu `reason`. As mudanças causadas pela edição do segmento são enviadas aos webhooks, mas não iniciam automações, para que uma mudança de regras não execute uma automação para todos que ela afeta. Os contatos que saem porque foram excluídos não enviam nenhum evento.

## Iniciar automações

Dois gatilhos de contato partem de um segmento rastreado:

| Gatilho | Chave na API | Inicia uma execução quando |
| --- | --- | --- |
| **Added to segment** | `contact.added_to_segment` | Um contato entra no segmento. |
| **Removed from segment** | `contact.removed_from_segment` | Um contato sai do segmento. |

Escolha o segmento em **Tracked segment** no gatilho. Apenas os segmentos rastreados são listados, e só eles podem ser usados. As execuções geralmente começam em até um minuto após a entrada ou a saída.

Em **Added to segment**, selecione **Also start for contacts already in the segment when the automation is first started** para executar a automação também para os membros atuais. Isso acontece uma vez, no primeiro início da automação, para os membros registrados naquele momento. As configurações de execução da automação, como `allow_reentry` e `cooldown_seconds`, continuam valendo. Consulte [Usar a API](/pt/docs/automations/#use-the-api).

As entradas e saídas também podem encerrar execuções (**Removed from segment** como condição de saída), atingir metas e retomar etapas **Wait until**. Consulte [Condições de saída e metas](/pt/docs/automations/exits-and-goals/).

Um segmento que uma automação usa não pode ser excluído até você alterar essa automação. Consulte [Gatilhos de automação](/pt/docs/automations/triggers/#segment-triggers).

## Webhooks

As entradas e saídas enviam estes eventos de [webhook](/pt/docs/webhooks/):

- [`segment.contact_added`](/pt/docs/webhooks/events/segment/contact-added/) quando um contato entra, com `joined_at`.
- [`segment.contact_removed`](/pt/docs/webhooks/events/segment/contact-removed/) quando um contato sai, com `left_at`.

Os dois trazem o `id` e o `name` do segmento, o `id`, o `email`, os nomes e os campos personalizados do contato, e o `reason` da tabela acima. O **Activity log** do contato também mostra os registros “Joined segment” e “Left segment”.

## Crescimento e a coluna Joined

A página de um segmento rastreado tem um gráfico **Growth** dos últimos 30 dias: os membros (**Members**) no fim de cada dia e quantos contatos entraram (**Joined**) e saíram (**Left**). O histórico começa quando o rastreamento começa, e a primeira contagem não aparece como entradas.

A tabela de contatos ganha uma coluna **Joined** com a data em que começou a permanência atual do contato no segmento. Um contato que sai e volta recebe uma nova data. Ela fica vazia até o rastreamento registrar o contato.

Pela API, use [Obter o crescimento de um segmento](/pt/docs/api-reference/segments/growth/) para até 365 dias e [Listar os contatos de um segmento](/pt/docs/api-reference/segments/contacts/) para `joined_at`.

## Quando o rastreamento é pausado

Se o workspace mudar para um plano sem segmentos rastreados, o rastreamento é pausado. A página do segmento mostra **Tracking is paused** e `tracking.status` é `paused`:

- Os membros deixam de ser atualizados, nenhum evento é enviado e nenhuma automação é iniciada a partir do segmento.
- O segmento continua contando, listando e enviando em tempo real, como qualquer segmento.

Depois que você fizer upgrade de novo, o Emailit registra outra vez os membros atuais na próxima atualização, sem enviar eventos nem iniciar automações, e então o rastreamento continua. As entradas e saídas que aconteceram enquanto o rastreamento estava pausado não são registradas.

## Usar a API

| Tarefa | Endpoint |
| --- | --- |
| Criar um segmento rastreado | [Criar um segmento](/pt/docs/api-reference/segments/create/) com `"tracked": true` |
| Verificar o estado do rastreamento | `tracked` e `tracking` em [Obter um segmento](/pt/docs/api-reference/segments/get/) |
| Membros, entradas e saídas por dia | [Obter o crescimento de um segmento](/pt/docs/api-reference/segments/growth/) |
| Quando cada membro entrou | `joined_at` em [Listar os contatos de um segmento](/pt/docs/api-reference/segments/contacts/) |

No Pay as you go, `"tracked": true` retorna `403` com `"error": "plan_required"` e `"required_plan": "pro"`. [Listar segmentos](/pt/docs/api-reference/segments/list/) retorna `usage.tracking_allowed`, que indica se o plano inclui segmentos rastreados.

## Veja também

  - [Gatilhos de automação](/pt/docs/automations/triggers/): Todos os gatilhos e as opções deles.
  - [Tipos de evento](/pt/docs/webhooks/event-types/): Todos os eventos de webhook que o Emailit envia.

---
Fonte: https://emailit.com/pt/docs/segments/tracked/