Comment contrôler les sessions que vous enregistrez

Démarrer et arrêter les enregistrements par programmation

Remarque : Pour les contrôles de rediffusion mobile, consultez la section relative aux contrôles de confidentialité pour iOS et Android. La prise en charge de cette méthode dans React Native et Flutter est prévue ; suivez l'évolution ici.

1. Pour les projets plus anciens, il existe une section pour « Domaines autorisés pour la relecture » dans leparamètres de relecture du projetAssurez-vous que votre domaine est ajouté si la section est présente.

2. Ensembledisable_session_recording: truedans votreconfiguration.

Web

posthog.init('phc_HVcGJdGDtkcvV1qUuz5bDrMf987gskGUpFH1nV6ufov', {
  api_host: 'https://us.i.posthog.com',
  defaults: '2025-05-24',
    disable_session_recording: true,
    // ... other options
})

1. Démarrer l'enregistrement manuellement en appelantposthog.startSessionRecording(). De même, vous pouvez arrêter l'enregistrement à tout moment en appelantposthog.stopSessionRecording().

Par défaut,startSessionRecordingobéit à tous les contrôles d'ingestion que vous avez définis - vous pouvez donc appeler start et ne pas enregistrer une session en raison de l'échantillonnage ou d'un autre contrôle.

Vous pouvez transmettre des options de remplacement àstartSessionRecordingpour changer cela.

posthog.startSessionRecording(true) // start ignoring all ingestion controls
posthog.startSessionRecording({
  // you don't have to send all of these
  sampling: true || false;
  linked_flag: true || false;
  url_trigger: true || false;
  event_trigger: true || false
})

Avec des conditions de déclenchement d'URL

Vous pouvez choisir de ne lancer l'enregistrement qu'une fois que l'utilisateur a visité une page spécifique. Une fois l'URL correspondante, l'enregistrement se poursuit même après avoir quitté la page correspondante.

Le client conserve une courte mémoire tampon en mémoire, vous pourrez donc toujours voir comment il est arrivé à la page.

Avec des conditions de déclenchement d'événement

Depuis la version 1.186.0 de posthog-js, vous pouvez choisir de ne démarrer l'enregistrement qu'après que l'utilisateur a émis un événement particulier. Une fois l'événement capturé, l'enregistrement se poursuit même après avoir quitté la page correspondante.

Le client conserve une courte mémoire tampon en mémoire, vous pourrez donc toujours voir comment il est arrivé à l'événement.

Avec des indicateurs de fonctionnalité

Vous pouvez sélectionner unindicateur de fonctionnalitépour contrôler l'enregistrement des sessions. Les enregistrements ne seront collectés que pour les utilisateurs dont l'option est activée.

1. Créer un indicateur booléen ou à variantes multiplesqui détermine s'il faut enregistrer les sessions ou non.

2. Aller à lapage des paramètres d'ingestion de rediffusion.

3. Liez votre drapeau nouvellement créé dans leActiver les enregistrements à l'aide de l'indicateur de fonctionnalité.

Échantillonnage

L'échantillonnage vous permet d'enregistrer un pourcentage de toutes les sessions. Pour définir un taux d'échantillonnage, accédez à la sectionpage des paramètres d'ingestion de rediffusion.

Nous vous recommandons de commencer par capturer 100 % des sessions et de réduire ce nombre si nécessaire. Cela vous permet d'avoir une idée du nombre de sessions enregistrées et de la quantité de données collectées.

Remarque : l’échantillonnage réduit le nombre de sessions que vous enregistrez, mais il ne vous permet pas de contrôler quelles sessions sont enregistrées.

Combinaison des contrôles

Depuis la version 1.238.0 du SDK Web, vous pouvez contrôler la combinaison de plusieurs déclencheurs. Vous pouvez choisir si l'enregistrement démarre lorsque tous les déclencheurs correspondent ou lorsqu'un seul déclencheur correspond.

Par exemple, si vous définissez un déclencheur d'événement pour les événements d'exception, un déclencheur d'URL pour la page de paiement et un échantillonnage à 20 %.

Avec n'importe quelle correspondance

Vous capturerez 20 % de chaque session, ainsi que toute session comportant un événement exceptionnel ou se trouvant sur la page de paiement.

Avec toutes les correspondances

Vous capturerez 20 % de toute session sur la page de paiement qui comporte un événement d'exception.

Durée minimale

Dans votreparamètres d'ingestion de rediffusion, vous pouvez définir une durée minimale pour les sessions à enregistrer.

Ceci est utile si vous souhaitez exclure les sessions trop courtes pour être utiles. Par exemple, vous pouvez exclure les sessions de moins de 2 secondes pour éviter d'enregistrer des sessions où les utilisateurs quittent rapidement votre site.

Limites

La durée minimale est définie en secondes. À chaque démarrage d'une nouvelle session, le navigateur enregistre l'heure de début. Si la durée minimale est écoulée depuis le début, les données de session sont envoyées. Dans le cas contraire, la session reste en mémoire tampon.

Cela signifie que si vous définissez une durée minimale élevée et que votre utilisateur visite plusieurs pages pendant une courte durée, le navigateur risque de perdre les données mises en mémoire tampon. La session est alors enregistrée, mais vous manquez le début.

Si vous constatez que le début des séances vous manque, réduisez la durée minimale pour résoudre ce problème.

Limites de facturation

Vous pouvez définir unlimite de facturationNous arrêterons d'ingérer des enregistrements lorsque vous atteindrez votre limite.