Vai alla documentazione

Concetti fondamentali

Capire come Kixo organizza i dati ti aiuta a usare al meglio la piattaforma. Ecco gli elementi principali.

Team

Un Team è il contenitore principale in Kixo. Rappresenta la tua organizzazione e contiene tutti i progetti, i membri e le impostazioni di fatturazione. Ogni team può avere più membri con ruoli diversi: Owner, Admin, Member o Viewer, oltre a Guest Viewer e Guest Editor per i collaboratori esterni con accesso limitato a progetti specifici.

Progetti

Un Progetto corrisponde a un singolo prodotto o applicazione. Ogni progetto ha il proprio Project ID, le proprie chiavi API, le dashboard e le impostazioni delle campagne. Puoi creare più progetti nello stesso team, ad esempio uno per l'app web e un altro per l'app mobile.

App

App sono i domini web, i bundle identifier iOS e i nomi dei pacchetti Android che inviano traffico SDK a un progetto. Durante la configurazione, Kixo può rilevare automaticamente la prima app per una piattaforma. Gli identificativi aggiunti in seguito, invece, dovrebbero essere approvati dal tuo team prima di accettarne il traffico, così snippet SDK esposti o domini imprevisti non inquinano i dati.

Eventi

Un Evento è una singola azione dell'utente o un singolo evento di sistema. Kixo traccia automaticamente molti eventi già da subito, tra cui visualizzazioni di pagina, tocchi, sessioni, profondità di scorrimento, errori e altro. Puoi anche inviare eventi personalizzati usando Kixo.track().

Ogni evento include:

  • event_type — la categoria (ad esempio screen_view, tap, custom)
  • event_name — un'etichetta leggibile da chiunque (ad esempio HomeScreen, Purchase)
  • device_id — un identificatore univoco del dispositivo
  • session_id — raggruppa gli eventi in sessioni
  • timestamp — il momento in cui si è verificato l'evento
  • proprietà — coppie chiave-valore arbitrarie per aggiungere contesto

Sessioni

Una Sessione rappresenta un singolo periodo di attività dell'utente. Kixo avvia una nuova sessione quando l'utente torna dopo un periodo di inattività. Il timeout varia in base alla piattaforma: SDK Web chiude una sessione dopo 30 minuti di inattività, mentre gli SDK iOS e Android ne avviano una nuova quando l'app torna in primo piano dopo 30 secondi in background (configurabile tramite sessionTimeout / sessionTimeoutMillis). Le sessioni servono per calcolare metriche come la durata della sessione, le pagine per sessione e la frequenza di rimbalzo.