> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Módulo Analytics

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

<Warning>
  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](/developers).
</Warning>

# Módulo Analytics

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

## Contenido

* [Métodos](#methods)
* [Ejemplos](#examples)
* [Rastreo automático](#automatic-tracking)
* [Mejores prácticas](#best-practices)

## Métodos

| Método          | Firma  | Descripción                     |
| --------------- | ------ | ------------------------------- |
| `track(params)` | `void` | Rastrea un evento personalizado |

## Ejemplos

### Rastrear evento personalizado

```javascript theme={null}
// 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

```javascript theme={null}
// 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

```javascript theme={null}
// 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

```typescript theme={null}
/** 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;
}
```

<Note>Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).</Note>