DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Fim da sessão

Última atualização: 29 de maio de 2026

Criado para:

  • Developer

O evento de término de sessão fecha imediatamente e irreversivelmente uma sessão de rastreamento de mídia. O término da sessão é um fechamento permanente; uma vez enviada, a sessão será encerrada e nenhum outro evento poderá ser rastreado nela. Use Sessão somente quando tiver certeza de que nenhum evento adicional acontecerá, como quando o reprodutor for destruído ou a página for descarregada. Na maioria dos casos, é mais seguro permitir que a sessão expire naturalmente, em vez de correr o risco de interromper eventos que ainda podem chegar. Se o visualizador terminar o conteúdo, chame Sessão concluída.

Sem um fim de sessão explícito, uma sessão é fechada automaticamente após 10 minutos sem eventos ou 30 minutos sem movimento do indicador de reprodução.

NOTE
Você pode chamar com segurança o término de uma sessão mais de uma vez para a mesma sessão. O backend fecha a sessão no primeiro evento e descarta silenciosamente todos os eventos subsequentes dessa ID de sessão, incluindo um segundo fim de sessão. Você não precisa se proteger contra chamadas duplicadas em condições de corrida, como um tempo limite de 30 minutos expirando ao mesmo tempo em que o visualizador fecha o reprodutor.

Tipos de implementação recomendados

Web SDK

Chamar sendEvent com eventType: "media.sessionEnd":

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

Chame trackSessionEnd quando o visualizador fechar o reprodutor ou sair.

code language-swift 
tracker.trackSessionEnd()
Android

Chame trackSessionEnd quando o visualizador fechar o reprodutor ou sair.

code language-kotlin 
tracker.trackSessionEnd()
Roku Edge

Chamar sendMediaEvent com eventType: "media.sessionEnd":

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

Chame o ponto de extremidade 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"
    }
  }]
}'

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Chame trackSessionEnd quando o visualizador fechar o reprodutor ou sair:

code language-javascript 
tracker.trackSessionEnd();
Chromecast

Chame trackSessionEnd quando o visualizador fechar o reprodutor ou sair:

code language-javascript 
ADBMobile.media.trackSessionEnd();
Roku 2.x

Chame mediaTrackSessionEnd quando o visualizador fechar o reprodutor ou sair:

code language-brightscript 
ADBMobile().mediaTrackSessionEnd()
API da coleção de mídia

Enviar uma POSTAGEM sessionEnd para o ponto de extremidade de eventos:

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