DocumentaçãoExperience PlatformTags

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

Last update: Wed Mar 15 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Developer
NOTE
O Adobe Experience Platform Launch foi reformulado como um conjunto de tecnologias de coleção de dados na Adobe Experience Platform. Como resultado, várias alterações de terminologia foram implementadas na documentação do produto. Consulte o seguinte documento para obter uma referência consolidada das alterações de terminologia.

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 fornece a funcionalidade para adicionar a instância Media do rastreador a sites ou projetos que tenham as tags habilitadas. A extensão do MA exige duas extensões adicionais:

IMPORTANT
Essa extensão é implantada com o SDK do Media 3.x, que não é compatível com o SDK do Media 2.x. Como a 2.x foi descontinuada, atualize para a 3.x.

Depois de incluir todas as três extensões mencionadas acima em seu projeto com tags habilitadas, você pode prosseguir de uma das duas seguintes formas:

  • 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 do MA, abra sua propriedade de extensão, selecione Extensões > Catálogo, passe o mouse sobre o Adobe Media Analytics (3.x SDK) para Extensão de áudio e vídeo e selecione Instalar.

  • Configurar: para configurar a extensão do MA, abra a guia Extensões, passe o mouse sobre a extensão e selecione Configurar:

Configuração de extensão do MA

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
Nome do reprodutor
Nome do reprodutor de vídeo em uso (por exemplo, "AVPlayer", "HTML5 Player", "My Custom VideoPlayer")
Canal
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 de janela global, habilitando a configuração "Exportar APIs para objeto de janela" na página Configuração. 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.

IMPORTANT
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

    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.

    code language-javascript 
    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 para outras extensões. (Para obter informações adicionais sobre Módulos compartilhados, consulte a documentação Módulos compartilhados.)

IMPORTANT
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

    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.

    code language-javascript 
    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.

NOTE
Testes:  nessa versão, para testar sua extensão, você deve carregá-la no Platform, onde você tem acesso a todas as extensões dependentes.
recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743