Ir para a documentação

Conceitos fundamentais

Perceber como o Kixo organiza os dados ajuda a tirar mais partido da plataforma. Estes são os principais elementos.

Equipas

Uma Equipa é o contentor de topo no Kixo. Representa a sua organização e reúne todos os projetos, membros e definições de faturação. Cada equipa pode ter vários membros com funções diferentes: Owner, Admin, Member ou Viewer, além de Guest Viewer e Guest Editor para colaboradores externos com acesso limitado a projetos específicos.

Projetos

Um Projeto corresponde a um único produto ou aplicação. Cada projeto tem o seu próprio Project ID, chaves de API, dashboards e definições de campanha. Pode criar vários projetos na mesma equipa — por exemplo, um para a app Web e outro para a app mobile.

Apps

Apps são os domínios Web, os identificadores de bundle de iOS e os nomes de pacote de Android que enviam tráfego do SDK para um projeto. O Kixo pode detetar a primeira app de uma plataforma durante a configuração. Os identificadores de app adicionados mais tarde devem ser revistos pela sua equipa antes de o respetivo tráfego ser aceite, para que trechos do SDK expostos ou domínios inesperados não contaminem os seus dados.

Eventos

Um Evento é uma ação individual do utilizador ou uma ocorrência do sistema. O Kixo regista automaticamente muitos eventos de origem, como visualizações de página, toques, sessões, profundidade de scroll e erros. Também pode enviar eventos personalizados com Kixo.track().

Todos os eventos incluem:

  • event_type — a categoria (por exemplo, screen_view, tap, custom)
  • event_name — uma etiqueta legível por pessoas (por exemplo, HomeScreen, Purchase)
  • device_id — um identificador único do dispositivo
  • session_id — agrupa eventos em sessões
  • timestamp — quando o evento ocorreu
  • propriedades — pares chave-valor arbitrários para contexto adicional

Sessões

Uma Sessão representa um período contínuo de atividade do utilizador. O Kixo inicia uma nova sessão quando o utilizador regressa após um período de inatividade. O limite depende da plataforma: o Web SDK termina uma sessão após 30 minutos sem atividade, enquanto os SDK de iOS e Android iniciam uma nova sessão quando a app volta ao primeiro plano depois de 30 segundos em segundo plano (configurável através de sessionTimeout / sessionTimeoutMillis). As sessões são usadas para calcular métricas como a duração da sessão, páginas por sessão e taxa de rejeição.