Événements personnalisés

Suivez les interactions des utilisateurs au-delà des pages vues.

Utilisation de base

Utilisez l’objet global analytics pour suivre les événements :

// Track a simple event
window.analytics.track('signup_click');

// Track an event with properties
window.analytics.track('purchase', {
  plan: 'pro',
  value: 29
});

Exemples courants

Clics sur les boutons

<button onclick="window.analytics.track('cta_click', { button: 'hero' })">
  Get Started
</button>

Envois de formulaires

<form onsubmit="window.analytics.track('form_submit', { form: 'contact' })">
  <!-- form fields -->
  <button type="submit">Send</button>
</form>

Inscription à la newsletter

function handleSubscribe() {
  // Your subscription logic...

  window.analytics.track('newsletter_signup', {
    source: 'footer'
  });
}

Engagement vidéo

video.addEventListener('play', () => {
  window.analytics.track('video_play', { video: 'demo' });
});

video.addEventListener('ended', () => {
  window.analytics.track('video_complete', { video: 'demo' });
});

E-commerce

// Add to cart
window.analytics.track('add_to_cart', {
  product: 'T-Shirt',
  price: 25,
  currency: 'USD'
});

// Purchase complete
window.analytics.track('purchase', {
  value: 75,
  items: 3
});

React / Next.js

// Declare the global type
declare global {
  interface Window {
    analytics: {
      track: (event: string, props?: Record<string, any>) => void;
    };
  }
}

// Use in components
export function SignupButton() {
  const handleClick = () => {
    window.analytics.track('signup_click', { location: 'header' });
    // Continue with signup...
  };

  return (
    <button onClick={handleClick}>
      Sign Up
    </button>
  );
}

Propriétés d’événement

Les propriétés vous aident à segmenter et à analyser les événements. Gardez-les simples :

  • Utilisez des noms en minuscules avec des tirets bas : button_click
  • Gardez les valeurs de propriété courtes et catégorielles
  • N’incluez pas de données personnelles (e-mails, noms, etc.)
  • Limitez-vous à 5 à 10 propriétés par événement

Note sur la confidentialité

N’incluez jamais d’informations personnelles identifiables (PII) dans les noms ou propriétés d’événement. Cela inclut les e-mails, les noms, les numéros de téléphone ou toute donnée pouvant identifier une personne précise.

Utiliser les événements avec des objectifs

Les événements personnalisés peuvent être utilisés comme objectifs de conversion. Par exemple, si vous suivez un événement purchase, vous pouvez créer un objectif qui se déclenche lorsque cet événement se produit.

Accédez à Paramètres → Objectifs → Ajouter un objectif → Sélectionnez « Événement personnalisé » et saisissez le nom de l’événement. En savoir plus dans notre documentation sur les objectifs.

Ressources associées