Show Menu
TÓPICOS×

Integração do Dynamic Media Viewers ao Adobe Analytics e ao Adobe Launch

O que é a integração dos visualizadores de mídia dinâmica com o Adobe Analytics e o Adobe Launch?

The new Dynamic Media Viewers extension for Adobe Launch, along with the recent release of Dynamic Media Viewers 5.13, lets customers of Dynamic Media, Adobe Analytics, and Adobe Launch to use events and data specific for the Dynamic Media Viewers in their Adobe Launch configuration.
Essa integração significa que você pode rastrear o uso de visualizadores de mídia dinâmica em seu site com o Adobe Analytics. Ao mesmo tempo, você pode usar os eventos e os dados expostos pelos visualizadores com qualquer outra extensão do Launch da Adobe ou de terceiros.
Consulte Adobe Extension no Guia do usuário do Experience Platform Launch para saber mais sobre extensões.
​Quem deve ler esta documentação: Administradores de site, Desenvolvedores na plataforma AEM e aqueles em Operações.

Limitações da integração

  • A integração do Adobe Launch para visualizadores do Dynamic Media não funciona no nó do autor do AEM. Não é possível ver nenhum rastreamento de uma página WCM até que ela seja publicada.
  • A integração do Adobe Launch para visualizadores do Dynamic Media não é compatível com o modo de operação "pop-up", onde o URL do visualizador é obtido usando o botão "URL" na página Detalhes do ativo.
  • A integração do Adobe Launch não pode ser usada simultaneamente com os visualizadores herdados da integração do Analytics (por meio do config2= parâmetro).
  • O suporte para rastreamento de vídeo está limitado somente ao rastreamento de reprodução principal, conforme descrito em Visão geral do rastreamento. Especificamente, o rastreamento de QoS, Anúncios, Capítulo/Segmentos ou Erros não é suportado.
  • A configuração de Duração do armazenamento para Elementos de dados não é compatível com Elementos de dados que usam a extensão Visualizadores de mídia dinâmica. A Duração do armazenamento deve ser definida como Nenhum .

Casos de uso da integração

O caso de uso principal para a integração com o Adobe Launch são os clientes que usam os ativos AEM e os sites AEM. Nesses cenários, você pode configurar uma integração padrão entre o nó do autor do AEM e o Adobe Launch e associar a instância do Sites à propriedade do Adobe Launch. Depois disso, qualquer componente WCM do Dynamic Media adicionado a uma página Sites rastreará os dados e os eventos dos visualizadores.
Um caso de uso secundário suportado pela integração são os clientes que usam somente os ativos AEM ou o Dynamic Media Classic. Nesses casos, você obtém o código incorporado do visualizador e o adiciona à página do site. Em seguida, obtenha o URL de produção da biblioteca do Adobe Launch do Adobe Launch e adicione-o manualmente ao código da página da Web.

Como os dados e o rastreamento de eventos funcionam na integração

A integração aproveita dois tipos separados e independentes de rastreamento de visualizadores de mídia dinâmica: Adobe Analytics e Adobe Analytics para áudio e vídeo .

Sobre o rastreamento usando o Adobe Analytics

O Adobe Analytics permite rastrear ações executadas pelo usuário final quando interagem com os Visualizadores de Mídia Dinâmica do site. O Adobe Analytics também permite rastrear dados específicos do visualizador. Por exemplo, você pode rastrear e gravar eventos de carregamento de exibição junto com o nome do ativo, quaisquer ações de zoom que ocorreram, ações de reprodução de vídeo e assim por diante.
No Adobe Launch, os conceitos de Elementos de dados e Regras trabalham em conjunto para permitir o rastreamento do Adobe Analytics.

Sobre elementos de dados no Adobe Launch

Um elemento de dados no Adobe Launch é uma propriedade nomeada cujo valor é definido estaticamente ou calculado dinamicamente com base no estado de uma página da Web ou nos dados do Visualizador de mídia dinâmica.
As opções disponíveis para uma definição de Elemento de dados dependem da lista de Extensões instaladas na Propriedade do Adobe Launch. A extensão "Core" é pré-instalada e está disponível imediatamente em qualquer configuração. Essa extensão "Core" permite definir um Elemento de dados que o valor vem do cookie, código JavaScript, sequência de caracteres de consulta e muitas outras fontes.
Para o Adobe Analytics, é necessário instalar várias extensões adicionais, conforme descrito em Instalação e configuração de extensões . A extensão do visualizador de mídia dinâmica adiciona uma capacidade de definir um elemento de dados que é um argumento do evento do visualizador dinâmico. Por exemplo, é possível fazer referência ao tipo de visualizador ou ao nome do ativo reportado pelo visualizador durante a carga, o nível de zoom reportado quando o usuário final aumenta o zoom e muito mais.
A extensão do Visualizador de mídia dinâmica mantém automaticamente os valores de seus Elementos de dados atualizados.
Depois de defini-lo, um Elemento de dados pode ser usado em outros locais da interface do usuário do Adobe Launch, usando o widget seletor de elementos de dados. Especificamente, os Elementos de dados definidos para fins de rastreamento de Visualizadores de Mídia Dinâmica serão referenciados pela Ação Definir variáveis da extensão do Adobe Analytics na Regra (consulte abaixo).
Consulte Elementos de dados no Guia do usuário do Experience Platform Launch para saber mais.

Sobre regras no Adobe Launch

Uma regra no Adobe Launch é uma configuração agnóstica que define três áreas que compõem uma regra: Eventos , Condições e Ações :
  • Os eventos (se) informam ao Adobe Launch quando uma regra deve ser acionada.
  • As condições (se) indicam ao Adobe Launch quais restrições adicionais serão permitidas ou não quando uma Regra for acionada.
  • As ações (em seguida) informam ao Adobe Launch o que fazer quando uma Regra é acionada.
