Segmentos de Audiencia

Um segmento e um filtro salvo sobre seus condutores. Engage avalia cada segmento contra seu banco de dados ao vivo, entao a contagem que voce ve e a contagem que recebera seu proximo envio.

Navegacao

Segmentos em Engage > Segmentos.

Como funciona a segmentacao

Cada definicao de segmento e uma arvore de grupos AND/OR/NOT contendo regras. O backend Engage compila essa arvore em um SELECT parametrizado contra customers juntado a views de rollup por cliente (engage_ride_agg, engage_wallet_agg, etc.) e executa via RPC engage_run_segment_sql.

A RPC forca uma whitelist apenas-SELECT e bane ponto-e-virgula, entao uma definicao de segmento nunca pode executar escrita arbitraria.

Atributos Disponiveis

Origem	Atributos
`customers`	`created_at`, `language`, `city`, `country`, `timezone`, `marketing_*_consent`, `push_token`, `rider_score`, `rider_score_tier`
`rides` (rollup)	`first_ride_at`, `last_ride_at`, `total_count`, `total_revenue`, `force_ended_count`
`wallet_transactions` (rollup)	`current_balance`, `lifetime_topup`, `last_topup_at`, `auto_topup_enabled`
`subscriptions` (rollup)	`active_plan`, `status`, `next_renewal_at`, `churned_at`
`violations` (rollup)	`total_count`, `last_violation_at`, `severity_max`
`referrals`, `loyalty`	contagens, nivel, saldo de pontos

As views de rollup sao avaliadas em tempo de consulta. Nao ha janela de obsolescencia.

Operadores

Operador	Funciona em	Exemplo
`equals`	texto, numero, booleano	`language = "es"`
`not_equals`	texto, numero, booleano	`country != "BR"`
`greater_than`	numero, data	`rides.total_count > 5`
`less_than`	numero, data	`wallet.current_balance < 3`
`within_last`	data	`last_ride_at within last 30 days`
`more_than_ago`	data	`last_ride_at more than 60 days ago`
`is_set` / `is_null`	qualquer	`push_token is_set`
`in`	texto	`language in ("en", "pt")`

Composicao Booleana

Agrupe regras com AND, OR, NOT. Grupos podem aninhar ate 4 niveis.

Exemplo - Candidatos a Re-Engajamento

AND
├── rides.last_at more than 60 days ago
├── rides.last_at within last 180 days
├── marketing_email_consent = true
└── NOT
    └── violations.severity_max &gt;= "high"

Contagem ao Vivo

Cada segmento mostra contagem ao vivo em cache por 60 segundos.

Construa regras.
Clique Pre-visualizar.
Contagem aparece com 10 linhas de amostra.

Salvar e Reutilizar

Segmentos salvos vivem na sua subconta e sao RLS-escopados.

Clique Salvar.
Nomeie.
Aparece no dropdown Audiencia.

Editar nao afeta campanhas em andamento.

Exportacao CSV

Clique Exportar CSV na pagina de detalhes do segmento.

Segmentos Ad-Hoc

Voce nao precisa salvar todo segmento. O compositor aceita filtro inline:

No compositor, Audiencia > Filtro Personalizado.
Construa as regras.
Engage usa apenas para esse envio.

Segmentos Iniciais Recomendados

Segmento	Definicao
`Ativo 30d`	`last_ride_at within last 30 days`
`Inativo 30-60d`	`last_ride_at between 30 and 60 days ago`
`Inativo 60-90d`	`last_ride_at between 60 and 90 days ago`
`Inativo Profundo 90d+`	`last_ride_at more than 90 days ago`
`Saldo Baixo, Sem Auto-Recarga`	`wallet.current_balance < 3 AND wallet.auto_topup_enabled = false`
`Novos Cadastros, Sem Viagem`	`created_at within last 14 days AND rides.total_count = 0`
`Top 10 %`	`rides.total_count >= 50`
`Lusofonos Ativos`	`language = "pt" AND last_ride_at within last 60 days`
`Renovacao em 7 Dias`	`subscription.next_renewal_at within next 7 days AND subscription.status = "active"`