Skip to main content
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.

​
Module Analytics

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

​
Sommaire

​
Méthodes

MéthodeSignatureDescription
track(params)voidSuivre un événement personnalisé

​
Exemples

​
Suivre un événement personnalisé

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

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

/** 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;
}
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.