Ontologia de Dados

Todos os 101 campos de perfil da UserIn organizados por tipo: atributos, agregados, sinais e outputs, com origem, lógica e uso de cada um.

A ontologia é a forma como a UserIn organiza todos os dados que conhece sobre cada visitante. Cada campo pertence a um dos 4 tipos, que determina como é preenchido, com que frequência é atualizado e como interpretá-lo ao criar regras, segmentos e automações.

Todos os campos aparecem juntos no construtor de condições, independente do tipo. Campos marcados com iGaming só estão disponíveis para empresas configuradas na vertical bets.

Nesta página:

• Os 4 tipos de dados
• Atributos
• Agregados
• Sinais
• Outputs
• Sinais customizados
• Campos customizados
• Como usar campos em condições
• Exemplos práticos

---

Os 4 tipos de dados

Atributos

Fatos registrados. Chegam via integração ou tracker e são armazenados como vieram, sem transformação. Exemplos: ID externo, email, valor do primeiro depósito, saldo inicial da sessão.

Atualização: apenas quando a integração envia um novo valor.

Agregados

Totais, contagens e médias. Calculados automaticamente somando ou contando eventos recebidos. Exemplos: total apostado, quantidade de sessões, GGR total, wins na última hora.

Atualização: em tempo real a cada evento recebido.

Sinais

Interpretações inteligentes. Derivados dos dados brutos usando janelas temporais, thresholds e lógica de negócio. Exemplos: tier de depósito, tendência, nível de frustração, melhor horário de contato.

Atualização: periódica (RT, diária ou semanal conforme o sinal).

Outputs

Resultados de modelos de decisão. Calculados combinando múltiplos campos com pesos. Exemplos: score de intenção, tier VIP, melhor ação de retenção, canal recomendado.

Atualização: diária.

A diferença prática: um Atributo diz o que aconteceu (“depositou R$ 50 pela primeira vez”), um Sinal interpreta (“está em sequência de perdas”), um Output recomenda (“ofertar freespin agora pelo canal onsite_modal”).

---

Atributos

Dados que chegam via integração ou tracker e são armazenados como vieram. Não são calculados pela plataforma.

Identidade

Campos internos de identificação do visitante. Não aparecem no construtor de condições, mas são a base de todo o perfil.

Path	Label	Descrição
externalId	ID Externo	ID do visitante no sistema do cliente (ex: user_id)
companyId	ID da Empresa	ID da empresa / tenant
visitorId	Visitor ID	Último localStorage ID usado pelo visitante

---

Temporal

Path	Label	Descrição
firstSeenAt	Primeiro Acesso	Data e hora do primeiro registro no sistema
lastUpdatedAt	Última Atualização	Data e hora da última atualização do perfil

---

Financeiro

Path	Label	Descrição	Selecionável
deposits.ftd.amount	Valor do 1º Depósito (R$)	Valor do primeiro depósito. Imutável após o registro.	✓
deposits.ftd.date	Data do 1º Depósito	Data e hora do primeiro depósito. Imutável.	—

---

Comportamento

Path	Label	Descrição
behavior.lastActiveAt	Última Atividade	Data e hora da última atividade registrada

---

Navegação

Path	Label	Descrição	Selecionável
navigation.lastSession.pages	Páginas da Última Sessão	Lista de páginas visitadas na última sessão. Use “contém” para detectar uma página específica.	✓

Use Páginas da Última Sessão contém /deposito para disparar um modal em tempo real para visitantes que estão na tela de depósito neste momento.

---

Contato

Informações pessoais vinculadas via integração ou formulário.

Path	Label	Variável Liquid	Selecionável
contact.firstName	Nome	{{ contact.firstName }}	✓
contact.lastName	Apelido	{{ contact.lastName }}	✓
contact.email	Email	{{ contact.email }}	✓
contact.phone	Telefone	{{ contact.phone }}	✓

Campos de contato precisam chegar via integração (evento de identificação do tracker ou API REST). Sem o External ID vinculado ao perfil, esses campos não são preenchidos.

---

iGaming: Jogo favorito (objeto Game)

Atributos do jogo vinculado ao perfil via integração de catálogo. Disponível para vertical bets.

Path	Label	Variável Liquid	Selecionável
game.name	Nome do Jogo	{{ game.name }}	✓
game.category	Categoria do Jogo	{{ game.category }}	✓
game.provider	Provider do Jogo	{{ game.provider }}	✓
game.url	URL do Jogo	{{ game.url }}	✓
game.rtp	RTP %	{{ game.rtp }}	✓

Exemplo de personalização:

Olá, {{ contact.firstName }}! Que tal uma rodada no {{ game.name }}?
Provider: {{ game.provider }} — RTP: {{ game.rtp }}%

---

iGaming: Saldo de entrada na sessão

Disponível para plataformas com integração de wallet ativa.

Path	Label	Descrição	Selecionável
balanceRealtime.current	Saldo Atual (R$)	Saldo atual do visitante em tempo real na sessão	✓
balanceRealtime.sessionStart	Saldo Início da Sessão (R$)	Saldo que o visitante tinha quando iniciou a sessão	✓

---

Agregados

Calculados automaticamente pela plataforma somando, contando ou fazendo média de eventos. Não exigem configuração além da integração base.

Ciclo de vida

Path	Kind	Label	Valores	Selecionável
stage	AGG	Stage do Visitante	anonymous · registered · ftd · mtd	✓

Valor	Quando ocorre	Estratégia
anonymous	Visitante sem identificação	Capturar cadastro via modal
registered	Criou conta, sem depósito	Ativar com bônus de boas-vindas
ftd	Primeiro depósito realizado	Onboarding e engajamento inicial
mtd	Segundo depósito em diante	Retenção, fidelização e upsell

O stage nunca retrocede. Um visitante ftd permanece ftd mesmo que fique meses sem atividade. Use Dias Desde Último Depósito para identificar inativos dentro de cada stage.

---

Temporal

Path	Label	Descrição
bestTime.totalSessionsAnalyzed	Sessões Analisadas	Quantidade de sessões usadas para calcular o melhor horário de contato

---

Financeiro

Path	Label	Descrição	Atualização
deposits.count	Qtd. de Depósitos	Quantidade total de depósitos realizados	RT
deposits.total	Total Depositado (R$)	Soma de todos os valores depositados	RT
deposits.average	Ticket Médio (R$)	Valor médio por depósito (total ÷ count)	RT
deposits.last.amount	Valor Último Depósito (R$)	Valor do depósito mais recente	RT
deposits.last.date	Data Último Depósito	Data e hora do último depósito	RT
deposits.weekly.avgAmountPerWeek	Média Valor/Semana (R$)	Média de valor depositado por semana	Diária
deposits.weekly.avgCountPerWeek	Média Depósitos/Semana	Média de quantidade de depósitos por semana	Diária
deposits.last5Weeks.count	Depósitos (Últ. 5 Semanas)	Quantidade de depósitos nas últimas 5 semanas	Diária
deposits.last5Weeks.total	Total (Últ. 5 Semanas) (R$)	Valor total depositado nas últimas 5 semanas	Diária

Compare Total Depositado com Total (Últ. 5 Semanas) para detectar jogadores que estavam ativos mas reduziram volume recentemente, sem esperar pelos sinais de tendência.

---

Comportamento

Path	Label	Descrição	Atualização
behavior.totalSessions	Total de Sessões	Quantidade total de sessões desde o primeiro acesso	Diária
behavior.deviceCount	Qtd. de Dispositivos	Quantidade de dispositivos diferentes usados	Diária

---

Preferências e jogos

Path	Label	Descrição	Vertical	Atualização
favoriteGame.visits	Jogo Favorito (Visitas)	Quantidade de visitas ao jogo mais acessado	Todas	Diária
preferences.totalPageViews	Total de Page Views	Total de visualizações de página	Todas	Diária
preferences.uniquePages	Páginas Únicas Visitadas	Quantidade de páginas únicas visitadas	Todas	Diária
preferences.categories.casino	Visitas Casino	Acessos a páginas de cassino	bets	Diária
preferences.categories.sports	Visitas Sports	Acessos a páginas de apostas esportivas	bets	Diária
preferences.categories.slots	Visitas Slots	Acessos a páginas de slots	bets	Diária

---

Navegação

Path	Label	Descrição	Atualização
navigation.allVisitedPages	Todas as Páginas Visitadas	Lista de todas as URLs únicas já visitadas	Diária

---

iGaming: Saldo em tempo real

Path	Label	Descrição	Atualização
balanceRealtime.variationCount	Vezes que Saldo Mudou	Número de vezes que o saldo variou na sessão (apostas e ganhos)	RT

---

iGaming: Apostas — betting

Métricas de apostas com saldo real. Disponível para vertical bets.

All-time e janelas longas:

Path	Label	Descrição	Janela
betting.totalBetAmount	Total Apostado (R$)	Soma total de apostas com saldo real	All-time
betting.totalWinAmount	Total Ganho (R$)	Soma total de ganhos com saldo real	All-time
betting.totalGGR	GGR Total (R$)	Gross Gaming Revenue acumulado (totalBetAmount − totalWinAmount)	All-time
betting.betCount	Qtd. Apostas	Quantidade total de apostas realizadas	All-time
betting.winCount	Qtd. Wins	Quantidade total de rodadas ganhas	All-time
betting.lossCount	Qtd. Losses	Quantidade total de rodadas perdidas	All-time
betting.freespinCount	Qtd. Freespins	Quantidade total de rodadas grátis utilizadas	All-time
betting.freespinWinAmount	Ganho em Freespin (R$)	Total ganho em rodadas grátis	All-time
betting.last5Weeks.betAmount	Apostado Últ. 5 Sem (R$)	Total apostado nas últimas 5 semanas	5 semanas
betting.last5Weeks.ggr	GGR Últ. 5 Sem (R$)	GGR nas últimas 5 semanas	5 semanas

Janelas curtas (comportamento recente e em sessão):

Path	Label	Descrição	Janela
betting.last1h.lossCount	Losses Últ. 1h	Quantidade de perdas na última hora	1 hora
betting.last1h.winCount	Wins Últ. 1h	Quantidade de wins na última hora	1 hora
betting.last1h.betAmount	Apostado Últ. 1h (R$)	Total apostado na última hora	1 hora
betting.last24h.betAmount	Apostado Últ. 24h (R$)	Total apostado nas últimas 24 horas	24 horas
betting.last24h.ggr	GGR Últ. 24h (R$)	GGR nas últimas 24 horas	24 horas
betting.last.game	Último Jogo	Nome do último jogo apostado	RT
betting.last.provider	Último Provider	Provider do último jogo apostado	RT

Os campos de janela curta (last1h, last24h) são fundamentais para detectar comportamentos de risco em tempo real dentro da sessão. Use-os combinados com os sinais de frustração para acionar intervenções imediatas.

---

Sinais

Derivações calculadas pela plataforma a partir dos dados brutos. Cada sinal usa janela temporal, threshold ou lógica específica para responder uma pergunta de negócio.

Temporal — melhor horário de contato

Melhor Hora do Dia

Path: bestTime.bestHour

Hora do dia (0–23) em que o visitante mais costuma acessar a plataforma.

Como é calculado: Moda das horas de início de sessão, analisando o histórico completo de sessões.

Atualização: Diária.

Uso: Agendar envio de SMS e email no horário de pico individual de cada visitante.

Melhor Dia da Semana

Path: bestTime.bestDayHour.dayOfWeek

Dia da semana preferido do visitante (0=Domingo, 6=Sábado).

Como é calculado: Moda dos dias de início de sessão no histórico completo.

Atualização: Diária.

Uso: Concentrar campanhas nos dias de maior receptividade por visitante.

Nome do Melhor Dia

Path: bestTime.bestDayHour.dayName

Nome legível do dia da semana preferido (ex: “Segunda”).

Como é calculado: Derivado de bestTime.bestDayHour.dayOfWeek.

Uso: Personalização de mensagens via Liquid: “Você costuma jogar às {{ bestTime.bestHour }}h nas {{ bestTime.bestDayHour.dayName }}s”.

Horário Proposto para Contato

Path: bestTime.proposedContactLocal

Combinação formatada do melhor dia e hora (ex: “Segunda às 14:00”).

Como é calculado: Derivado de bestTime.bestHour + bestTime.bestDayHour.dayOfWeek.

Atualização: Diária.

Uso: Exibir em painéis de CRM para que agentes saibam o melhor momento de contato sem precisar calcular manualmente.

---

Financeiro

Dias Desde Último Depósito

Path: deposits.daysSinceLastDeposit

Contador dinâmico de quantos dias se passaram desde o último depósito.

Como é calculado: Data atual menos deposits.last.date. Aumenta automaticamente a cada dia sem depósito.

Atualização: RT (calculado no momento da avaliação da condição).

Uso:

• 7 dias: modal de incentivo suave

• 14 dias: SMS com oferta de retorno

• 30 dias: jornada de reativação completa

• 60 dias: sinalizar como churned para o CRM

Tier de Depósitos

Path: deposits.tier

Classifica o visitante por faixa de valor total depositado.

Como é calculado: Com base em deposits.total:

Tier	Faixa	Perfil
none	R$ 0	Nunca depositou
low	R$1 a R$ 100	Jogador inicial
medium	R$100 a R$ 500	Jogador regular
high	R$500 a R$ 2.000	Alto valor, candidato a VIP
whale	Acima de R$ 2.000	Premium, tratamento diferenciado

Atualização: Diária.

Tendência de Depósitos

Path: deposits.trend

Indica se o padrão geral de depósitos está crescendo, estável ou caindo.

Como é calculado: Análise das últimas 5 semanas de depósitos. Variação > +20% = increasing; < -20% = decreasing; entre = stable.

Valor	Interpretação	Ação
increasing	Jogador em crescimento	Momento de upsell
stable	Padrão mantido	Manter engajamento
decreasing	Sinal de risco	Iniciar retenção
unknown	Dados insuficientes	Aguardar mais sessões

Atualização: Diária, janela de 5 semanas.

Tendência (Últ. 5 Semanas)

Path: deposits.last5Weeks.trend

Comparação específica das últimas 5 semanas com as 5 semanas anteriores.

Valores: up · down · stable · none

Como é calculado: Compara deposits.last5Weeks.count e deposits.last5Weeks.total com o período equivalente anterior.

Atualização: Diária.

Uso: Mais sensível que deposits.trend para detectar mudanças recentes de comportamento.

---

Comportamento

Sessões por Semana

Path: behavior.sessionsPerWeek

Média de sessões por semana do visitante.

Como é calculado: behavior.totalSessions ÷ semanas desde firstSeenAt.

Atualização: Diária.

Uso: Principal indicador de engajamento. Acima de 5 sessões/semana indica visitante altamente ativo.

Duração Média da Sessão

Path: behavior.avgSessionDurationMinutes

Tempo médio por sessão, em minutos.

Como é calculado: Média da duração de todas as sessões registradas pelo tracker.

Atualização: Diária.

Uso: Sessões acima de 30 minutos combinadas com losses frequentes ativam o protocolo de jogo responsável.

Dias Inativo

Path: daysInactive

Dias sem qualquer atividade na plataforma (não apenas depósitos).

Como é calculado: Data atual menos behavior.lastActiveAt. Calculado dinamicamente.

Atualização: RT.

Uso: Diferente de “Dias Desde Último Depósito” (que foca em transações), este campo captura inatividade total, incluindo visitantes que entram mas não depositam.

Dias Desde Criação

Path: daysSinceCreation

Quantidade de dias desde que o perfil foi criado no sistema.

Como é calculado: Data atual menos firstSeenAt. Calculado dinamicamente.

Atualização: RT.

Uso: Identificar visitantes registrados há muito tempo que nunca converteram em ftd.

---

Preferências — jogo favorito

Nome do Jogo Favorito

Path: favoriteGame.name

Nome do jogo ou produto mais visitado pelo jogador.

Como é calculado: Análise de page views por jogo. O jogo com mais acessos se torna o favorito.

Atualização: Diária.

Uso: Personalização de mensagens com {{ favoriteGame.name }}.

URL do Jogo Favorito

Path: favoriteGame.url

URL ou path do jogo favorito (ex: /games/aviator).

Como é calculado: Derivado de favoriteGame.name via análise de navegação.

Atualização: Diária.

Uso: Criar CTAs com link direto para o jogo favorito em modais e SMS.

Categoria do Jogo Favorito

Path: favoriteGame.category

Categoria do jogo favorito (ex: slots, crash, casino, live).

