Skip to main content
Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la documentación para desarrolladores.

Módulo Analytics

Rastrea eventos personalizados y actividad de usuario mediante base44.analytics.

Contenido

Métodos

MétodoFirmaDescripción
track(params)voidRastrea un evento personalizado

Ejemplos

Rastrear evento personalizado

// Rastrear un evento simple
base44.analytics.track({
  eventName: "button_clicked"
});

// Rastrear evento con propiedades
base44.analytics.track({
  eventName: "purchase_completed",
  properties: {
    product_id: "prod-123",
    amount: 99.99,
    currency: "USD"
  }
});

Rastrear acciones del usuario

// Rastrear vista de página
base44.analytics.track({
  eventName: "page_view",
  properties: {
    page: "/dashboard",
    referrer: document.referrer
  }
});

// Rastrear uso de función
base44.analytics.track({
  eventName: "feature_used",
  properties: {
    feature: "export_data",
    format: "csv"
  }
});

Rastreo automático

El módulo analytics rastrea automáticamente:
  • Eventos de inicialización: Cuando la app se carga
  • Eventos de latido: Señales de actividad periódicas
  • Duración de sesión: Tiempo pasado en la app
Estos eventos internos ayudan a medir la participación del usuario sin instrumentación manual.

Mejores prácticas

  1. Usa nombres de eventos descriptivos: order_completed en lugar de click
  2. Incluye propiedades relevantes: Añade contexto que ayude a analizar el evento
  3. Sé consistente: Usa los mismos nombres de eventos y claves de propiedad en toda tu app
  4. No rastrees datos sensibles: Evita PII en las propiedades de eventos
// Bueno: Descriptivo con propiedades relevantes
base44.analytics.track({
  eventName: "subscription_started",
  properties: {
    plan: "pro",
    billing_cycle: "annual"
  }
});

// Evitar: Nombre de evento vago, sin contexto
base44.analytics.track({
  eventName: "click"
});

Definiciones de tipos

/** Propiedades que pueden adjuntarse a un evento rastreado. */
type TrackEventProperties = {
  [key: string]: string | number | boolean | null | undefined;
};

/** Parámetros para el método track(). */
interface TrackEventParams {
  /** El nombre del evento a rastrear. */
  eventName: string;
  /** Propiedades opcionales a adjuntar al evento. */
  properties?: TrackEventProperties;
}

/** La interfaz del módulo analytics. */
interface AnalyticsModule {
  /** Rastrea un evento personalizado con propiedades opcionales. */
  track(params: TrackEventParams): void;
}
Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.