DocumentaçãoAnalyticsGuia da Coleção de mídia de transmissão

Instalar o SDK de mídia usando o JavaScript install-web-sdks

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • Usuário
  • Administrador
  • Desenvolvedor

As informações nesta página descrevem como instalar o SDK independente da Web e configurar o JavaScript.

Como alternativa, você pode usar a extensão Adobe Medium Analytics para implementar o Complemento Adobe Streaming Media Collection, conforme descrito em Implementar o Analytics usando a extensão Media Analytics.

Pré-requisitos prerequesites

  • Obter parâmetros de configuração válidos

    Esses parâmetros podem ser obtidos com um representante da Adobe após a configuração da conta do Analytics.

  • Implementar o AppMeasurement e Experience Cloud Identity Service para JavaScript no aplicativo de mídia

    Para obter mais informações, consulte Implementação do Analytics usando JavaScript e Implementação do serviço de identidade da Experience Cloud.

  • Inclua as seguintes APIs em seu reprodutor de mídia

    • Uma API para assinar eventos do player - O SDK de mídia exige que você chame um conjunto de APIs simples quando eventos ocorrem no player.
    • Uma API que fornece informações sobre o player - Inclui informações sobre anúncios, capítulos e mídias que estão sendo reproduzidas no momento.

Configurar o JavaScript 3.x set-up-javascript

  1. Adicione a biblioteca baixada ao projeto. Para conveniência, crie referências locais para as classes.

    1. Expanda o arquivo MediaSDK-js-v3*.zip que você baixou.

    2. Verifique se o arquivo MediaSDK.js existe no diretório libs.

    3. Hospede o arquivo MediaSDK.js.

      Esse arquivo JavaScript principal deve ser hospedado em um servidor da Web acessível a todas as páginas do site. Você precisa do caminho para esses arquivos para a próxima etapa.

    4. Referencie MediaSDK.js em todas as páginas do site.

      Inclua MediaSDK para o JavaScript ao adicionar a seguinte linha de código na tag <head> ou <body> em cada página. Por exemplo:

      code language-html 
      <script type="text/javascript" src="https://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/MediaSDK.js"></script>

    5. Para verificar rapidamente se a biblioteca foi importada, verifique se ADB.Media foi exportado no objeto Window.

      note note
      NOTE
      O SDK do JavaScript é compatível com as especificações dos módulos AMD e CommonJS, e o MediaSDK.js também pode ser usado com carregadores de módulo compatíveis.

  2. Crie uma instância de AppMeasurement e configure o visitor.

    A configuração do Media SDK requer uma instância de AppMeasurement com o visitor configurado.

    code language-js 
     var appMeasurement = new AppMeasurement("<rsid>");
 appMeasurement.visitor = visitor;
 appMeasurement.trackingServer = "<visitor_namespace>.sc.omtrdc.net";

  3. Configurar o Media SDK

    O Media SDK deve ser configurado uma vez por página da Web e a configuração se aplica a todas as instâncias do rastreador criadas.

    note important
    IMPORTANT
    O Media SDK (3.x) usa a API Media Collection para rastrear mídia diferente do ponto de extremidade HB usado nos SDKs 2.x. Entre em contato com seu representante da Adobe para obter mais informações.

    Aqui está uma amostra de inicialização MediaConfig:

    code language-js 
     // Create MediaConfig object (same as above)
 var mediaConfig = new ADB.MediaConfig();
 mediaConfig.trackingServer = Configuration.MEDIA_COLLECTION_ENDPOINT;
 mediaConfig.playerName = Configuration.PLAYER_NAME;
 mediaConfig.channel = Configuration.CHANNEL;
 mediaConfig.appVersion = Configuration.APP_VERSION;
 mediaConfig.debugLogging = false;
 mediaConfig.ssl = true;

 ADB.Media.configure(mediaConfig, appMeasurement);

  4. Crie a instância MediaTracker.

    Depois de configurar o Media SDK, as instâncias do rastreador para rastrear conteúdo de mídia podem ser criadas usando a API getInstance.

    code language-js 
    var tracker = ADB.Media.getInstance();
    note important
    IMPORTANT
    Certifique-se de que a instância do tracker possa ser acessada e não seja desalocada até o final da sessão de mídia. Essa instância será usada para rastrear todos os eventos a seguir para essa sessão.

Migrar do JavaScript 2.x para o 3.x

Para obter informações detalhadas sobre a migração de 2.x para 3.x, consulte Migração do 2.x para 3.x.

Para conteúdo herdado, consulte Implementações herdadas

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb