Instalar o Media Analytics usando JavaScript

Última atualização em 2023-05-15
  • Criado para:
  • User
    Admin
    Developer

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 do Adobe Media Analytics para implementar o Analytics, conforme descrito em Implementar o Analytics usando a extensão do Media Analytics.

Pré-requisitos

  • 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

  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:

      <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.

      OBSERVAÇÃO

      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.

     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.

    IMPORTANTE

    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:

     // 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.

    var tracker = ADB.Media.getInstance();
    IMPORTANTE

    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

Página anterior
Next page

Nesta página