Como é calculado: Derivado de favoriteGame.name.

Atualização: Diária.

Uso: Segmentar visitantes por vertical preferida sem precisar comparar contadores de visitas individuais.

---

iGaming: Saldo em tempo real

Ganhou/Perdeu na Sessão (R$)

Path: balanceRealtime.sessionNetChange

Diferença em reais entre o saldo atual e o saldo de início da sessão.

Fórmula: balanceRealtime.current − balanceRealtime.sessionStart

Positivo = ganhou. Negativo = perdeu.

Atualização: RT, durante a sessão ativa.

Ganhou/Perdeu na Sessão (%)

Path: balanceRealtime.sessionNetChangePercent

Variação percentual do saldo na sessão atual.

Fórmula: (balanceRealtime.current − balanceRealtime.sessionStart) ÷ balanceRealtime.sessionStart × 100

Ex: -50 significa que perdeu 50% do saldo inicial.

Atualização: RT, durante a sessão ativa.

Uso: Acionar intervenção de jogo responsável quando < -50%.

Sequência de Perdas

Path: balanceRealtime.isLosingStreak

Indica se o visitante perdeu 3 ou mais vezes seguidas na sessão atual.

Lógica: balanceRealtime.variationCount com 3+ variações negativas consecutivas.

Atualização: RT.

Uso: Exibir mensagem de pausa ou jogo responsável antes que as perdas se acumulem.

Saldo Chegou a Zero

Path: balanceRealtime.hitZeroThisSession

Indica se o saldo do visitante chegou a zero durante esta sessão.

Lógica: balanceRealtime.current = 0 em qualquer momento da sessão.

Atualização: RT.

Uso: Exibir oferta de recarga ou mensagem de encerramento de sessão.

Perdeu 50%+ do Saldo

Path: balanceRealtime.alert50Triggered

Indica se o visitante já perdeu 50% ou mais do saldo inicial da sessão.

Lógica: balanceRealtime.sessionNetChangePercent ≤ −50.

Atualização: RT.

Uso: Gatilho principal de alerta de jogo responsável. Aciona antes da perda total.

Perdeu 80%+ do Saldo

Path: balanceRealtime.alert80Triggered

Indica se o visitante já perdeu 80% ou mais do saldo inicial da sessão.

Lógica: balanceRealtime.sessionNetChangePercent ≤ −80.

Atualização: RT.

Uso: Gatilho de intervenção crítica. Exibir modal obrigatório de pausa ou suporte.

---

iGaming: Jogo favorito

Volatilidade do Jogo

Path: game.volatility

Nível de volatilidade do jogo favorito do visitante.

Valores: low · medium · high

Como é calculado: Derivado do atributo de catálogo do jogo (configurado na integração).

Uso: Personalizar sugestões de jogos. Visitantes com histórico de alert80Triggered e jogo de volatilidade high têm maior risco de frustração.

---

iGaming: Apostas — comportamento e frustração

Tier de Aposta

Path: betting.tier

Classifica o jogador por volume total apostado.

Como é calculado: Com base em betting.totalBetAmount:

Tier	Faixa	Perfil
casual	Até R$ 1.000	Jogador esporádico
regular	R$1.000 a R$ 10.000	Jogador consistente
high_roller	R$10.000 a R$ 100.000	Alto volume de apostas
whale	Acima de R$ 100.000	Volume máximo, tratamento premium

Atualização: Diária.

Tier de Aposta (betting.tier) é diferente de Tier de Depósitos (deposits.tier). O primeiro mede volume apostado; o segundo mede valor depositado. Um jogador pode ser high_roller em apostas e low em depósitos se jogar com freespins.

Taxa de Win (%)

Path: betting.winRate

Percentual de rodadas ganhas sobre o total de apostas.

Fórmula: betting.winCount ÷ betting.betCount × 100

Atualização: Diária.

Uso: Jogadores com winRate abaixo de 15% estão perdendo consistentemente, indicador de possível frustração acumulada.

Sequência de Perdas (Apostas)

Path: betting.frustration.isOnLosingStreak

Indica se o jogador teve mais de 3 perdas na última hora.

Lógica: betting.last1h.lossCount > 3

Atualização: RT, janela de 1 hora.