As opções disponíveis na seção Eventos, Condições e Ações dependem das extensões instaladas na Propriedade do Adobe Launch. A extensão Core é pré-instalada e está disponível prontamente em qualquer configuração. A extensão fornece várias opções para Eventos, como ações básicas em nível de navegador que incluem mudança de foco, pressionamentos de tecla, envios de formulário e assim por diante. Também inclui opções para Condições, como valor de cookie, tipo de navegador e muito mais. Para Ações, somente a opção Código personalizado está disponível.
Para o rastreamento do Adobe Analytics, várias extensões adicionais devem ser instaladas, conforme descrito em Instalação e configuração de extensões . Especificamente:
  • A extensão do visualizador de mídia dinâmica estende a lista de eventos suportados para eventos específicos do visualizador de mídia dinâmica, como carregamento do visualizador, troca de ativos, aumento de zoom e reprodução de vídeo.
  • A extensão do Adobe Analytics estende a lista de Ações compatíveis com duas ações necessárias para enviar dados para servidores de rastreamento: Defina as variáveis e envie o beacon .
Para rastrear visualizadores de Dynamic Media, é possível usar qualquer tipo de:
  • Eventos da extensão, extensão Core ou qualquer outra extensão do visualizador de mídia dinâmica.
  • Condições na definição da regra. Ou você pode deixar a área de condições vazia.
Na seção Ações, é necessário que você tenha uma ação Definir variáveis . Essa ação diz ao Adobe Analytics como preencher variáveis de rastreamento com dados. Ao mesmo tempo, a ação Definir variáveis não envia nada para o servidor de rastreamento.
A ação Definir variáveis deve ser seguida por uma ação Enviar beacon . A ação Enviar beacon na verdade envia dados para o servidor de rastreamento do Analytics. Ambas as ações, Definir variáveis e Enviar beacon , vêm da extensão do Adobe Analytics.
Consulte Regras no Guia do usuário do Experience Platform Launch para saber mais.

Exemplo de configuração

A seguinte configuração de exemplo no Adobe Launch demonstra como rastrear um nome de ativo no carregamento do visualizador.
  1. Na guia Elementos de dados, defina um elemento de dados AssetName que faça referência ao asset parâmetro do LOAD evento da extensão Visualizadores de mídia dinâmica.
  2. Na guia Regras , defina uma regra TrackAssetOnLoad .
    Nessa regra, o campo Evento usa o evento LOAD da extensão Visualizadores de Mídia Dinâmica.
  3. A configuração Ação tem dois tipos de Ação da extensão do Adobe Analytics:
    Defina Variáveis , que mapeiam uma variável de análise de sua escolha para o valor do Elemento de AssetName dados.
    Envie o Beacon , que envia informações de rastreamento para o Adobe Analytics.
  4. A configuração de regra resultante é semelhante ao seguinte:

Sobre o Adobe Analytics para áudio e vídeo

Quando uma conta da Experience Cloud é assinada para usar o Adobe Analytics para áudio e vídeo, basta ativar o rastreamento de vídeo nas configurações de extensão do Dynamic Media Viewers . As métricas de vídeo tornam-se disponíveis no Adobe Analytics. O rastreamento de vídeo depende da presença da extensão de áudio e vídeo do Adobe Media Analytics.
Atualmente, o suporte para rastreamento de vídeo está limitado somente ao rastreamento de "reprodução principal", conforme descrito em Visão geral do rastreamento. Especificamente, o rastreamento de QoS, Anúncios, Capítulo/Segmentos ou Erros não é suportado.

Uso da extensão Visualizadores de mídia dinâmica

Conforme mencionado em Casos de uso para a integração , é possível rastrear visualizadores de Mídia dinâmica com a nova integração do Adobe Launch no AEM Sites e usando o código incorporado.

Rastrear visualizadores de Mídia dinâmica no AEM Sites

Para rastrear visualizadores de Dynamic Media no AEM Sites, todas as etapas listadas na seção Configurar todas as partes da integração devem ser executadas. Especificamente, você deve criar a configuração do IMS e a Configuração da Adobe Launch Cloud.
Após a configuração correta, qualquer visualizador de Dynamic Media que você adiciona a uma página Sites, usando um componente WCM suportado pelo Dynamic Media, rastreia automaticamente os dados para o Adobe Analytics, o Adobe Analytics para Vídeo ou ambos.

Rastreamento de visualizadores de Dynamic Media usando código incorporado

Os clientes que não usam o AEM Sites ou incorporam visualizadores do Dynamic Media a páginas da Web fora do AEM Sites, ou ambos, ainda podem usar a integração do Adobe Launch.
Você deve concluir as etapas de configuração das seções Configuração do Adobe Analytics e Configuração do Adobe Launch . No entanto, as etapas de configuração relacionadas ao AEM não são necessárias.
Após a configuração correta, você pode adicionar o suporte ao Adobe Launch a uma página da Web com um visualizador de Dynamic Media.
Consulte Adicionar o código Incorporado para saber mais sobre como usar o código incorporado da biblioteca do Adobe Launch.
Consulte Incorporação do visualizador de vídeo ou imagem em uma página da Web para saber mais sobre como usar o recurso de código incorporado do AEM Dynamic Media.
Para rastrear visualizadores do Dynamic Media usando o código incorporado
  1. Tenha uma página da Web pronta para incorporar um visualizador de Dynamic Media.
  2. Obtenha o código incorporado da biblioteca do Adobe Launch fazendo logon primeiro no Adobe Launch (consulte Configuração do Adobe Launch ).
  3. Clique em Propriedade e, em seguida, clique na guia Ambientes .
  4. Escolha o nível de Ambiente relevante para o ambiente da página da Web. Em seguida, na coluna Instalar , clique no ícone da caixa.
  5. Na caixa de diálogo Instruções de instalação na Web, copie o código incorporado completo da biblioteca do Adobe Launch, juntamente com as <script/> tags adjacentes.

