Show Menu
TÓPICOS×

Adobe Media Analytics (3.x SDK) para extensão de áudio e vídeo

Use esta documentação para obter informações sobre como instalar, configurar e implementar o Adobe Media Analytics (SDK 3.x) para a extensão de áudio e vídeo (extensão do Media Analytics). Estão incluídas as opções disponíveis ao usar esta extensão para criar uma regra, juntamente com exemplos e links para amostras.
A extensão do Media Analytics (MA) adiciona a principal SDK de mídia JavaScript (Media 3.x SDK). Esta extensão fornece a funcionalidade necessária para adicionar a instância do rastreador Media a um site ou projeto do Launch. A extensão do MA exige duas extensões adicionais:
Essa extensão é implantada com o SDK do Media 3.x, que não é compatível com o SDK do Media 2.x. Se sua página já usa o SDK do Media 2.x, use o Adobe Media Analytics para a extensão de áudio e vídeo em vez dessa extensão.
Depois de incluir todas as três extensões mencionadas acima em seu projeto do Launch, você pode prosseguir de uma das duas formas a seguir:
  • Use APIs Media do aplicativo web
  • Com a inclusão ou criação de uma extensão específica para um reprodutor que mapeie eventos específicos daquele reprodutor de mídia para as APIs na instância do rastreador do Media . Essa instância é exposta por meio da extensão do MA.

Instalação e configuração da extensão do MA

  • Instalar: Para instalar a extensão MA, abra sua propriedade de extensão, clique em Extensions > Catalog , passe o mouse sobre a Adobe Media Analytics (3.x SDK) for Audio and Video extensão e clique em Install .
  • Configurar: Para configurar a extensão MA, abra a Extensions guia, passe o mouse sobre a extensão e clique em Configure :

Opções de configuração:

Opção
Descrição
Servidor da API de coleção
Define o Media Collection API Server (Entre em contato com seu representante da Adobe para obter este servidor)
Versão do aplicativo
A versão do aplicativo do reprodutor de vídeo/SDK
Nome do reprodutor
Nome do reprodutor de vídeo em uso (por exemplo, "AVPlayer", "HTML5 Player", "My Custom Player")
Canal
Propriedade do nome do canal
Registro de depuração
Ativar ou desativar registro
Ativar SSL
Ativar ou desativar o envio de pings em HTTPS
Exportar APIs para o objeto Window
Ativar ou desativar a exportação de APIs do Media Analytics para o escopo global
Nome da variável
Uma variável usada para exportar as APIs do Media Analytics sob o objeto window
Lembrete : a extensão do MA exige as extensões do Analytics e da Experience Cloud ID . Você também deve adicionar essas extensões à propriedade da sua extensão e configurá-las.

Uso da extensão do MA

Uso de uma página web/aplicativo JS

The MA extension exports the Media APIs in the global window object by enabling the "Export APIs to Window Object" setting in the Configuration page. Exporta as APIs sob o nome da variável configurada. For example, if the variable name is configured to be ADB , then Media APIs can be accessed by window.ADB.Media .
A extensão do MA exporta as APIs apenas quando window["CONFIGURED_VARIABLE_NAME"] está indefinido e não substitui as variáveis existentes.
  1. APIs de mídia:   window["CONFIGURED_VARIABLE_NAME"].Media
  2. Criar instância do Media Tracker:   window["CONFIGURED_VARIABLE_NAME"].Media.getInstance
    Valor de retorno: Uma instância do Media rastreador para rastrear uma sessão de mídia.
    var Media = window["CONFIGURED_VARIABLE_NAME"].Media;
    
    var tracker = Media.getInstance();
    
    
  3. Usando a instância do Media Tracker, siga a documentação da API JS para implementar o rastreamento de mídia.
Você pode obter o player de amostra aqui: reprodutor MA de amostra . O reprodutor usado de exemplo atua como uma referência para mostrar como usar a extensão do MA para suportar o Media Analytics diretamente de um aplicativo web.

Com o uso a partir de outras extensões

A extensão MA expõe media como módulo compartilhado a outras extensões. (Para obter informações adicionais sobre Módulos compartilhados, consulte a documentação Módulos compartilhados .)
Os módulos compartilhados podem ser acessados somente a partir de outras extensões. That is, a webpage/JavaScript app cannot access the shared modules, or use turbine (see code sample below) outside of an extension.
  1. APIs de mídia: media módulo compartilhado
  2. Crie a instância do Media Tracker da seguinte maneira:
    Valor de retorno: Uma instância do Media rastreador para rastrear uma sessão de mídia.
    var Media =
      turbine.getSharedModule('adobe-media-analytics', 'media');
    
    var tracker = Media.getInstance();
    
    
  3. Usando a instância do Media Tracker, siga a documentação da API JS para implementar o rastreamento de mídia.
Testes:  nessa versão, para testar sua extensão, você deve carregá-la no  Adobe Experience Platform Launch , onde você tem acesso a todas as extensões dependentes.