Skip to main content
Questa pagina fa parte di una skill per agenti di codifica IA ed è scritta per gli agenti, non per gli esseri umani. Per la documentazione Base44 leggibile dagli umani, consulta la documentazione per sviluppatori.

​
Modulo Analytics

Traccia eventi personalizzati e attività utente tramite base44.analytics.

​
Contenuti

​
Metodi

MetodoFirmaDescrizione
track(params)voidTraccia un evento personalizzato

​
Esempi

​
Tracciare un evento personalizzato

// Track a simple event
base44.analytics.track({
  eventName: "button_clicked"
});

// Track event with properties
base44.analytics.track({
  eventName: "purchase_completed",
  properties: {
    product_id: "prod-123",
    amount: 99.99,
    currency: "USD"
  }
});

​
Tracciare azioni utente

// Track page view
base44.analytics.track({
  eventName: "page_view",
  properties: {
    page: "/dashboard",
    referrer: document.referrer
  }
});

// Track feature usage
base44.analytics.track({
  eventName: "feature_used",
  properties: {
    feature: "export_data",
    format: "csv"
  }
});

​
Tracciamento automatico

Il modulo analytics traccia automaticamente:
  • Eventi di inizializzazione: quando l’app viene caricata
  • Eventi di heartbeat: segnali periodici di attività
  • Durata della sessione: tempo trascorso nell’app
Questi eventi interni aiutano a misurare l’engagement dell’utente senza strumentazione manuale.

​
Best practice

  1. Usa nomi di evento descrittivi: order_completed invece di click
  2. Includi proprietà rilevanti: aggiungi contesto che aiuta ad analizzare l’evento
  3. Sii coerente: usa gli stessi nomi di evento e chiavi di proprietà in tutta l’app
  4. Non tracciare dati sensibili: evita informazioni personali nelle proprietà dell’evento
// Good: Descriptive with relevant properties
base44.analytics.track({
  eventName: "subscription_started",
  properties: {
    plan: "pro",
    billing_cycle: "annual"
  }
});

// Avoid: Vague event name, no context
base44.analytics.track({
  eventName: "click"
});

​
Definizioni di tipo

/** Properties that can be attached to a tracked event. */
type TrackEventProperties = {
  [key: string]: string | number | boolean | null | undefined;
};

/** Parameters for the track() method. */
interface TrackEventParams {
  /** The name of the event to track. */
  eventName: string;
  /** Optional properties to attach to the event. */
  properties?: TrackEventProperties;
}

/** The analytics module interface. */
interface AnalyticsModule {
  /** Track a custom event with optional properties. */
  track(params: TrackEventParams): void;
}
Questa pagina è stata tradotta utilizzando l’IA. Per informazioni più accurate e aggiornate, consulta la versione inglese.