Uso: Acionar intervenção imediata de jogo responsável ou oferta de freespin para reverter o humor.

Nível de Frustração

Path: betting.frustration.level

Classifica o grau de frustração do jogador com base em perdas recentes.

Como é calculado: Com base em betting.last1h.lossCount:

Nível	Perdas na última hora	Protocolo
none	0 a 3	Nenhuma ação
mild	3 a 8	Monitorar
moderate	8 a 15	Exibir mensagem de pausa
high	15 a 30	Modal de jogo responsável
critical	Acima de 30	Intervenção obrigatória

Atualização: RT, janela de 1 hora.

Resultado da Sessão

Path: betting.frustration.sessionResult

Avalia se o jogador está ganhando ou perdendo na sessão atual com base no GGR.

Como é calculado: Com base em betting.last24h.ggr (GGR negativo = jogador ganhando; positivo = operador ganhando):

Resultado	GGR 24h	Interpretação
winning	Abaixo de -R$ 10	Jogador está ganhando
breaking_even	Entre -R$10 e R$ 10	Neutro
losing_mild	R$10 a R$ 100	Perdendo levemente
losing_heavy	Acima de R$ 100	Perdendo pesado

Atualização: RT.

Satisfação Estimada

Path: betting.experience.satisfaction

Estimativa da satisfação do jogador com a experiência de jogo, baseada no winRate histórico.

Como é calculado: Com base em betting.winRate:

Nível	Win Rate	Estado estimado
frustrated	0% a 15%	Perdendo consistentemente
dissatisfied	15% a 30%	Abaixo do esperado
neutral	30% a 45%	Neutro
satisfied	45% a 60%	Experiência positiva
delighted	Acima de 60%	Muito satisfeito

Atualização: Diária.

Uso: Personalizar o tom das comunicações. Não ofereça “venha jogar mais!” para jogadores frustrated.

---

Outputs

Calculados pela plataforma combinando múltiplos campos com pesos definidos. São os campos mais sofisticados: não descrevem o que aconteceu, mas recomendam o que fazer.

Intenção — probabilidade de conversão

Score de Intenção (0-100)

Path: intention.score

Probabilidade de o visitante converter (depositar, se registrar, ou realizar a ação principal do negócio).

Como é calculado: Score ponderado combinando:

Fator	Peso	Lógica
Stage do visitante	Alto	ftd e mtd pontuam mais que anonymous
Recência de sessão	Alto	Sessão nas últimas 24h vale mais
Sessões por semana	Médio	Frequência indica interesse ativo
Duração das sessões	Médio	Sessões longas = engajamento real
Diversidade de páginas	Médio	Explorar muitas páginas = intenção de compra

Atualização: Diária.

Faixa	Nível	Estratégia
70-100	Alto	Converter imediatamente com oferta direta
40-69	Médio	Nutrir com conteúdo relevante
0-39	Baixo	Não pressionar; engajamento leve

O Score de Intenção é calculado uma vez por dia. Para condições em tempo real (visitante está na tela de depósito agora), combine com Páginas da Última Sessão.

Nível de Intenção

Path: intention.level

Versão simplificada do score em 3 categorias.

Valores: high (score ≥ 70) · medium (40–69) · low (< 40)

Uso: Ideal para condições diretas em regras sem precisar calibrar thresholds numéricos.

Próximo Passo

Path: intention.nextStep

Próximo passo esperado do visitante no funil.

Exemplos de valores: first_deposit · second_deposit

Uso: Exibir em painéis de CRM para orientar abordagens personalizadas por estágio.

---

Tags — rótulos dinâmicos

Tags do Usuário

Path: tags

Array de rótulos aplicados ao visitante via regras, jornadas ou manualmente.

Como é preenchido: Adicionadas e removidas pelas ações definidas nas suas jornadas e regras.

Atualização: Em tempo real, sempre que uma ação de tag é executada.

Operação	Exemplo
Tem Tag	tags contém “vip”
Não Tem Tag	tags não contém “bonus_elegivel”

Exemplos de tags comuns:

Tag	Quando aplicar
vip	Total Depositado > R$ 2.000
churn_risk	Dias Desde Último Depósito > 30
bonus_elegivel	Sem depósito nos últimos 7 dias
onboarding_completo	Stage = mtd
jogo_responsavel	alert80Triggered = verdadeiro

