Conceito
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 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 quando alguém entra ou sai,
- receber webhooks das entradas e saídas,
- ver o crescimento 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 rastreados estão incluídos nos planos Pro, Business e Custom e contam para o mesmo limite de segmentos 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.
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.
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.
Um segmento que uma automação usa não pode ser excluído até você alterar essa automação. Consulte Gatilhos de automação.
Webhooks
As entradas e saídas enviam estes eventos de webhook:
segment.contact_addedquando um contato entra, comjoined_at.segment.contact_removedquando um contato sai, comleft_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 para até 365 dias e Listar os contatos de um segmento 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 com "tracked": true |
| Verificar o estado do rastreamento | tracked e tracking em Obter um segmento |
| Membros, entradas e saídas por dia | Obter o crescimento de um segmento |
| Quando cada membro entrou | joined_at em Listar os contatos de um segmento |
No Pay as you go, "tracked": true retorna 403 com "error": "plan_required" e "required_plan": "pro". Listar segmentos retorna usage.tracking_allowed, que indica se o plano inclui segmentos rastreados.