Visão geral da extensão do Adobe Media Analytics (3.x SDK) para áudio e vídeo

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). Essa extensão oferece a funcionalidade necessária para adicionar a instância do rastreador Media a um site ou projeto do Adobe Experience Platform Launch. A extensão do MA exige duas extensões adicionais:

• Extensão do Analytics
• Extensão do Experience Cloud ID

Depois de incluir todas as três extensões mencionadas acima em seu projeto do Platform 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 MA, abra a propriedade da extensão, selecione Extensions > Catalog, passe o mouse sobre a extensão Adobe Media Analytics (3.x SDK) for Audio and Video e selecione Install.

• Configuração: para configurar a extensão MA, abra a guia Extensions, passe o mouse sobre a extensão e selecione Configure:

Opções de configuração:

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.

1. APIs de mídia: window["CONFIGURED_VARIABLE_NAME"].Media

   Isso expõe todas as APIs e constantes do SDK de mídia: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

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

1. APIs de mídia: media módulo compartilhado

   Isso expõe todas as APIs e constantes do SDK de mídia: https://adobe-marketing-cloud.github.io/media-sdks/reference/javascript_3x/APIReference.html

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.