Guia de referência para a extensão do visualizador de mídia dinâmica

Sobre a configuração do Visualizador de mídia dinâmica

A extensão do Visualizador de mídia dinâmica é integrada automaticamente à biblioteca do Adobe Launch se todas as condições abaixo forem verdadeiras:
  • O objeto global da biblioteca do Adobe Launch ( _satellite ) está presente na página.
  • A função de extensão Visualizadores de Mídia Dinâmica _dmviewers_v001() é definida em _satellite .
  • config2= o parâmetro do visualizador não foi especificado, o que significa que o visualizador não usa a integração herdada do Analytics.
Além disso, há uma opção para desativar explicitamente a integração do Adobe Launch no visualizador especificando o launch=0 parâmetro na configuração do visualizador. O valor padrão desse parâmetro é 1 .

Configuração da extensão do visualizador de mídia dinâmica

A única opção de configuração para a extensão Visualizadores de mídia dinâmica é Habilitar o Adobe Media Analytics para áudio e vídeo .
Ao marcar (ativar ou "ativar") essa opção e se a extensão de Áudio e Vídeo do Adobe Media Analytics for instalada e configurada corretamente, as métricas de reprodução de vídeo serão enviadas para a solução de Áudio e Vídeo do Adobe Analytics. Desativar esta opção desativa o rastreamento de vídeo.
Observe que se você ativar essa opção sem ter a extensão Adobe Media Analytics para áudio e vídeo instalada, a opção não terá efeito.

Sobre elementos de dados na extensão Visualizadores de mídia dinâmica

O único tipo de elemento de dados fornecido pela extensão Visualizadores de mídia dinâmica é o Evento do visualizador na lista suspensa Tipo de elemento de dados.
Quando selecionado, o editor de Elementos de dados renderiza um formulário com dois campos:
  • Tipo de dados do evento de visualizadores do DM - uma lista suspensa que identifica todos os eventos do visualizador compatíveis com a extensão do Visualizador de mídia dinâmica que têm argumentos, além de um item COMUM especial. Um item COMUM representa uma lista de parâmetros de evento comuns a todos os tipos de eventos enviados pelos visualizadores.
  • Parâmetro de rastreamento - um argumento do evento do visualizador de Dynamic Media selecionado.
Consulte o guia de referência Visualizadores de mídia dinâmica para obter a lista de eventos suportados por cada tipo de visualizador; vá para a seção específica do visualizador e clique em Suporte para a subseção de rastreamento do Adobe Analytics. Atualmente, o guia de referência Visualizadores de mídia dinâmica não documenta argumentos de evento.
Vamos agora considerar o ciclo de vida do elemento de dados do visualizador de mídia dinâmica. O valor desse Elemento de dados é preenchido depois que o evento do visualizador de Mídia dinâmica correspondente ocorre na página. Por exemplo, se o Elemento de dados apontar para o evento LOAD e seu argumento "asset", o valor desse Elemento de dados receberá dados válidos depois que o visualizador executar o evento LOAD pela primeira vez. Se o elemento de dados apontar para o evento ZOOM e seu argumento de "escala", o valor desse elemento de dados permanecerá vazio até que o visualizador envie um evento ZOOM pela primeira vez.
Da mesma forma, os valores dos Elementos de dados são atualizados automaticamente quando o visualizador envia um evento correspondente na página. A atualização de valor acontece mesmo se o evento específico não for especificado na configuração Regra. Por exemplo, se ZoomScale do elemento de dados for definido para o parâmetro "scale" do evento ZOOM, mas a única regra presente na configuração Regra for acionada pelo evento LOAD , o valor de ZoomScale ainda será atualizado sempre que um usuário executar o zoom dentro do visualizador.
Qualquer visualizador do Dynamic Media tem um identificador exclusivo na página da Web. O Elemento de dados rastreia o próprio valor e o visualizador que preencheu o valor. Isso significa que, se houver vários visualizadores na mesma página e houver um Elemento de dados AssetName que aponte para o evento LOAD e seu argumento "asset", o Elemento de dados AssetName manterá uma coleção de nomes de ativos associados a cada visualizador carregado na página.
O valor exato retornado pelo Elemento de dados depende do contexto. Se o Elemento de dados for solicitado em uma Regra que foi acionada por um evento do visualizador de Mídia dinâmica, o valor do Elemento de dados será retornado para o visualizador que iniciou a Regra. E, se o Elemento de dados for solicitado em uma Regra que foi acionada por um Evento de outra extensão do Adobe Launch, o valor do Elemento de dados será o valor do visualizador que foi o último a atualizar este Elemento de dados.
Considere a seguinte configuração de amostra:
  • Uma página da Web com dois visualizadores de zoom do Dynamic Media; nós os referenciaremos como viewer1 e viewer2 .
  • O elemento de dados ZoomScale aponta para o evento ZOOM e seu argumento "scale".
  • Regra TrackPan com o seguinte:
    • Usa o evento PAN do visualizador de mídia dinâmica como disparador.
    • Envia o valor do elemento de dados ZoomScale para o Adobe Analytics.
    • Regra TrackKey com o seguinte:
    • Usa o evento key press da extensão Core Adobe Launch como disparador.
    • Envia o valor do elemento de dados ZoomScale para o Adobe Analytics.
