Comment contrôler les sessions que vous enregistrez

4 minutes de lecture
💡
Vous trouverez l'article original ici : https://posthog.com/docs/session-replay/how-to-control-which-sessions-you-record

Démarrer et arrêter les enregistrements par programmation

Remarque : Pour les commandes de relecture sur mobile, consultez la section relative aux paramètres de confidentialité iOS et Android. La prise en charge de cette méthode dans React Native et Flutter est prévue ; suivez l’avancement ici.

  1. Pour les projets plus anciens, une section « Domaines autorisés pour la rediffusion » est disponible dans les paramètres de rediffusion . Assurez-vous que votre domaine y est ajouté si cette section est présente.
  1. Définissez disable_session_recording: true dans votre configuration .

Web

posthog.init('phc_HVcGJdGDtkcvV1qUuz5bDrMf987gskGUpFH1nV6ufov', {
  api_host: 'https://us.i.posthog.com',
  defaults: '2025-05-24',
    disable_session_recording: true,
    // ... other options
})
  1. Démarrez manuellement l'enregistrement en appelant posthog.startSessionRecording(). De même, vous pouvez arrêter l'enregistrement à tout moment en appelant posthog.stopSessionRecording().

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

Vous pouvez transmettre des options de remplacement à startSessionRecording pour modifier cela.

Avec des conditions de déclenchement d'URL

Vous pouvez choisir de ne démarrer l'enregistrement que lorsqu'un utilisateur visite une page spécifique. Une fois l'URL validée, l'enregistrement se poursuit même après que l'utilisateur a quitté la page correspondante.

Le client conserve une petite quantité de données en mémoire, vous pourrez donc toujours voir comment ils sont arrivés à la page.

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'événement

Depuis la version 1.186.0 de posthog-js, vous pouvez choisir de ne démarrer les enregistrements que lorsqu'un événement spécifique est déclenché par l'utilisateur. Une fois l'événement capturé, l'enregistrement se poursuit même si l'utilisateur quitte la page correspondante.

Le client conserve une petite quantité de données en mémoire, vous pourrez donc toujours voir comment ils sont arrivés à l'événement.

Avec des indicateurs de fonctionnalités

Vous pouvez activer ou désactiver l' enregistrement des sessions. Seuls les utilisateurs pour lesquels cette option est activée seront enregistrés.

  1. Créez un indicateur booléen ou à valeurs multiples qui détermine s'il faut enregistrer les sessions ou non.
  1. Accédez à la page des paramètres d'ingestion des replays .
  1. Liez votre indicateur nouvellement créé dans l' indicateur de fonctionnalité « Activer les enregistrements » .

Échantillonnage

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

Nous vous recommandons de commencer par enregistrer 100 % des sessions et de réduire ce pourcentage au besoin. Cela vous permettra d'évaluer le nombre de sessions enregistrées et la quantité de données collectées.

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

Commandes combinées

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 sont activés ou dès qu'au moins un déclencheur est activé.

Par exemple, si vous configurez 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 quel assortiment

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

Avec tous les assortis

Vous capturerez 20 % de toute session sur la page de paiement présentant un événement exceptionnel.

Durée minimale

Dans vos paramètres d'ingestion de relecture , vous pouvez définir une durée minimale pour l'enregistrement des sessions.

Cela s'avère utile si vous souhaitez exclure les sessions trop courtes pour être exploitables. Par exemple, vous pouvez exclure les sessions de moins de 2 secondes afin d'éviter d'enregistrer celles où les utilisateurs quittent rapidement votre site.

Limites

La durée minimale est définie en secondes. À chaque ouverture de session, le navigateur enregistre l'heure de début. Si la durée minimale est écoulée depuis cette heure, 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 consulte plusieurs pages brièvement chacune, le navigateur risque de perdre les données mises en mémoire tampon. Par conséquent, la session est bien enregistrée, mais vous manquez le début.

Si vous constatez que le début des sessions est manquant, réduisez la durée minimale pour résoudre ce problème.

Limites de facturation

Vous pouvez définir une limite de facturation . Nous cesserons d'ingérer les enregistrements lorsque vous atteindrez votre limite.

Avez-vous trouvé votre réponse?