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

> Rastreia eventos personalizados e atividade do usuário via base44.analytics.

<Warning>
  Esta página faz parte de uma habilidade de agente de código IA e é escrita para agentes, não para humanos. Para a documentação legível por humanos da Base44, veja a [documentação para desenvolvedores](/developers).
</Warning>

# Módulo Analytics

Rastreia eventos personalizados e atividade do usuário via `base44.analytics`.

## Conteúdo

* [Métodos](#methods)
* [Exemplos](#examples)
* [Rastreamento automático](#automatic-tracking)
* [Melhores práticas](#best-practices)

## Métodos

| Método          | Assinatura | Descrição                        |
| --------------- | ---------- | -------------------------------- |
| `track(params)` | `void`     | Rastreia um evento personalizado |

## Exemplos

### Rastrear evento personalizado

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

### Rastrear ações do usuário

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

## Rastreamento automático

O módulo analytics rastreia automaticamente:

* **Eventos de inicialização**: Quando o aplicativo carrega
* **Eventos de heartbeat**: Sinais periódicos de atividade
* **Duração da sessão**: Tempo gasto no aplicativo

Esses eventos internos ajudam a medir o engajamento do usuário sem instrumentação manual.

## Melhores práticas

1. **Use nomes de eventos descritivos**: `order_completed` em vez de `click`
2. **Inclua propriedades relevantes**: Adicione contexto que ajude a analisar o evento
3. **Seja consistente**: Use os mesmos nomes de evento e chaves de propriedade em todo o seu aplicativo
4. **Não rastreie dados sensíveis**: Evite PII em propriedades de evento

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

## Definições de tipo

```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>Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a [versão em inglês](/). </Note>