Agora, suponha que o usuário final carregue a página da Web com os dois visualizadores. No visualizador1 , eles aumentam o zoom para 50% de escala; em seguida, no visualizador2 , eles aumentam o zoom para 25%. No visualizador1 , eles deslocam a imagem e, por fim, pressionam uma tecla no teclado.
A atividade do usuário final resulta nas duas chamadas de rastreamento a seguir feitas ao Adobe Analytics:
  • A primeira chamada ocorre porque a Regra TrackPan é acionada quando o usuário entra em exibição1 . Essa chamada envia 50% como um valor do Elemento de Dados ZoomScale , pois o Elemento de Dados saberá que a Regra é acionada pelo visualizador1 e busca o valor de escala correspondente;
  • A segunda chamada ocorre porque a Regra TrackKey é acionada quando o usuário pressiona uma tecla no teclado. Essa chamada envia 25% como um valor do Elemento de dados ZoomScale porque a Regra não foi acionada pelo visualizador. Dessa forma, o Elemento de dados retorna o valor mais atualizado.
A amostra configurada acima também afeta a duração do valor do Elemento de dados. O valor do Elemento de dados gerenciado pelo Visualizador de mídia dinâmica é armazenado no código da biblioteca do Adobe Launch mesmo depois que o próprio visualizador é descartado na página da Web. Isso significa que, se houver uma Regra acionada por uma extensão que não seja o Visualizador de mídia dinâmica e fizer referência a esse Elemento de dados, o Elemento de dados retornará o último valor conhecido, mesmo que o visualizador não esteja mais presente na página da Web.
Em qualquer caso, os valores dos elementos de dados controlados pelos visualizadores de mídia dinâmica não são armazenados no armazenamento local ou no servidor; em vez disso, eles são mantidos somente na biblioteca do Adobe Launch do lado do cliente. Os valores desse Elemento de dados desaparecem quando a página da Web é recarregada.
Geralmente, o editor de Elementos de dados oferece suporte à seleção da duração do armazenamento. Entretanto, os Elementos de dados que usam a extensão Visualizadores de Mídia Dinâmica suportam apenas a opção de duração de armazenamento de Nenhum . A definição de qualquer outro valor é possível na interface do usuário, mas o comportamento do Elemento de dados não é definido nesse caso. A extensão gerencia o valor do Elemento de dados sozinho: o elemento de dados que mantém o valor do argumento de evento do visualizador durante todo o ciclo de vida do visualizador.

Sobre regras na extensão Visualizadores de Mídia Dinâmica

No Editor de regras, a extensão adiciona novas opções de configuração para o editor de eventos. Além disso, o oferece uma opção para fazer referência manual aos parâmetros do evento no editor de Ação como uma opção de mão curta, em vez de usar elementos de dados pré-configurados.

Sobre o editor de eventos

No Editor de eventos, a extensão Visualizadores de mídia dinâmica adiciona um novo Tipo de evento chamado Evento ​visualizador.
Quando selecionado, o Editor de eventos renderiza os eventos suspensos do Visualizador de mídia dinâmica, listando todos os eventos disponíveis compatíveis com os visualizadores de Mídia dinâmica.

Sobre o editor de Ações

A extensão Visualizadores de mídia dinâmica permite usar parâmetros de evento de visualizadores de Mídia dinâmica para mapear para variáveis de análise no editor Definir variáveis da extensão do Adobe Analytics.
O método mais simples para fazer isso é concluir o seguinte processo de duas etapas:
  • Primeiro, defina um ou mais Elementos de dados, onde cada Elemento de dados representa um parâmetro de um evento do Visualizador de mídia dinâmica.
  • Finalmente, no editor Definir variáveis da extensão do Adobe Analytics, clique no ícone do seletor de elementos de dados (três discos empilhados) para abrir a caixa de diálogo Selecionar elemento de dados e selecione um elemento de dados a partir dele.
No entanto, é possível usar uma abordagem alternativa e ignorar a criação do elemento de dados. Você pode fazer referência direta a um argumento de um evento do Visualizador de Mídia Dinâmica digitando o nome totalmente qualificado do argumento de evento no campo de entrada de valor da atribuição de variável do Analytics, cercado por sinais de porcentagem (%). Por exemplo,
%event.detail.dm.LOAD.asset%
Observe que há uma diferença importante entre o uso de Elementos de dados e a referência de argumento de evento direto. Para Elemento de dados, não importa qual evento aciona a ação Definir variáveis, o evento que aciona a regra pode não estar relacionado ao Visualizador dinâmico (como um clique do mouse na página da Web da extensão Principal). Mas, ao usar uma referência de argumento direto, é importante garantir que o evento que aciona a regra corresponda ao argumento de evento que ela menciona.
Por exemplo, a referência %event.detail.dm.LOAD.asset% retornará o nome correto do ativo se a Regra for acionada pelo evento LOAD da extensão do Visualizador de Mídia Dinâmica. No entanto, retorna um valor vazio para qualquer outro evento.
A tabela a seguir lista os eventos do Visualizador de mídia dinâmica e seus argumentos suportados:
Nome do evento do visualizador Referência do argumento
COMMON %event.detail.dm.objID%
%event.detail.dm.compClass%
%event.detail.dm.instName%
%event.detail.dm.timeStamp%
BANNER %event.detail.dm.BANNER.asset%
%event.detail.dm.BANNER.frame%
%event.detail.dm.BANNER.label%
HREF %event.detail.dm.HREF.rollover%
ITEM %event.detail.dm.ITEM.rollover%
LOAD %event.detail.dm.LOAD.applicationname%
%event.detail.dm.LOAD.asset%
%event.detail.dm.LOAD.company%
%event.detail.dm.LOAD.sdkversion%
%event.detail.dm.LOAD.viewertype%
%event.detail.dm.LOAD.viewerversion%
METADATA %event.detail.dm.METADATA.length%
%event.detail.dm.METADATA.type%
MILESTONE %event.detail.dm.MILESTONE.milestone%
PAGE %event.detail.dm.PAGE.frame%
%event.detail.dm.PAGE.label%
PAUSE %event.detail.dm.PAUSE.timestamp%
PLAY %event.detail.dm.PLAY.timestamp%
SPIN %event.detail.dm.SPIN.framenumber%
STOP %event.detail.dm.STOP.timestamp%
SWAP %event.detail.dm.SWAP.asset%
SWATCH %event.detail.dm.SWATCH.frame%
%event.detail.dm.SWATCH.label%
TARG %event.detail.dm.TARG.frame%
%event.detail.dm.TARG.label%
ZOOM %event.detail.dm.ZOOM.scale%

