Show Menu
TÓPICOS×

Extensão Adobe Media Analytics (3.x SDK) for Audio and Video

Use esta documentação para obter informações sobre como instalar, configurar e implementar a extensão Adobe Media Analytics (3.x SDK) for Audio and Video (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 a Extensão Adobe Media Analytics for Audio and Video 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

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

Opções de configuração:

Opção
Descrição
Collection API Server
Define o Collection API Server de mídia (Entre em contato com seu representante da Adobe para obter este servidor)
Application Version
A versão do aplicativo do reprodutor de vídeo/SDK
Player Name
Nome do reprodutor de vídeo em uso (por exemplo, "AVPlayer", "HTML5 Player", "My Custom VideoPlayer")
Channel
Propriedade do nome do canal
Debug Logging
Ativar ou desativar registro
Enable SSL
Ativar ou desativar o envio de pings em HTTPS
Export APIs to Window Object
Ativar ou desativar a exportação de APIs do Media Analytics para o escopo global
Variable Name
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

A extensão do MA exporta as APIs de mídia no objeto da janela global ao ativar a configuração “Export APIs to Window Object” na página Configuration. Exporta as APIs sob o nome da variável configurada. Por exemplo, se o nome da variável estiver configurado para ser ADB , as APIs de mídia podem ser acessadas em 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 rastreador Media 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. Ou seja, uma página web ou aplicativo JavaScript não podem acessar os módulos compartilhados ou usar turbine (consulte um exemplo de código abaixo) fora de uma extensão.
  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 rastreador Media 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.