Show Menu
TOPICS×

Visão geral da configuração

As instruções a seguir se aplicam aos SDKs do Media 2.x. Se estiver implementando uma versão 1.x do SDK do Media, consulte a Documentação do SDK do Media 1.x. Para obter os integradores do Primetime, consulte a
Documentação de SDK do Media do Primetime
abaixo.

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 de implementação gerais

Existem três componentes principais do SDK envolvidos no rastreamento de mídia:
  • Configuração do Heartbeat de mídia - contém as configurações básicas para a geração de relatórios.
  • Delegação do Heartbeat de mídia - o representante controla o tempo de reprodução e o objeto QoS.
  • Heartbeat de mídia - a biblioteca principal que contém membros e métodos.
Complete as etapas de implementação a seguir:
  1. 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 o Media Analytics. É diferente do seu servidor de monitoramento do Analytics.
    Sim
    Sequência de caracteres vazia
    channel
    Nome do canal
    Não
    Sequência de caracteres vazia
    ovp
    Nome da plataforma de mídia online pela qual o conteúdo é distribuído
    Não
    Sequência de caracteres vazia
    appVersion
    Versão do aplicativo/SDK do reprodutor de mídia
    Não
    Sequência de caracteres vazia
    playerName
    Nome do reprodutor de vídeo em uso, por exemplo, "AVPlayer", "HTML5 Player", "My Custom Player"
    Não
    Sequência de caracteres vazia
    ssl
    Indica se as chamadas devem ser efetuadas por HTTPS
    Não
    false
    debugLogging
    Indica se o log de depuração está ativado
    Não
    false
  2. 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 reprodutor 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 rastreamento LINEAR/LIVE, o valor é especificado em segundos a partir do início do programa.
    Sim
    O objeto de Qualidade do serviço (QoS) é opcional. Se os dados de QoS estiverem disponíveis para o seu reprodutor e você desejar rastreá-los, 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 inicialização da mídia, em milissegundos.
    Sim
    fps
    Os quadros exibidos por segundo.
    Sim
    droppedFrames
    O número de quadros ignorados até o momento.
    Sim
  3. Crie a instância
    MediaHeartbeat
    .
    Use
    MediaHertbeatConfig
    e
    MediaHertbeatDelegate
    para criar a instância
    MediaHeartbeat
    .
    Certifique-se de que a instância
    MediaHeartbeat
    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.
    MediaHeartbeat
    exige uma instância do
    AppMeasurement
    para enviar chamadas para o Adobe Analytics.
  4. Combine todas as partes.
    O código de exemplo a seguir usa o SDK do JavaScript 2.x para um reprodutor 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.
    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

SDKs do Video Analytics 1.x 
 Guias do desenvolvedor (somente PDFs)
Android
Apple TV
Chromecast
iOS
JavaScript
Primetime
TVML

Documentação de SDK do Media do Primetime