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

> Enregistrez l'activité utilisateur dans votre application via base44.appLogs.

<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 App Logs

Enregistrez l'activité utilisateur dans votre application via `base44.appLogs`.

## Sommaire

* [Méthodes](#methods)
* [Exemples](#examples)
* [Cas d'usage](#use-cases)

## Méthodes

| Méthode                  | Signature       | Description                                                                    |
| ------------------------ | --------------- | ------------------------------------------------------------------------------ |
| `logUserInApp(pageName)` | `Promise<void>` | Enregistrer l'activité utilisateur sur une page                                |
| `fetchLogs(params?)`     | `Promise<any>`  | Récupérer les journaux d'application avec des paramètres de filtre facultatifs |
| `getStats(params?)`      | `Promise<any>`  | Obtenir les statistiques d'utilisation de l'application                        |

## Exemples

### Enregistrer l'activité utilisateur

```javascript theme={null}
// Log when user visits a page
await base44.appLogs.logUserInApp("dashboard");

// Log specific page visits
await base44.appLogs.logUserInApp("settings");
await base44.appLogs.logUserInApp("profile");

// Log feature usage
await base44.appLogs.logUserInApp("export-button-click");
```

Le nom de page n'a pas besoin d'être une page réelle — cela peut être n'importe quelle chaîne à suivre.

## Cas d'usage

### Suivre les vues de pages dans React

```javascript theme={null}
// Log page views on route change
useEffect(() => {
  base44.appLogs.logUserInApp(window.location.pathname);
}, [location.pathname]);
```

### Suivre l'utilisation des fonctionnalités

```javascript theme={null}
// Log when user uses specific features
function handleExport() {
  base44.appLogs.logUserInApp("export-data");
  // ... export logic
}

function handleSettingsChange() {
  base44.appLogs.logUserInApp("settings-updated");
  // ... save settings
}
```

### Récupérer les journaux

```javascript theme={null}
// Fetch all logs
const logs = await base44.appLogs.fetchLogs();

// Fetch logs with filters
const recentLogs = await base44.appLogs.fetchLogs({
  limit: 50,
  page: "/dashboard"
});
```

### Obtenir les statistiques

```javascript theme={null}
// Get usage statistics for the app
const stats = await base44.appLogs.getStats();

// Get stats with date range params
const weekStats = await base44.appLogs.getStats({
  from: "2024-01-01",
  to: "2024-01-07"
});
```

## Remarques

* Les journaux apparaissent dans la page Analytics du tableau de bord de votre application
* Les journaux d'application suivent l'activité au niveau page et fonctionnalité
* Utilisez `analytics.track()` pour des événements personnalisés avec propriétés, `appLogs.logUserInApp()` pour un suivi simple page/fonctionnalité

## Définitions de types

```typescript theme={null}
/** App Logs module for tracking and analyzing app usage. */
interface AppLogsModule {
  /**
   * Log user activity in the app.
   * @param pageName - Name of the page or section being visited.
   * @returns Promise that resolves when the log is recorded.
   */
  logUserInApp(pageName: string): Promise<void>;

  /**
   * Fetch app logs with optional filter parameters.
   * @param params - Optional filter parameters (e.g., limit, page name, date range).
   * @returns Promise resolving to the logs data.
   */
  fetchLogs(params?: Record<string, any>): Promise<any>;

  /**
   * Get app usage statistics.
   * @param params - Optional filter parameters (e.g., date range).
   * @returns Promise resolving to the statistics data.
   */
  getStats(params?: Record<string, any>): Promise<any>;
}
```

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