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

# Analytics-Modul

> Verfolge benutzerdefinierte Ereignisse und Nutzeraktivität über base44.analytics.

<Warning>
  Diese Seite ist Teil eines KI-Coding-Agent-Skills und für Agenten geschrieben, nicht für Menschen. Für die menschenlesbare Base44-Dokumentation siehe die [Entwicklerdokumentation](/developers).
</Warning>

# Analytics-Modul

Verfolge benutzerdefinierte Ereignisse und Nutzeraktivität über `base44.analytics`.

## Inhalt

* [Methoden](#methoden)
* [Beispiele](#beispiele)
* [Automatisches Tracking](#automatisches-tracking)
* [Best Practices](#best-practices)

## Methoden

| Methode         | Signatur | Beschreibung                               |
| --------------- | -------- | ------------------------------------------ |
| `track(params)` | `void`   | Ein benutzerdefiniertes Ereignis verfolgen |

## Beispiele

### Benutzerdefiniertes Ereignis verfolgen

```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"
  }
});
```

### Nutzeraktionen verfolgen

```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"
  }
});
```

## Automatisches Tracking

Das Analytics-Modul verfolgt automatisch:

* **Initialisierungs-Ereignisse**: Wenn die App lädt
* **Heartbeat-Ereignisse**: Periodische Aktivitätssignale
* **Sitzungsdauer**: Zeit in der App

Diese internen Ereignisse messen das Nutzer-Engagement ohne manuelle Instrumentierung.

## Best Practices

1. **Verwende beschreibende Ereignisnamen**: `order_completed` statt `click`
2. **Füge relevante Properties hinzu**: Kontext, der bei der Analyse hilft
3. **Sei konsistent**: Verwende dieselben Ereignisnamen und Property-Schlüssel in deiner App
4. **Verfolge keine sensiblen Daten**: Vermeide PII in Ereignis-Properties

```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"
});
```

## Type Definitions

```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>Diese Seite wurde mit KI übersetzt. Für die genauesten und aktuellsten Informationen siehe die [englische Version](/). </Note>