---

iGaming: Valor e retenção do jogador — betting

Score de Valor do Jogador (0-100)

Path: betting.playerValue.score

Avalia o valor financeiro real do jogador para a operação com base em GGR e frequência.

Inputs: GGR total (40%), quantidade de apostas (30%), apostado nas últimas 24h (30%).

Atualização: Diária.

Tier VIP

Path: betting.playerValue.tier

Classificação VIP derivada do Score de Valor do Jogador.

Tier	Score	Benefício sugerido
bronze	0-20	Acesso básico
silver	20-40	Bônus mensais
gold	40-60	Cashback e suporte prioritário
platinum	60-80	Gerente de conta + exclusivos
diamond	80-100	Tratamento máximo

Atualização: Diária.

Risco de Churn iGaming (0-100)

Path: betting.retention.churnRisk

Score de risco de abandono específico para comportamento de apostas. Quanto maior, maior o risco.

Inputs: Nível de frustração (35%), dias inativo (30%), satisfação estimada (20%), volume apostado nas últimas 5 semanas (15%).

Score	Nível	Ação
0-24	safe	Nenhuma ação
25-49	watch	Monitorar
50-74	danger	Jornada de retenção
75-100	critical	Intervenção imediata

Atualização: Diária.

Nível de Churn iGaming

Path: betting.retention.churnLevel

Classificação do risco de churn derivada de betting.retention.churnRisk.

Valores: safe · watch · danger · critical

Uso: Mais simples de usar em condições de jornada que o score numérico.

Urgência de Retenção

Path: betting.retention.urgency

Define com que urgência o time de CRM deve agir para reter o jogador.

Como é calculado: Combina betting.retention.churnLevel com betting.playerValue.tier.

Valor	Interpretação
no_action	Nenhuma ação necessária agora
monitor	Acompanhar nos próximos dias
act_soon	Agir nos próximos dias
act_now	Ação imediata necessária

Atualização: Diária.

Melhor Ação de Retenção

Path: betting.retention.bestAction

Ação de retenção recomendada com base no perfil de frustração e valor do jogador.

Como é calculado: Combina betting.frustration.level, betting.playerValue.tier e betting.retention.churnLevel.

Valor	Quando usar
bonus_offer	Jogador regular com churn moderado
freespin_offer	Jogador frustrado com frustração moderate
cashback	High roller ou whale com churn alto
personal_contact	Tier platinum ou diamond com urgência act_now
vip_upgrade	Jogador prestes a subir de tier
no_action	Nenhuma ação necessária

Atualização: Diária.

Próxima Ação

Path: betting.nextBestAction.action

Descrição textual da ação recomendada pelo engine de decisão.

Como é calculado: Derivado de betting.retention.bestAction combinado com betting.frustration.level.

Uso: Exibir em painéis de CRM para orientar agentes no contato com o jogador.

Canal Recomendado

Path: betting.nextBestAction.channel

Canal ideal para executar a ação de retenção.

Como é calculado: Combina betting.frustration.level com betting.retention.urgency.

Valor	Canal
onsite_modal	Modal exibido na plataforma enquanto o jogador está ativo
push	Notificação push no dispositivo
sms	Mensagem de texto
email	Email
whatsapp	WhatsApp

Atualização: Diária.

Quando Agir

Path: betting.nextBestAction.timing

Timing recomendado para executar a ação de retenção.

Valor	Interpretação
immediate	Agir agora, ainda na sessão
next_session	Na próxima vez que o jogador entrar
next_day	Nas próximas 24 horas
next_week	Na próxima semana

Como é calculado: Derivado de betting.retention.urgency.

Atualização: Diária.

---

Sinais customizados

Além dos sinais do sistema, você pode criar seus próprios sinais no Painel de Ontologia para capturar lógicas de negócio específicas da sua operação.

1. Acesse Estrutura de automações no menu lateral

   Navegue até o Painel de Ontologia dentro de Estrutura de automações.

2. Crie um novo Sinal

   Defina o nome, tipo de resultado (sim/não, número, texto ou lista) e a fórmula de cálculo.

3. Defina as condições

   Configure a lógica usando os campos existentes. Exemplo: deposits.total > 1000 E deposits.trend = decreasing → vip_decline_flag = verdadeiro.

