Migração do SDK do Media independente para o Adobe Launch - Web (JS)

Diferenças nos recursos

  • Launch - o Launch fornece uma interface do usuário que orienta você na instalação, configuração e implantação de suas soluções de rastreamento de mídia baseadas na Web. O Launch melhora com o Dynamic Tag Management (DTM).
  • SDK do Media - o SDK do Media fornece bibliotecas de rastreamento de mídia criadas para plataformas específicas (por exemplo: Android, iOS, etc.). A Adobe recomenda o SDK do Media para rastrear o uso de mídia em aplicativos móveis.

Configuração

SDK do Media independente

No SDK do Media independente, é possível configurar o rastreamento no aplicativo
e transmiti-lo para o SDK ao criar o rastreador.

//Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = "namespace.hb.omtrdc.net";
mediaConfig.playerName = "html5-player";
mediaConfig.channel = "sample-channel";
mediaConfig.ovp = "video-provider";
mediaConfig.appVersion = "v2.0.0"
mediaConfig.ssl = true;
mediaConfig.debugLogging = true;

Além da configuração do MediaHeartbeat, a página deve configurar e transmitir
a instância AppMeasurement e a instância VisitorAPI para que o rastreamento de mídia funcione corretamente.

Extensão do Launch

  1. No Experience Platform Launch, clique na guia Extensões para sua
    propriedade da Web.

  2. Na guia Catálogo, localize a extensão Adobe Media Analytics para áudio e
    vídeo e clique em Instalar.

  3. Na página de configurações da extensão, defina os parâmetros de rastreamento. A extensão do Media usa os parâmetros configurados para rastreamento.

Guia do usuário do Launch - Instalar e configurar a extensão de mídia

Diferenças na criação do rastreador

SDK do Media

  1. Adicione a biblioteca do Media Analytics ao projeto de desenvolvimento.
  2. Criar um objeto de configuração (MediaHeartbeatConfig).
  3. Implemente o protocolo delegado, expondo as funções getQoSObject() e getCurrentPlaybackTime().
  4. Crie uma instância do Media Heartbeat (MediaHeartbeat).
// Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
...
// Configuration settings
mediaConfig.trackingServer = Configuration.HEARTBEAT.TRACKING_SERVER;
...
// Implement Media Delegate (Quality of Service and Playhead)
var mediaDelegate = new MediaHeartbeatDelegate();
...
mediaDelegate.getQoSObject = function() {
    return MediaHeartbeat.createQoSObject(<bitrate>, <startuptime>, <fps>, <droppedFrames>);
    ...
}
...
// Create your tracker
this.mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);

Launch

O Launch oferece duas abordagens para a criação da infraestrutura de rastreamento. Ambas as abordagens usam o Media Analytics Launch Extension:

  1. Use as APIs de rastreamento de mídia em uma página da Web.

    Nesse cenário, o Media Analytics Launch Extension exporta as APIs de rastreamento de mídia para uma variável configurada no objeto de janela global:

    window["CONFIGURED_VARIABLE_NAME"].MediaHeartbeat.getInstance
    
  2. Use as APIs de rastreamento de mídia de outra extensão do Launch.

    Nesse cenário, é possível usar as APIs de rastreamento de mídia expostas pelos Módulos compartilhados get-instance e media-heartbeat.

    OBSERVAÇÃO

    Os Módulos compartilhados não estão disponíveis para uso nas páginas da Web. É possível usar os Módulos compartilhados somente em outra extensão.

    Crie uma instância MediaHeartbeat usando o Módulo compartilhado get-instance.
    Transmita um objeto delegado para get-instance que exponha as funções getQoSObject() e getCurrentPlaybackTime().

    var getMediaHeartbeatInstance =
    turbine.getSharedModule('adobe-video-analytics', 'get-instance');
    

    Acesse as constantes MediaHeartbeat pelo Módulo compartilhado media-heartbeat.

Documentação relacionada

SDK do Media

Launch

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now