Configuração de todas as peças de integração

ANTES DE COMEÇAR
Se você ainda não fez isso, a Adobe recomenda que você analise toda a documentação antes desta seção para entender a integração completa.
Esta seção explica as etapas de configuração necessárias para integrar os visualizadores de Dynamic Media ao Adobe Analytics e ao Adobe Analytics para áudio e vídeo. Embora seja possível usar a extensão do visualizador de mídia dinâmica para outros fins no Adobe Launch, esses cenários não são abordados nesta documentação.
Você configurará a integração nos seguintes produtos da Adobe:
  • Adobe Analytics - você configurará as variáveis de rastreamento e os relatórios.
  • Adobe Launch - você definirá uma Propriedade, uma ou mais Regras e um ou mais Elementos de dados para permitir o rastreamento do visualizador.
Além disso, se essa solução de integração for usada com o AEM Sites, a seguinte configuração também precisará ser feita:
  • Console de E/S da Adobe - a integração é criada para o Adobe Launch.
  • Nó de autor de AEM - Configuração de IMS e configuração da nuvem do Adobe Launch.
Como parte da configuração, verifique se você tem acesso a uma empresa na Adobe Experience Cloud que já tenha o Adobe Analytics e o Adobe Launch habilitados.

Configuração do Adobe Analytics para integração

Após configurar o Adobe Analytics, as seguintes configurações serão configuradas para a integração:
  • Um Conjunto de relatórios está no lugar e selecionado.
  • As Variáveis do Analytics estão disponíveis para receber dados de rastreamento.
  • Os relatórios estão disponíveis para exibir dados coletados dentro do Adobe Analytics.
Consulte também Guia de implementação do Analytics.
Para configurar o Adobe Analytics para integração :
  1. Comece acessando o Adobe Analytics na página inicial da Experience Cloud. Na barra de menus, clique no ícone Soluções (uma tabela de três por três pontos) próximo ao canto superior direito da página e clique em Analytics .
    Agora você selecionará um conjunto de relatórios.

Selecionar um conjunto de relatórios

  1. Próximo ao canto superior direito da página do Adobe Analytics, à direita do campo Relatórios de pesquisa, selecione o conjunto de relatórios correto na lista suspensa. Se houver vários conjuntos de relatórios disponíveis e você não tiver certeza de qual usar, entre em contato com o administrador do Adobe Analytics que pode ajudá-lo a selecionar qual conjunto de relatórios usar.
    Na ilustração abaixo, um usuário criou um conjunto de relatórios chamado DynamicMediaViewersExtensionDoc e o selecionou na lista suspensa. O nome do conjunto de relatórios é apenas para fins ilustrativos; o nome do conjunto de relatórios selecionado será diferente.
    Se nenhum conjunto de relatórios estiver disponível, você ou o administrador do Adobe Analytics deverá criar um antes de continuar com a configuração.
    Consulte Relatórios e conjuntos de relatórios e Criar um conjunto de relatórios.
    No Adobe Analytics, os conjuntos de relatórios são gerenciados em Admin > Conjuntos de relatórios.
    Agora você configurará as variáveis do Adobe Analytics.

