Rastrear a reprodução do conteúdo
O rastreamento de reprodução principal abrange carregamento de mídia, início, pausa, retomada, conclusão e fim de sessão. Embora não seja obrigatório, o rastreamento de buffering e busca também são componentes principais de uma implementação de reprodução completa.
Eventos do player
Etapas da implementação
- Identifique quando o usuário aciona a reprodução (o usuário clica em Reproduzir ou a reprodução automática é acionada). Crie um objeto de mídia com nome do conteúdo, ID, comprimento, tipo de fluxo e tipo de mídia. Consulte Nome do conteúdo, ID do conteúdo, Comprimento do conteúdo, Tipo de fluxo e Tipo de conteúdo para obter as definições de campo.
- Opcionalmente, anexar metadados — metadados padrão (programa, temporada, episódio etc.) e variáveis de dados de contexto personalizados. Consulte Programa, Temporada, Episódio, Gênero e Rede para obter referências de chave de metadados padrão.
- Chame Início da sessão para começar a rastrear a sessão. Isso carrega os dados e os metadados e inicia a medição de QoS do tempo para iniciar. SessionStart rastreia a intenção de reproduzir, não o primeiro quadro.
- Chame Reproduzir quando o primeiro quadro do conteúdo for renderizado na tela.
- Chamar Início da pausa quando o player pausar. Chame Reproduzir novamente quando a reprodução for retomada. Não há evento de retomada separado.
- Chame Sessão concluída quando o visualizador atingir o fim do conteúdo.
- Chame Fim da sessão quando o player for descarregado ou o visualizador abandonar o conteúdo sem atingir o fim. O SessionEnd fecha imediatamente a sessão; nenhum outro evento poderá ser rastreado depois dele.
SessionEnd marca o fim de uma sessão de rastreamento. Se a sessão tiver sido assistida até o fim, chame SessionComplete antes de SessionEnd. Qualquer outra chamada de rastreamento será ignorada depois de SessionEnd, exceto por SessionStart para uma nova sessão.Reprodução principal
Os exemplos a seguir mostram um fluxo de sessão completo — do início à conclusão da sessão até a conclusão do conteúdo e o fim da sessão.
Para obter detalhes sobre a implementação por plataforma, consulte Início da sessão, Reprodução, Início da pausa, Conclusão da sessão e Término da sessão.
Buffering
O início do buffer indica que o reprodutor está aguardando dados. O fim do buffer é inferido quando você envia um evento Play após BufferStart (APIs baseadas em XDM). No Mobile SDK, chame também BufferComplete explicitamente.
Para obter detalhes sobre a implementação, consulte Início do buffer.
Busca
O início da busca indica que o visualizador está depurando. O fim da busca é seguido por Reproduzir para retomar a reprodução do conteúdo.
Para obter detalhes sobre a implementação, consulte Início da pausa (início da busca) e Reprodução (fim da busca).
Manipulação de interrupções de aplicativos
A reprodução em um aplicativo de mídia pode ser interrompida de várias maneiras: o usuário pressiona pausar, o aplicativo vai para o segundo plano e é recebida uma chamada telefônica. Independentemente da causa, as instruções de rastreamento são as mesmas:
- Chame PauseStart quando o aplicativo for interrompido (entra em segundo plano, mídia pausada, etc.).
- Chame Reproduzir quando o aplicativo retornar para o primeiro plano e/ou quando a reprodução da mídia for retomada.
Quando uma sessão pausada deve terminar? Se o aplicativo não permitir reprodução em segundo plano, chame PauseStart imediatamente e SessionEnd após aproximadamente um minuto em segundo plano. O aplicativo não pode continuar enviando pings de pausa em segundo plano, e manter a sessão aberta indefinidamente fornece uma experiência ruim. Se o aplicativo oferecer suporte à reprodução em segundo plano (aplicativos de áudio, podcast de vídeo), continue enviando pings enquanto estiver em segundo plano.
Reiniciando após um longo período em segundo plano: Se o aplicativo tiver sido colocado em segundo plano por tempo suficiente para que a sessão expirasse (inatividade de 30 minutos), chame SessionEnd para fechar qualquer sessão remanescente de maneira limpa e, em seguida, chame SessionStart para iniciar uma nova sessão quando o visualizador retornar.
Resumo de sessões inativas
Uma sessão expira automaticamente se nenhum evento for recebido por 10 minutos ou se não houver movimento do indicador de reprodução por 30 minutos. Se o usuário retornar depois que uma sessão expirar, chame SessionStart novamente para abrir uma nova sessão.
Retomando entre dispositivos (entrega entre dispositivos): Quando um visualizador transfere a reprodução entre dispositivos (por exemplo, convertendo de um telefone para uma TV), use o sinalizador de retomada para unir as sessões nos relatórios do Analytics:
- No dispositivo de origem, chame SessionEnd quando o visualizador iniciar a conversão. Não chame SessionComplete — o conteúdo não é concluído.
- No dispositivo de destino, chame SessionStart com o sinalizador de retomada definido como
truee passe os mesmos metadados de conteúdo e a posição do indicador de reprodução do dispositivo de origem.
Definir o sinalizador de retomada faz com que o Analytics incremente retomas de conteúdo em vez de inícios da mídia para o segundo trecho da entrega.
Retomando manualmente uma sessão fechada anteriormente: Se o aplicativo armazenar dados do usuário e puder retomar uma sessão fechada anteriormente, defina o sinalizador de retomada no início da sessão. Consulte Início da sessão para obter detalhes sobre a implementação em todas as plataformas.