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:
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 Platform Launch, você pode prosseguir de uma das duas formas a seguir:
Media
do aplicativo webMedia
. Essa instância é exposta por meio da extensão do MA.Instalação: Para instalar a extensão MA, abra sua propriedade de extensão, selecione Extensions > Catalog, passe o mouse sobre a Adobe Media Analytics (3.x SDK) for Audio and Video extensão e selecione Install.
Configurar: Para configurar a extensão MA, abra a Extensions guia, passe o mouse sobre a extensão e selecione Configure:
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.
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.
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
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();
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.
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.
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
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();
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.