> ## 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.

# Module Analytics

> Suivez des événements personnalisés et l'activité utilisateur via base44.analytics.

<Warning>
  Cette page fait partie d'une compétence d'agent de code IA et est écrite pour les agents, pas pour les humains. Pour la documentation Base44 lisible par un humain, consultez la [documentation développeur](/developers).
</Warning>

# Module Analytics

Suivez des événements personnalisés et l'activité utilisateur via `base44.analytics`.

## Sommaire

* [Méthodes](#methods)
* [Exemples](#examples)
* [Suivi automatique](#automatic-tracking)
* [Bonnes pratiques](#best-practices)

## Méthodes

| Méthode         | Signature | Description                      |
| --------------- | --------- | -------------------------------- |
| `track(params)` | `void`    | Suivre un événement personnalisé |

## Exemples

### Suivre un événement personnalisé

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

### Suivre les actions utilisateur

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

## Suivi automatique

Le module analytics suit automatiquement :

* **Événements d'initialisation** : quand l'application se charge
* **Événements heartbeat** : signaux d'activité périodiques
* **Durée de session** : temps passé dans l'application

Ces événements internes aident à mesurer l'engagement utilisateur sans instrumentation manuelle.

## Bonnes pratiques

1. **Utilisez des noms d'événements descriptifs** : `order_completed` plutôt que `click`
2. **Incluez des propriétés pertinentes** : ajoutez du contexte pour aider à analyser l'événement
3. **Soyez cohérent** : utilisez les mêmes noms d'événements et clés de propriétés dans toute l'application
4. **Ne suivez pas de données sensibles** : évitez les PII dans les propriétés d'événement

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

## Définitions de types

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

<Note>Cette page a été traduite à l'aide de l'IA. Pour les informations les plus précises et à jour, consultez la [version anglaise](/). </Note>