Fim da sessão

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 encerramento permanente — uma vez enviada, a sessão é encerrada e nenhum outro evento pode 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.

SDK da web

Chamar sendEvent com eventType: "media.sessionEnd":

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

SDK móvel

Chame trackSessionEnd quando o visualizador fechar o reprodutor ou sair.

iOS (Swift)

tracker.trackSessionEnd()

Android (Kotlin)

tracker.trackSessionEnd()

Roku (BrightScript)

Chamar sendMediaEvent com eventType: "media.sessionEnd":

m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.sessionEnd",
        "mediaCollection": {
            "playhead": 45
        }
    }
})

API de borda de mídia

Chame o ponto de extremidade sessionEnd:

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"
    }
  }]
}'

SDK de mídia

Chame trackSessionEnd quando o visualizador fechar o reprodutor ou sair:

tracker.trackSessionEnd();

API da coleção de mídia

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

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