DocumentationAnalyticsGuide des services des médias en streaming

Fin de la session

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

L’événement de fin de session ferme immédiatement et de manière irréversible une session de suivi multimédia. La session se termine par une fermeture définitive : une fois envoyée, la session se termine et aucun autre événement ne peut être suivi en dessous. N’utilisez la fin de session que lorsque vous êtes certain qu’aucun événement supplémentaire ne se produira, par exemple lorsque le lecteur est détruit ou que la page est déchargée. Dans la plupart des cas, il est plus sûr de laisser la session expirer naturellement plutôt que de risquer d’interrompre les événements qui pourraient encore arriver. Si la visionneuse termine le contenu, appelez plutôt Fin de la session.

Sans fin de session explicite, une session se ferme automatiquement après 10 minutes d’absence d’événement ou 30 minutes d’absence de mouvement du curseur de lecture.

NOTE
Vous pouvez appeler en toute sécurité la fin de session plusieurs fois pour la même session. Le serveur principal ferme la session sur le premier événement et supprime silencieusement tous les événements suivants pour cet ID de session, y compris une seconde fin de session. Vous n’avez pas besoin de vous prémunir contre les appels en double dans des conditions de concurrence, telles qu’un délai d’expiration de 30 minutes expirant au moment où la visionneuse ferme le lecteur.

Types d’implémentation recommandés

SDK Web

Appelez sendEvent avec eventType: "media.sessionEnd" :

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.sessionEnd",
    mediaCollection: {
      sessionID: "{sid}",
      playhead: 45
    }
  }
});
iOS

Appelez trackSessionEnd lorsque la visionneuse ferme le lecteur ou quitte le lecteur.

code language-swift 
tracker.trackSessionEnd()
Android

Appelez trackSessionEnd lorsque la visionneuse ferme le lecteur ou quitte le lecteur.

code language-kotlin 
tracker.trackSessionEnd()
Roku

Appelez sendMediaEvent avec eventType: "media.sessionEnd" :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.sessionEnd",
        "mediaCollection": {
            "playhead": 45
        }
    }
})
API Media Edge

Appelez le point d’entrée sessionEnd :

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/sessionEnd?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.sessionEnd",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 45
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Appelez trackSessionEnd lorsque la visionneuse ferme le lecteur ou quitte le lecteur :

code language-javascript 
tracker.trackSessionEnd();
Chromecast

Appelez trackSessionEnd lorsque la visionneuse ferme le lecteur ou quitte le lecteur :

code language-javascript 
ADBMobile.media.trackSessionEnd();
API Media Collection

Envoyez une sessionEnd POST au point d’entrée événements :

code language-json 
{
  "playerTime": { "playhead": 45, "ts": 1699523820000 },
  "eventType": "sessionEnd"
}
recommendation-more-help
media-analytics-help