Ontologia de Dados - UserIn Docs

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.bestHourHora 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.dayOfWeekDia 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.dayNameNome 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.proposedContactLocalCombinaçã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.daysSinceLastDepositContador 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.tierClassifica 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.trendIndica 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.trendComparação específica das últimas 5 semanas com as 5 semanas anteriores.Valores: up · down · stable · noneComo é 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.sessionsPerWeekMé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.avgSessionDurationMinutesTempo 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: daysInactiveDias 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: daysSinceCreationQuantidade 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.nameNome 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.urlURL 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.categoryCategoria 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.sessionNetChangeDiferença em reais entre o saldo atual e o saldo de início da sessão.Fórmula: balanceRealtime.current − balanceRealtime.sessionStartPositivo = ganhou. Negativo = perdeu.Atualização: RT, durante a sessão ativa.

Ganhou/Perdeu na Sessão (%)

Path: balanceRealtime.sessionNetChangePercentVariação percentual do saldo na sessão atual.Fórmula: (balanceRealtime.current − balanceRealtime.sessionStart) ÷ balanceRealtime.sessionStart × 100Ex: -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.isLosingStreakIndica 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.hitZeroThisSessionIndica 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.alert50TriggeredIndica 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.alert80TriggeredIndica 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.volatilityNível de volatilidade do jogo favorito do visitante.Valores: low · medium · highComo é 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.tierClassifica 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.winRatePercentual de rodadas ganhas sobre o total de apostas.Fórmula: betting.winCount ÷ betting.betCount × 100Atualizaçã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.isOnLosingStreakIndica se o jogador teve mais de 3 perdas na última hora.Lógica: betting.last1h.lossCount > 3Atualizaçã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.levelClassifica 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.sessionResultAvalia 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.satisfactionEstimativa 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.scoreProbabilidade 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.levelVersã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.nextStepPróximo passo esperado do visitante no funil.Exemplos de valores: first_deposit · second_depositUso: Exibir em painéis de CRM para orientar abordagens personalizadas por estágio.

Tags — rótulos dinâmicos

Tags do Usuário

Path: tagsArray 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.scoreAvalia 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.tierClassificaçã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.churnRiskScore 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.churnLevelClassificação do risco de churn derivada de betting.retention.churnRisk.Valores: safe · watch · danger · criticalUso: Mais simples de usar em condições de jornada que o score numérico.

Urgência de Retenção

Path: betting.retention.urgencyDefine 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.bestActionAçã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.actionDescriçã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.channelCanal 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.timingTiming 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.

Acesse Estrutura de automações no menu lateral

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

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.

Defina as condições

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

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.

Acesse Estrutura de automações no menu lateral

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

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.

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:

Selecione o tipo de condição

Escolha Atributo de Perfil para usar qualquer campo da ontologia.

Escolha o campo

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

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.

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 = criticalAçã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 = decreasingAçã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 = goldAçã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 = increasingAçã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 > 7Açã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.

​Os 4 tipos de dados

Atributos

Agregados

Sinais

Outputs

​Atributos

​Identidade

​Temporal

​Financeiro

​Comportamento

​Navegação

​Contato

​iGaming: Jogo favorito (objeto Game)

​iGaming: Saldo de entrada na sessão

​Agregados

​Ciclo de vida

​Temporal

​Financeiro

​Comportamento

​Preferências e jogos

​Navegação

​iGaming: Saldo em tempo real

​iGaming: Apostas — betting

​Sinais

​Temporal — melhor horário de contato

​Financeiro

​Comportamento

​Preferências — jogo favorito

​iGaming: Saldo em tempo real

​iGaming: Jogo favorito

​iGaming: Apostas — comportamento e frustração

​Outputs

​Intenção — probabilidade de conversão

​Tags — rótulos dinâmicos

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

​Sinais customizados

​Campos customizados

​Como usar campos em condições

​Exemplos práticos

​Onde a ontologia aparece na plataforma

Regras e Condições

Personalização de Templates

Audiência

Painel de Ontologia

​Próximos passos

Personalização com Variáveis

Jornadas

Os 4 tipos de dados

Atributos

Identidade

Temporal

Financeiro

Comportamento

Navegação

Contato

iGaming: Jogo favorito (objeto Game)

iGaming: Saldo de entrada na sessão

Agregados

Ciclo de vida

Temporal

Financeiro

Comportamento

Preferências e jogos

Navegação

iGaming: Saldo em tempo real

iGaming: Apostas — `betting`

Sinais

Temporal — melhor horário de contato

Financeiro

Comportamento

Preferências — jogo favorito

iGaming: Saldo em tempo real

iGaming: Jogo favorito

iGaming: Apostas — comportamento e frustração

Outputs

Intenção — probabilidade de conversão

Tags — rótulos dinâmicos

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

Sinais customizados

Campos customizados

Como usar campos em condições

Exemplos práticos

Onde a ontologia aparece na plataforma

Próximos passos