4. Ative o sinal

   Após salvar, o sinal é calculado automaticamente para todos os visitantes da sua empresa.

Sinais customizados ficam no namespace signals.* do perfil. Regra fundamental: Outputs nunca podem ser usados como base de um sinal customizado. Use apenas Atributos, Agregados e outros Sinais.

---

Campos customizados

Além dos campos do sistema, você pode criar campos próprios para armazenar dados específicos do seu negócio via integração.

1. Acesse Estrutura de automações no menu lateral

   Clique em Estrutura de automações para ver a ontologia completa da sua empresa.

2. Abra o Painel de Ontologia

   Na aba Painel de Ontologia, veja todos os campos disponíveis organizados por grupo, com tipo, descrição e se pode ser usado em regras.

3. Crie campos customizados

   Clique em Novo Campo para adicionar campos específicos do seu negócio. Escolha o tipo de dado (texto, número, sim/não, lista) e o grupo.

Campos customizados precisam ser preenchidos via integração (API ou tracker com evento customizado). Eles não são calculados automaticamente.

---

Como usar campos em condições

Ao criar uma regra ou condição no Construtor de Fluxos:

1. Selecione o tipo de condição

   Escolha Atributo de Perfil para usar qualquer campo da ontologia.

2. Escolha o campo

   Os campos são organizados por grupo (Financeiro, Comportamento, Apostas, etc.). Campos iGaming só aparecem para empresas na vertical bets.

3. Defina o operador

   Campos numéricos: igual a, maior que, menor que, entre. Campos enum: é um de, não é. Campos array: contém, não contém.

4. Informe o valor

   Para campos enum e tier, as opções aparecem automaticamente. Para campos numéricos, insira o valor manualmente.

---

Exemplos práticos

Converter visitante registrado no momento certo

Condição: stage = registered E intention.score > 65 E deposits.daysSinceLastDeposit = 0 (nunca depositou)

Ação: Exibir modal com oferta de bônus no primeiro depósito personalizada com {{ game.name }}.

Intervenção de jogo responsável em tempo real

Condição: balanceRealtime.alert80Triggered = verdadeiro OU betting.frustration.level = critical

Ação: Exibir modal obrigatório de pausa. Canal: onsite_modal. Timing: immediate.

Reativar high roller antes do churn

Condição: deposits.tier = high E deposits.daysSinceLastDeposit > 14 E deposits.trend = decreasing

Ação: Acionar betting.retention.bestAction. Se = cashback, enviar oferta via betting.nextBestAction.channel.

Oferta de freespin para jogador frustrado

Condição: betting.frustration.level = moderate E betting.playerValue.tier = gold

Ação: Exibir modal com oferta de freespins no {{ favoriteGame.name }}. Canal: onsite_modal.

Upsell para tier diamond

Condição: betting.playerValue.tier = platinum E betting.retention.urgency = no_action E deposits.trend = increasing

Ação: Exibir convite para programa Diamond com benefícios exclusivos.

Personalização de mensagem pelo horário ideal

Condição: Hora atual = bestTime.bestHour E deposits.daysSinceLastDeposit > 7

Ação: Enviar SMS: “Olá, {{ contact.firstName }}! Você costuma jogar por volta desta hora. Temos uma oferta esperando por você.”

---

Onde a ontologia aparece na plataforma

Regras e Condições

Todos os campos selecionáveis aparecem no Construtor de Fluxos e na página de Regras, organizados por grupo.

Personalização de Templates

Campos com variável Liquid (ex: {{ contact.firstName }}, {{ game.name }}, {{ favoriteGame.url }}) podem ser usados em modais, smart blocks, SMS e emails.

Audiência

Qualquer campo pode ser critério de segmentação. Visitantes são classificados em tempo real conforme os critérios definidos.

Painel de Ontologia

Em Estrutura de automações, visualize todos os campos por grupo, tipo e origem. Crie sinais e campos customizados.

Próximos passos

Personalização com Variáveis

Use os campos do perfil para personalizar mensagens em modais, emails e SMS com variáveis Liquid.

Jornadas

Crie automações visuais usando os campos e sinais como condições no Construtor de Fluxos.