Configuração de variáveis do Adobe Analytics

  1. Agora você designará uma ou mais variáveis do Adobe Analytics que deseja usar para rastrear o comportamento dos Visualizadores de mídia dinâmica na página da Web.
    É possível usar qualquer tipo de variável compatível com o Adobe Analytics. A decisão sobre o tipo de variável (como #de Tráfego personalizado, #de conversão) deve ser orientada por necessidades específicas da implementação do Analytics.
    Para os fins desta documentação, somente uma variável de Tráfego personalizado (props) será usada porque eles se tornam disponíveis em um Relatório do Analytics em poucos minutos após uma ação ocorrer em uma página da Web.
    Para ativar uma nova variável de Tráfego personalizado, no Adobe Analytics, na barra de ferramentas, clique em Admin > Report Suites .
  2. Na página Gerenciador do conjunto de relatórios, selecione o relatório correto e, na barra de ferramentas, clique em Editar configurações > Tráfego > Variáveis de tráfego.
  3. Ali, selecione a variável não utilizada, dê a ela um nome descritivo ( ativo do visualizador (prop 30) ) e altere a caixa de combinação para "Ativado" na coluna Ativado.
    A captura de tela a seguir é um exemplo de uma variável de Tráfego personalizado ( prop30 ) para rastrear um nome de ativo usado pelo visualizador:
  4. Na parte inferior da lista de variáveis, clique em Salvar .

Configuração de um relatório

  1. Geralmente, a configuração de um Relatório no Adobe Analytics é orientada por necessidades específicas do projeto. Dessa forma, a configuração detalhada do relatório está além do escopo dessa integração.
    No entanto, basta saber que os relatórios de Tráfego personalizado ficam automaticamente disponíveis no Adobe Analytics depois de configurar as variáveis de Tráfego personalizado na configuração das variáveis ​do Adobe Analytics.
    Por exemplo, a variável de relatório do ativo Viewer (prop 30) está disponível no menu Relatórios em Tráfego personalizado > Tráfego personalizado 21-30 > Ativo do visualizador (prop 30) .
    Visitar este relatório logo após a criação do ativo do Visualizador (prop 30) , não mostra dados; que se espera neste momento da integração.

Configuração do Adobe Launch para integração

Depois de configurar o Adobe Launch, será configurado o seguinte para a integração:
  • A criação de uma nova propriedade para manter todas as configurações juntas.
  • A instalação e configuração de extensões. O código do cliente de todas as extensões instaladas na Propriedade é compilado em conjunto em uma biblioteca. Esta biblioteca é usada pela página da Web mais tarde.
  • Configuração de elementos de dados e regras. Essa configuração define quais dados devem ser capturados nos visualizadores do Dynamic Media, quando acionar a lógica de rastreamento e onde enviar os dados do visualizador no Adobe Analytics.
  • Publicação da biblioteca.
Para configurar o Adobe Launch para integração :
  1. Comece acessando o Adobe Launch na página inicial da Experience Cloud. Na barra de menus, clique no ícone Soluções (três por três tabelas de pontos) próximo ao canto superior direito da página e clique em Iniciar .

Criação de uma propriedade no Adobe Launch

Uma propriedade no Adobe Launch é uma configuração nomeada que mantém todas as configurações juntas. Uma biblioteca das configurações é gerada e publicada em diferentes níveis de ambiente (desenvolvimento, armazenamento temporário e produção).
Consulte também Criar uma propriedade .
  1. No Adobe Launch, clique em Nova propriedade .
  2. Na caixa de diálogo Criar propriedade , no campo Nome , digite um nome descritivo, como o título do site. Por exemplo, DynamicMediaViewersProp.
  3. No campo Domínios , insira o domínio do site.
  4. Na lista suspensa Opções ​avançadas, ative Configurar para desenvolvimento de extensão (não pode ser modificado posteriormente) caso a extensão que você deseja usar - neste caso, Visualizadores de mídia dinâmica - ainda não tenha sido lançada.
  5. Clique em Salvar .
    Clique na propriedade recém-criada e prossiga para Instalação e configuração de extensões .

Instalação e configuração de extensões

Todas as extensões disponíveis no Adobe Launch são listadas em Extensões > Catálogo .
Para instalar uma extensão, clique em Instalar . Se necessário, execute uma configuração de extensão única e clique em Salvar .
Quando necessário, as seguintes extensões devem ser instaladas e configuradas:
  • (Obrigatório) Extensão do serviço ** da Experience Cloud ID
Nenhuma configuração adicional é necessária, aceitar para quaisquer valores propostos. Quando terminar, clique em Salvar .
Consulte Extensão do serviço da Experience Cloud ID.
  • (Obrigatório) Extensão do Adobe Analytics
Para configurar essa extensão, primeiro será necessário a ID do conjunto de relatórios encontrada no Adobe Analytics, em Admin > Conjunto de relatórios, no cabeçalho da coluna ID do conjunto de relatórios.
(Somente para fins de demonstração, a ID do Conjunto de relatórios do Conjunto de relatórios DynamicMediaViewersExtensionDoc será usada nas seguintes capturas de tela. Esta ID foi criada e usada em Selecionar um conjunto de relatórios anteriormente.)
Na página Instalar extensão, digite a ID do conjunto de relatórios no campo Report Suites de desenvolvimento, no campo Report Suites de armazenamento temporário e no campo Report Suites de produção.
Configure o seguinte item somente se você planeja usar o rastreamento de vídeo:
Na página Instalar extensão , expanda Geral e especifique o Servidor de rastreamento. O Servidor de rastreamento segue o modelo <trackingNamespace>.sc.omtrdc.net , onde <trackingNamespace> estão as informações obtidas no email de provisionamento.
Clique em Salvar .
  • (Opcional. Obrigatório somente se o rastreamento de vídeo for necessário) Adobe Media Analytics para extensão de áudio e vídeo
Preencha o campo do servidor de rastreamento. O servidor de rastreamento da extensão Adobe Media Analytics para áudio e vídeo é diferente do servidor de rastreamento usado no Adobe Analytics. Ele segue o modelo <trackingNamespace>.hb.omtrdc.net , onde <trackingNamespace> estão as informações do email de provisionamento.
Todos os outros campos são opcionais.
  • (Obrigatório) Extensão de visualizadores ** de mídia dinâmica
Selecione ativar o Adobe Analytics para Vídeo para ativar (ativar) o rastreamento do Video Heartbeat.
Observe que, no momento desta gravação, a extensão do Dynamic Media Viewers só estará disponível se a Propriedade do Adobe Launch for criada para desenvolvimento.
Depois que as extensões forem instaladas e configuradas, no mínimo, as cinco extensões a seguir (quatro se você não estiver acompanhando o vídeo) serão listadas na área Extensões > Instaladas.

Configuração de elementos de dados e regras

No Adobe Launch, crie Elementos de dados e regras necessários para rastrear visualizadores de Mídia dinâmica.
Consulte Como o rastreamento de dados e eventos funciona na integração para obter uma visão geral do rastreamento com o Adobe Launch.
Consulte Configuração de amostra para obter uma configuração de amostra no Adobe Launch que demonstra como rastrear um nome de ativo no carregamento do visualizador.
Consulte Configuração da extensão do visualizador de mídia dinâmica para obter informações detalhadas sobre os recursos da extensão.

Publicar uma biblioteca

Para fazer alterações na configuração do Adobe Launch (incluindo Propriedade, Extensões, Regras e Elementos de dados configurados), é necessário publicar essas alterações. A publicação no Adobe Launch é realizada na guia Publicação, na configuração Propriedade.
O Adobe Launch pode ter vários ambientes de desenvolvimento, um ambiente de preparo e um ambiente de produção. Por padrão, a Configuração da Adobe Launch Cloud no AEM aponta o nó do autor do AEM para o ambiente Stage do Adobe Launch e o nó de publicação do AEM para o ambiente de produção do Adobe Launch. Essa disposição significa que, com as configurações padrão do AEM, é necessário publicar a biblioteca do Adobe Launch no ambiente de preparo para utilizá-la no autor do AEM e publicá-la no ambiente de produção para que possa ser usada na publicação do AEM.
Consulte Ambientes para obter mais informações sobre os ambientes do Adobe Launch.
A publicação de uma biblioteca envolve as duas etapas a seguir:
  • Adicionar e criar uma nova biblioteca incluindo todas as alterações necessárias (novas e atualizações) na biblioteca.
  • Movimentação da biblioteca pelos diferentes níveis de ambiente (de Desenvolvimento a Preparação e Produção)

Adicionar e criar uma nova biblioteca

  1. Na primeira vez que você abrir a guia Publicação no Adobe Launch, a lista da biblioteca estará vazia.
    Na coluna esquerda, clique em Adicionar nova biblioteca .
  2. Na página Criar nova biblioteca, no campo Nome , digite o nome descritivo da nova biblioteca. Por exemplo,
    DynamicMediaViewersLib
    Na lista suspensa Ambiente, escolha o nível Ambiente. Inicialmente, apenas o nível de Desenvolvimento está disponível para seleção. Ao lado esquerdo inferior da página, clique em Adicionar todos os recursos alterados.
  3. Perto do canto superior direito da página, clique em Salvar e construir para desenvolvimento .
    Em poucos minutos a biblioteca é criada e pronta para ser usada.
    Na próxima vez que você fizer alterações na configuração do Adobe Launch, vá para a guia Publicação na configuração Propriedade e clique na biblioteca criada anteriormente.
    Na tela de publicação da biblioteca, clique em Adicionar todos os recursos alterados e, em seguida, clique em Salvar e construir para desenvolvimento .

Como mover uma biblioteca para cima pelos níveis de ambiente

  1. Depois que uma nova biblioteca é adicionada, ela está localizada inicialmente no ambiente de Desenvolvimento. Para movê-lo para o nível do ambiente de preparo (que corresponde à coluna Enviado), no menu suspenso da biblioteca, clique em Enviar para aprovação .
  2. Na caixa de diálogo de confirmação, clique em Enviar .
    Depois que a biblioteca for movida para a coluna Enviado, no menu suspenso da biblioteca, clique em Criar para armazenamento temporário .
  3. Siga um processo semelhante para mover a biblioteca do ambiente de preparo para o ambiente de produção (que é a coluna Publicado).
    Primeiro, no menu suspenso, clique em Aprovar para publicação .
  4. No menu suspenso, clique em Criar e publicar na produção .
    Consulte Publicação para obter mais informações sobre o processo de publicação no Adobe Launch.

Configuração do Adobe Experience Manager para integração

Pré-requisitos:
  • O AEM executa instâncias de autor e publicação.
  • O nó do autor do AEM está configurado no Dynamic Media.
  • Os componentes do Dynamic Media WCM estão habilitados no AEM Sites.
A configuração do AEM consiste nas duas etapas principais a seguir:
  • Configuração do AEM IMS.
  • Configuração da Adobe Launch Cloud.

Configuração do AEM IMS

  1. No autor de AEM, clique no ícone Ferramentas (martelo) e em Segurança > Configurações do Adobe IMS.
  2. Na página Configuração do Adobe IMC, ao lado do canto superior esquerdo, clique em Criar .
  3. Na página Configuração técnica de conta do Adobe IMS, na lista suspensa Solução da Cloud, clique em Adobe Launch .
  4. Ative Criar novo certificado e, no campo de texto, digite qualquer valor significativo para o seu certificado. Por exemplo, AdobeLaunchIMSCert . Clique em Criar certificado .
    A seguinte mensagem de informações é exibida:
    Para recuperar um token de acesso válido, a chave pública do novo certificado deve ser adicionada à conta técnica no Adobe I/O! .
    Click OK to dismiss the Info dialog box.
  5. Clique em Baixar chave pública para baixar um arquivo de chave pública ( *.crt ) para o seu sistema local.
    Nesse ponto, deixe aberta a página Configuração da conta técnica Adobe IMS; não feche a página e não clique em Avançar. Você retornará a esta página mais tarde nas etapas.
  6. Em uma nova guia do navegador, navegue até o Console de E/S da Adobe.
  7. Na página Integrações do console de E/S da Adobe, perto do canto superior direito, clique em Nova integração .
  8. Na caixa de diálogo Criar uma nova integração , verifique se o botão de opção Acessar uma API está selecionado e clique em Continuar .
  9. Na segunda página Criar uma nova integração , ative (ative) o botão de opção API de inicialização da plataforma Experience Platform Launch. No canto inferior direito da página, clique em Continuar .
  10. Na terceira página Criar uma nova integração , faça o seguinte:
    • No campo Nome , digite o nome descritivo. Por exemplo, DynamicMediaViewersIO .
    • No campo Descrição , insira a descrição para a integração.
    • Na área Certificados de chave pública, carregue seu arquivo de chave pública ( *.crt ) que você baixou anteriormente nessas etapas.
    • No cabeçalho Selecionar uma função para API de lançamento da plataforma Experience, selecione Administrador .
    • Em Selecionar um ou mais perfis de produto para a API de lançamento da Experience Platform, selecione o perfil de produto chamado Launch - &lt;nome_da_empresa> .
  11. Clique em Criar integração .
  12. Na página Integração criada , clique em Continuar para obter os detalhes da integração.
  13. Uma página de detalhes de Integrações é exibida, semelhante ao seguinte:
    Deixe em aberto esta página de detalhes da integração. Você precisará de várias informações nas guias Visão geral e JWT em apenas um momento.
    Página de detalhes da integração
  14. Retorne à página Configuração técnica de conta do Adobe IMS que você deixou aberta anteriormente. No canto superior direito da página, clique em Avançar para abrir a página Conta na janela Configuração de conta técnica do Adobe IMS.
    (Se você tiver fechado a página acidentalmente antes, volte para o autor de AEM e clique em Ferramentas > Segurança > Configurações do Adobe IMS. Clique em Criar . Na lista suspensa Solução da Cloud, selecione Adobe Launch . Na lista suspensa Certificado , selecione o nome do certificado criado anteriormente.
    Configuração técnica de conta do Adobe IMS - página Certificado
  15. A página Conta tem cinco campos que exigirão que você preencha usando as informações da página Detalhes da integração da etapa anterior.
    Configuração técnica de conta do Adobe IMS - página Conta
  16. Na página Conta , preencha os seguintes campos:
    • Título - Informe um título descritivo da conta.
    • Servidor de autorização - Retorne à página de detalhes da integração aberta anteriormente. Click the JWT tab. Copie o nome do servidor, sem o caminho, conforme destacado abaixo.
    Retorne à página Conta e cole o nome no campo respectivo. Por exemplo, https://ims-na1.adobelogin.com/ (o nome do servidor de exemplo é apenas para fins ilustrativos)
    Página de detalhes da integração - guia JWT
  17. Chave da API - Retorne à página de detalhes da integração. Clique na guia Visão geral e, à direita do campo Chave API (ID do cliente) , clique em Copiar .
    Retorne à página Conta e cole a chave no campo respectivo.
    Página de detalhes da integração
  18. Segredo do cliente - Retorne à página de detalhes da integração. Na guia Visão geral , clique em Recuperar segredo do cliente. À direita do campo Segredo do cliente, clique em Copiar .
    Retorne à página Conta e cole a chave no campo respectivo.
  19. Carga - Retorne à página de detalhes da Integração. Na guia JWT , no campo Carga JWT, copie todo o código do objeto JSON.
    Retorne à página Conta e cole o código no respectivo campo.
    Página de detalhes da integração - guia JWT
    A página Conta, com todos os campos preenchidos, será semelhante ao seguinte:
  20. Ao lado do canto superior direito da página Conta , clique em Criar .
    Com o AEM IMS configurado, agora você tem uma nova conta IMSA listada em Configurações do Adobe IMS.

Configuração da Adobe Launch Cloud para integração

  1. No autor de AEM, próximo ao canto superior esquerdo, clique no ícone Ferramentas (martelo) e, em seguida, clique em Serviços em nuvem > Configurações do Adobe Launch.
  2. Na página Configurações do Adobe Launch, no painel esquerdo, selecione um site do AEM para o qual você deseja aplicar sua Configuração do Adobe Launch.
    Somente para fins de ilustração, o Site We.Retail é selecionado na captura de tela abaixo.
  3. Ao lado do canto superior esquerdo da página, clique em Criar .
  4. Na página Geral (1/3 páginas) da janela Criar configuração do Adobe Launch, preencha os seguintes campos:
    • Título - Insira um título de configuração descritiva. Por exemplo, We.Retail Launch cloud configuration .
    • Configuração associada do Adobe IMS - selecione a configuração do IMS criada anteriormente em Configuração do AEM IMS .
    • Empresa - Na lista suspensa Empresa , selecione sua empresa da Experience Cloud. A lista é preenchida automaticamente.
    • Propriedade - Na lista suspensa Propriedade, selecione a propriedade do Adobe Launch criada anteriormente. A lista é preenchida automaticamente.
    Depois de preencher todos os campos, sua página Geral será semelhante ao seguinte:
  5. Próximo ao canto superior esquerdo, clique em Avançar .
  6. Na página Preparo (2/3 páginas) da janela Criar configuração do Adobe Launch, preencha o seguinte campo:
    No campo URI da biblioteca, verifique o local da versão de preparo da biblioteca do Adobe Launch. O AEM preenche este campo automaticamente.
    Somente para fins de ilustração, esta etapa usará as bibliotecas do Adobe Launch implantadas no Adobe CDN.
    Verifique se o URI da biblioteca preenchido automaticamente (Uniform Resource Identifier) não está malformado. Se necessário, corrija-o para que o URI represente um URI relativo ao protocolo. Isto é, começa com uma barra dupla.
    Por exemplo: //assets.adobetm.com/launch-xxxx .
    Sua página de preparo deve ser semelhante ao seguinte. Observe que as opções Arquivar e Carregar biblioteca assíncronas não estão definidas:
  7. Perto do canto superior direito, clique em Avançar .
  8. Na página Produção (3/3 páginas) da janela Criar configuração do Adobe Launch, se necessário, corrija o URI de produção preenchido automaticamente de modo semelhante ao que foi feito na página Staging anterior.
  9. Perto do canto superior direito, clique em Criar .
    Sua nova Configuração da Adobe Launch Cloud agora é criada e listada ao lado do site.
  10. Selecione a nova Configuração da Adobe Launch Cloud (uma marca de seleção é exibida à esquerda do título da configuração quando ela é selecionada). Na barra de ferramentas, clique em Publicar .
Atualmente, o autor do AEM não oferece suporte à integração de visualizadores de mídia dinâmica com o Adobe Launch.
No entanto, ele é suportado no nó de publicação do AEM. Usando as configurações padrão da Configuração da Adobe Launch Cloud, a publicação do AEM usa o ambiente de produção do Adobe Launch. Dessa forma, é necessário enviar as atualizações da biblioteca do Adobe Launch do Desenvolvimento para o ambiente de produção sempre durante o teste.
É possível contornar essa limitação especificando o URL de desenvolvimento ou armazenamento temporário da biblioteca do Adobe Launch na configuração da Adobe Launch Cloud para publicação do AEM acima. Isso faz com que o nó de publicação do AEM use a versão de Desenvolvimento ou Preparação da biblioteca do Adobe Launch.
Consulte Integrar o AEM ao Adobe Launch via E/S da Adobe para obter mais informações sobre como configurar a Configuração da Adobe Launch Cloud.