Visão geral da configuração do SDK de mídia de streaming 2.x herdado
Criado para:
- Usuário
- Administrador
- Desenvolvedor
As instruções desta seção se aplicam aos SDKs de mídia 2.x herdados.
-
Para mais informações sobre a implementação de uma versão 1.x do SDK de mídia, consulte a Documentação do SDK de mídia 1.x.
-
Para os integradores do Primetime, consulte a Documentação do SDK de mídia do Primetime.
Suporte mínimo para versão da plataforma
A tabela a seguir descreve as versões mínimas da plataforma compatíveis com cada SDK, a partir de 19 de fevereiro de 2019.
OS/Navegador | Versão mín. necessária |
---|---|
iOS | iOS 6+ |
Android | Android 5.0+ - Lollipop |
Chrome | v22+ |
Mozilla | v27+ |
Safari | v7+ |
IE | v11+ |
Diretrizes gerais de implementação
Há três componentes principais do SDK envolvidos no rastreamento de mídia:
- Config Media Heartbeat - A configuração contém as configurações básicas do relatórios.
- Delegar Media Heartbeat - O delegado controla o tempo de reprodução e o objeto QoS.
- Media Heartbeat - A biblioteca principal que contém membros e métodos.
Complete as etapas de implementação a seguir:
-
Crie uma instância
MediaHeartbeatConfig
e defina os valores do parâmetro de configuração.Nome da variável Descrição Obrigatório Valor padrão trackingServer
Servidor de rastreamento para análise de mídia. Isso é diferente do servidor de rastreamento de análise. Sim String vazia channel
Nome do canal Não String vazia ovp
Nome da plataforma de mídia online pela qual o conteúdo é distribuído. Não String vazia appVersion
Versão do aplicativo do reprodutor de vídeo/SDK Não String vazia playerName
Nome do media player em uso, ou seja, "AVPlayer", "HTML5 Player", "My Custom Player" Não String vazia ssl
Indica se as chamadas devem ser feitas em HTTPS Não false debugLogging
Indica se o registro de depuração está ativado Não false -
Implementar o
MediaHeartbeatDelegate
.Nome do método Descrição Obrigatório getQoSObject()
Retorna a instância MediaObject
que contém as informações de QoS atuais. Esse método será chamado várias vezes durante uma sessão de reprodução. A implementação do player sempre deve retornar os dados de QoS mais recentes.Sim getCurrentPlaybackTime()
Retorna a posição atual do indicador de reprodução.
Para rastreamento de VOD, o valor é especificado em segundos a partir do início do item de mídia.
Para transmissões ao vivo, se o player não fornecer informações sobre a duração do conteúdo, o valor pode ser especificado como o número de segundos desde a meia-noite UTC daquele dia.
Observação: ao usar marcadores de progresso, a duração do conteúdo é necessária e o indicador de reprodução precisa ser atualizado para o número de segundos desde o início do item de mídia, começando com 0.Sim TIP
O objeto de Qualidade do serviço (QoS) é opcional. Se os dados de QoS estiverem disponíveis para o player e você desejar rastrear esses dados, as seguintes variáveis serão necessárias:Nome da variável Descrição Obrigatório bitrate
A taxa de bits da mídia em bits por segundo. Sim startupTime
A hora de início da mídia em milissegundos. Sim fps
Os quadros exibidos por segundo. Sim droppedFrames
O número de quadros soltos até agora. Sim -
Crie a instância
MediaHeartbeat
.Use
MediaHertbeatConfig
eMediaHertbeatDelegate
para criar a instânciaMediaHeartbeat
.IMPORTANT
Certifique-se de que a instânciaMediaHeartbeat
possa ser acessada e não seja desalocada até o final da sessão. Essa instância será usada para todos os eventos de rastreamento de mídia a seguir.TIP
MediaHeartbeat
exige uma instância doAppMeasurement
para enviar chamadas para o Adobe Analytics. -
Combine todas as partes.
O código de exemplo a seguir usa o SDK 2.x do JavaScript para um player de vídeo HTML5:
// Create local references to the heartbeat classes var MediaHeartbeat = ADB.va.MediaHeartbeat; var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig; var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate; //Media Heartbeat Config var mediaConfig = new MediaHeartbeatConfig(); mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net"; mediaConfig.playerName = "HTML5 Basic"; mediaConfig.channel = "Video Channel"; mediaConfig.debugLogging = true; mediaConfig.appVersion = "2.0"; mediaConfig.ssl = false; mediaConfig.ovp = ""; // Media Heartbeat Delegate var mediaDelegate = new MediaHeartbeatDelegate(); // Set mediaDelegate CurrentPlaybackTime mediaDelegate.getCurrentPlaybackTime = function() { return video.currentTime; }; // Set mediaDelegate QoSObject - OPTIONAL mediaDelegate.getQoSObject = function() { return MediaHeartbeat.createQoSObject(video.bitrate, video.startuptime, video.fps, video.droppedframes); } // Create mediaHeartbeat instance this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);
Validar
As implementações de rastreamento do Media Analytics geram dois tipos de chamadas de rastreamento:
-
Chamadas de início de mídia e anúncio são enviadas diretamente para o servidor do Adobe Analytics (AppMeasurement).
-
As chamadas de heartbeat são enviadas para o servidor de rastreamento do Media Analytics (heartbeats), processadas e repassadas para o servidor do Adobe Analytics.
-
Servidor do Adobe Analytics (AppMeasurement) Para obter mais informações sobre as opções do servidor de rastreamento, consulte Preencher corretamente as variáveis trackingServer e trackingServerSecure.
IMPORTANT
Um servidor de rastreamento RDC, ou CNAME que é resolvido para um servidor RDC, é necessário para o serviço de ID do visitante da Experience Cloud.O servidor de rastreamento do Analytics deve terminar com “
.sc.omtrdc.net
” ou ser um CNAME. -
Servidor do Media Analytics (Heartbeats)
Este sempre tem o formato "[your_namespace].hb.omtrdc.net
". O valor "[your_namespace]
" especifica sua empresa e é fornecido pela Adobe.
O rastreamento de mídia funciona da mesma forma em todas as plataformas, desktops e dispositivos móveis. O rastreamento de áudio funciona atualmente em plataformas móveis. Para todas as chamadas de rastreamento, há algumas variáveis universais principais que precisam ser validadas:
Documentação do SDK 1.x
- Android: Configurar o Media Analytics
- DHLS: Configurar o Media Analytics
- iOS: Configurar o Media Analytics