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

O que é a integração dos visualizadores Dynamic Media com o Adobe Analytics e o Adobe Launch?

A nova extensão Dynamic Media Viewers para o Adobe Launch, juntamente com a versão recente do Dynamic Media Viewers 5.13, permite que os clientes do Dynamic Media, Adobe Analytics e Adobe Launch usem eventos e dados específicos para os Dynamic Media Viewers em suas configurações de Adobe Launch.

Essa integração significa que você pode rastrear o uso de visualizadores do Dynamic Media no seu site com a Adobe Analytics. Ao mesmo tempo, você pode usar os eventos e os dados expostos pelos visualizadores com qualquer outra extensão do Launch que venha do Adobe ou de terceiros.

Consulte extensões do Adobe 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 Adobe Launch para visualizadores Dynamic Media não funciona no nó do autor 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 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 a integração do Analytics de visualizadores herdados (por meio do parâmetro config2=).
  • 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 da Duração do armazenamento para Elementos de dados não é compatível com Elementos de dados que usam a extensão Dynamic Media Viewers. A Duração do armazenamento deve ser definida como Nenhum.

Casos de uso para a integração

O principal caso de uso para a integração com o Adobe Launch são os clientes que usam o AEM Assets e o AEM Sites. Nesses cenários, você pode configurar uma integração padrão entre o nó do autor AEM e o Adobe Launch e associar a instância Sites à propriedade Adobe Launch. Depois disso, qualquer componente Dynamic Media WCM adicionado a uma página Sites rastreará os dados e eventos dos visualizadores.

Consulte Sobre o rastreamento de visualizadores Dynamic Media no AEM Sites.

Um caso de uso secundário suportado pela integração são os clientes que usam somente o AEM Assets ou o Dynamic Media Classic. Nesses casos, você obtém o código incorporado para seu visualizador e o adiciona à página do site. Em seguida, obtenha o URL de produção da biblioteca de inicialização de Adobe do Adobe Launch e adicione-o manualmente ao código da página da Web.

Consulte Sobre o rastreamento de visualizadores Dynamic Media usando o código incorporado.

Como o rastreamento de dados e eventos funciona na integração

A integração aproveita dois tipos separados e independentes de rastreamento de visualizadores do Dynamic Media: Adobe Analytics e Adobe Analytics para Áudio e Vídeo.

Sobre o rastreamento usando o Adobe Analytics

A Adobe Analytics permite que você rastreie ações executadas pelo usuário final quando interagem com os visualizadores do Dynamic Media em seu site. A Adobe Analytics também permite rastrear dados específicos do visualizador. Por exemplo, você pode rastrear e gravar eventos de carregamento de visualizaçã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 ativar o rastreamento do Adobe Analytics.

Sobre elementos de dados na inicialização do Adobe

Um elemento de dados na inicialização do Adobe é uma propriedade nomeada cujo valor é definido estaticamente ou calculado dinamicamente com base no estado de uma página da Web ou nos dados do Dynamic Media Viewers.

As opções disponíveis para uma definição de Elemento de dados dependem da lista de Extensões instaladas na Propriedade 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 query e muitas outras fontes.

Para o Adobe Analytics tracking, é necessário instalar várias extensões adicionais, conforme descrito em Instalação e configuração de extensões. A extensão Visualizadores do Dynamic Media adiciona uma capacidade de definir um Elemento de dados cujo valor é um argumento do evento 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 Dynamic Media Viewer 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 do seletor de elementos de dados. Especificamente, os Elementos de dados definidos para fins de rastreamento de visualizadores do Dynamic Media 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:

  • Eventos (se) avisam 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 de inicialização do Adobe. 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 dos visualizadores do Dynamic Media estende a lista dos Eventos suportados para eventos específicos dos visualizadores Dynamic Media, 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 suportadas com duas ações necessárias para enviar dados para servidores de rastreamento: Defina variáveis e Enviar beacon.

Para rastrear visualizadores Dynamic Media, é possível usar qualquer tipo de:

  • Eventos da extensão do Dynamic Media Viewers, da extensão Core ou de qualquer outra extensão.
  • 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. Esta ação informa a 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 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 na inicialização de Adobe demonstra como rastrear um nome de ativo na carga do visualizador.

  1. Na guia Elementos de dados, defina um elemento de dados AssetName que faça referência ao parâmetro asset do evento LOAD da extensão Dynamic Media Viewers.

    image2019-11

  2. Na guia Regras, defina uma regra TrackAssetOnLoad.

    Nesta regra, o campo Evento usa o evento LOAD da extensão de Visualizadores Dynamic Media.

    image2019-22

  3. A configuração Ação tem dois tipos de Ação da extensão 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 a Adobe Analytics.

    image2019-3

  4. A configuração de regra resultante é semelhante ao seguinte:

    image2019-4

Sobre o Adobe Analytics para áudio e vídeo

Quando uma conta de Experience Cloud é assinada para usar o Adobe Analytics para Áudio e Vídeo, é suficiente ativar o rastreamento de vídeo nas configurações de extensão 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 Adobe Media Analytics para áudio e vídeo.

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

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 do Dynamic Media Viewers

Conforme mencionado em Casos de uso da integração, é possível rastrear visualizadores Dynamic Media com a nova integração do Adobe Launch no AEM Sites e usando o código incorporado.

Rastrear visualizadores do Dynamic Media no AEM Sites

Para rastrear visualizadores Dynamic Media no AEM Sites, todas as etapas listadas na seção Configurar todas as partes de integração devem ser executadas. Especificamente, você deve criar a configuração IMS e a configuração da Adobe Launch Cloud.

Após a configuração correta, qualquer visualizador do Dynamic Media que você adicionar a uma página Sites, usando um componente WCM suportado pela Dynamic Media, rastreia automaticamente os dados para o Adobe Analytics ou Adobe Analytics para Vídeo, ou ambos.

Consulte Adicionar ativos Dynamic Media a páginas usando Adobe Sites.

Rastreamento de visualizadores Dynamic Media usando o código incorporado

Os clientes que não usam o AEM Sites ou incorporam visualizadores do Dynamic Media em páginas da Web fora do AEM Sites, ou ambos, ainda podem usar a integração do Adobe Launch.

Conclua as etapas de configuração nas 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 do Dynamic Media.

Consulte Adicionar o código incorporado Iniciar para saber mais sobre como usar o código incorporado da biblioteca de inicialização de Adobe.

Consulte Incorporar o Visualizador de vídeo ou imagem em uma página da Web para saber mais sobre como usar o recurso de código incorporado AEM Dynamic Media.

Para rastrear visualizadores Dynamic Media usando código incorporado

  1. Tenha uma página da Web pronta para incorporar um visualizador do Dynamic Media.
  2. Obtenha o código incorporado para a biblioteca Adobe Launch fazendo logon primeiro no Adobe Launch (consulte Configuração do Adobe Launch).
  3. Clique em Propriedade e 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 da biblioteca de inicialização de Adobe, juntamente com as <script/> tags ao redor.

Guia de referência para a extensão do Dynamic Media Viewers

Sobre a configuração dos visualizadores do Dynamic Media

A extensão do Dynamic Media Viewer se integra automaticamente à biblioteca de Adobe Launch se todas as condições abaixo forem verdadeiras:

  • O objeto global da biblioteca de inicialização de Adobe ( _satellite) está presente na página.

  • A função de extensão do Dynamic Media Viewers _dmviewers_v001() está 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 parâmetro launch=0 na configuração do visualizador. O valor padrão desse parâmetro é 1.

Configuração da extensão do Dynamic Media Viewers

A única opção de configuração para a extensão de visualizadores Dynamic Media é Ativar o Adobe Media Analytics para Áudio e Vídeo.

Ao marcar (ativar ou "ativar") essa opção e se a extensão do Adobe Media Analytics para áudio e vídeo estiver 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 da 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.

image2019-7-22_12-4-23

Sobre elementos de dados na extensãodo Dynamic Media Viewers

O único tipo de Elemento de dados fornecido pela extensão Visualizadores do Dynamic Media é 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 do Dynamic Media que têm argumentos, além de um item COMMON 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 visualizador do Dynamic Media selecionado.

image2019-7-22_12-5-46

Consulte o Guia de referência do Visualizador do Dynamic Media 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 do Dynamic Media não apresenta argumentos de evento de documento.

Vamos agora considerar o ciclo de vida dos Visualizadores do Dynamic Media Elemento de dados. O valor desse Elemento de dados é preenchido depois que o evento do visualizador do Dynamic Media correspondente acontece 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 "scale", 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 definido na configuração Regra. Por exemplo, se ZoomScale do elemento de dados for definido como 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 o preencheu. 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 do Dynamic Media, 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 de inicialização de Adobe, o valor do Elemento de dados será o valor do visualizador que foi o último a atualizar esse 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 ZoomScaleData aponta para o evento ​ZOOM e seu argumento "scale".

  • ​TrackPanRule com o seguinte:

    • Usa o evento do Dynamic Media Viewer PAN como disparador.
    • Envia o valor de ZoomScale Elemento de dados para a Adobe Analytics.
  • ​TrackKeyRule com o seguinte:

    • Usa o evento key press da extensão Core Adobe Launch como disparador.
    • Envia o valor de ZoomScale Elemento de dados para a Adobe Analytics.

Agora, suponha que o usuário final carregue a página da Web com os dois visualizadores. Em viewer1, eles aumentam o zoom para 50% de escala; em seguida, em viewer2, aumentam o zoom para 25% da escala. Em viewer1, 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 para a Adobe Analytics:

  • A primeira chamada ocorre porque a regra TrackPan é acionada quando o usuário entra em viewer1. Essa chamada envia 50% como um valor de ZoomScale Elemento de dados porque o Elemento de dados saberá que a Regra é acionada por viewer1 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 de ZoomScale Elemento de dados 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 Dynamic Media Viewer é armazenado no código da biblioteca de inicialização do Adobe 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 Dynamic Media Viewer 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 acionados pelos Visualizadores do Dynamic Media não são armazenados no armazenamento local ou no servidor; em vez disso, eles são mantidos somente na biblioteca de inicialização de Adobe 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 a seleção da duração do armazenamento. Entretanto, os Elementos de dados que usam a extensão de Visualizadores do Dynamic Media suportam apenas a opção de duração do 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 do evento do visualizador durante todo o ciclo de vida do visualizador.

Sobre as regras na extensão do Dynamic Media Viewers

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 do Dynamic Media adiciona um novo Tipo de evento chamado Evento do visualizador.

Quando selecionado, o editor de Eventos renderiza o menu suspenso eventos do Dynamic Media Viewer, listando todos os eventos disponíveis que são suportados pelos visualizadores Dynamic Media.

image2019-8-2_15-13-1

Sobre o editor de Ações

A extensão Visualizadores do Dynamic Media permite que você use parâmetros de evento de visualizadores do Dynamic Media para mapear as 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 Dynamic Media Viewer.
  • 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.

image2019-7-10_20-41-52

No entanto, é possível usar uma abordagem alternativa e ignorar a criação do Elemento de dados. Faça referência direta a um argumento de um evento do Visualizador do Dynamic Media ao digitar o nome totalmente qualificado do argumento de evento no campo de entrada valor da atribuição de variável do Analytics, com sinais de porcentagem (%) de ambos os lados. Por exemplo,

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

Observe que há uma diferença importante entre o uso de Elementos de dados e a referência do 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 do evento que ela menciona.

Por exemplo, a referência %event.detail.dm.LOAD.asset% retornará o nome correto do ativo se Regra for acionado pelo evento LOAD da extensão do Visualizador do Dynamic Media. No entanto, retorna um valor vazio para qualquer outro evento.

A tabela a seguir lista eventos do Dynamic Media Viewer 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%

Configurar todas as partes de integração

ANTES DE COMEÇAR

Caso ainda não o tenha feito, o 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 Dynamic Media ao Adobe Analytics e Adobe Analytics para áudio e vídeo. Embora seja possível usar a extensão Dynamic Media Viewers para outros fins na inicialização do Adobe, esses cenários não são abordados nesta documentação.

Você configurará a integração nos seguintes produtos de 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 ativar o rastreamento do visualizador.

Além disso, se essa solução de integração for usada com a AEM Sites, a seguinte configuração também precisará ser feita:

  • Adobe I/O Console - a integração é criada para o Adobe Launch.
  • AEM nó do autor - configuração IMS e configuração da nuvem Adobe Launch.

Como parte da configuração, verifique se você tem acesso a uma empresa no Adobe Experience Cloud que já tenha o Adobe Analytics e o Adobe Launch habilitados.

Configuração da Adobe Analytics para a integração

Depois de configurar o Adobe Analytics, o seguinte será configurado 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 visualização de dados coletados dentro do Adobe Analytics.

Consulte também Guia de implementação do Analytics.

Para configurar o Adobe Analytics para integração:

  1. Start acessando o Adobe Analytics a partir do Experience Cloud home page. 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, em seguida, clique em Analytics.

    2019-07-22_18-08-47

    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 Pesquisar relatórios, 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 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 da Adobe Analytics devem criar um antes de prosseguir 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.

    2019-07-22_18-09-49

    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 do Dynamic Media na página da Web.

    É possível usar qualquer tipo de variável suportada pela Adobe Analytics. A decisão sobre o tipo de variável (como Tráfego personalizado [props], Conversão [eVar]) deve ser orientada por necessidades específicas da implementação do Analytics.

    Consulte Visão geral de props e eVars.

    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 Administrador > 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, atribua 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:

    image2019-6-26_23-6-59

  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 que você configura as variáveis de Tráfego personalizado em Configuração de variáveis do Adobe Analytics.

    Por exemplo, o relatório da variável Ativo do visualizador (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; o que é esperado neste momento da integração.

    image2019-6-26_23-12-49

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

Depois de configurar o Adobe Launch, o seguinte será configurado 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 dos visualizadores do Dynamic Media, quando disparar 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. Start acessando Adobe Launch a partir do Experience Cloud home page. 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, em seguida, clique em Iniciar.

    Você também pode abrir Adobe Launch direct.

    image2019-7-8_15-38-44

Criação de uma propriedade em 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 de inicialização.

  1. Na inicialização do Adobe, 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 do Dynamic Media) ainda não tenha sido lançada.

    image2019-7-8_16-3-47

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

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 Serviço de ID de Experience Cloud

Nenhuma configuração adicional é necessária, aceitar para quaisquer valores propostos. Quando terminar, clique em Salvar.

Consulte Extensão do serviço de ID de Experience Cloud.

  • (Obrigatório) extensão 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.

(Para fins de demonstração, a ID de 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.)

image2019-7-8_16-45-34

Na página Instalar extensão, digite a ID do conjunto de relatórios no campo Conjuntos de relatórios, no campo Conjuntos de relatórios de preparo e no campo Conjuntos de relatórios de produção.

image2019-7-8_16-47-40

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> são as informações obtidas no email de provisionamento.

Clique em Salvar.

Consulte Adobe Analytics Extension.

  • (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 para a extensão Adobe Media Analytics para áudio e vídeo é diferente do servidor de rastreamento usado para Adobe Analytics. Ele segue o modelo <trackingNamespace>.hb.omtrdc.net, onde <trackingNamespace> são as informações do email de provisionamento.

Todos os outros campos são opcionais.

Consulte Adobe Media Analytics para obter mais informações sobre a extensão de áudio e vídeo.

  • (Obrigatório) Visualizadores Dynamic Media extensão

Selecione ativar o Adobe Analytics para Vídeo para habilitar (ativar) o rastreamento do Video Heartbeat.

Observe que — no momento desta gravação — a extensão Dynamic Media Viewers só estará disponível se a Propriedade de inicialização de Adobe for criada para desenvolvimento.

Consulte Criação de uma propriedade em Adobe Launch.

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.

image2019-7-22_12-7-36

Configuração de elementos de dados e regras

Na Adobe Launch, crie elementos de dados e regras que sejam necessários para rastrear visualizadores Dynamic Media.

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 Exemplo de configuração para obter uma amostra de configuração no Adobe Launch que demonstra como rastrear um nome de ativo no carregamento do visualizador.

Consulte Configuração da extensão do Dynamic Media Viewers para obter informações detalhadas sobre os recursos da extensão.

Publicar uma biblioteca

Para fazer alterações na configuração de 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 a partir da 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 AEM para o ambiente Stage do Adobe Launch e o nó de publicação do AEM para o ambiente Production do Adobe Launch. Essa disposição significa que, com as configurações de AEM padrão, é necessário publicar a biblioteca de inicialização de Adobe para o ambiente de preparo, a fim de usá-la AEM autor e publicá-la no ambiente Produção, para que possa ser usada em AEM publicação.

Consulte Ambientes para obter mais informações sobre ambientes de inicialização de Adobe.

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.

    image2019-7-15_14-43-17

  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 do Ambiente. Inicialmente, apenas o Nível de desenvolvimento está disponível para seleção. Próximo ao lado inferior esquerdo da página, clique em Adicionar todos os recursos alterados.

    image2019-7-15_14-49-41

  3. Perto do canto superior direito da página, clique em Salvar e construir para o Desenvolvimento.

    Em poucos minutos a biblioteca é criada e pronta para ser usada.

    image2019-7-15_15-3-34

    OBSERVAÇÃO

    Na próxima vez que fizer alterações na configuração do Adobe Launch, acesse 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.

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.

    image2019-7-15_15-52-37

  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.

    image2019-7-15_15-54-37

  3. Siga um processo semelhante para mover a biblioteca do ambiente de armazenamento temporário para o ambiente de produção (que é a coluna Publicado).

    Primeiro, no menu suspenso, clique em Aprovar para publicação.

    image2019-7-15_16-7-39

  4. No menu suspenso, clique em Criar e publicar na produção.

    image2019-7-15_16-8-9

    Consulte Publicação para obter mais informações sobre o processo de publicação no Adobe Launch.

Configuração da Adobe Experience Manager para a integração

Pré-requisitos:

  • AEM executa as instâncias Autor e Publicar.
  • AEM nó do autor é configurado no Dynamic Media.
  • Os componentes Dynamic Media WCM estão habilitados no AEM Sites.

A configuração AEM consiste nas duas etapas principais a seguir:

  • Configuração do AEM IMS.
  • Configuração da Adobe Launch Cloud.

Configurando AEM IMS

  1. Em AEM autor, clique no ícone Ferramentas (martelo) e, em seguida, clique em Segurança > Configurações de IMS de Adobe.

    2019-07-25_11-52-58

  2. Na página Configuração IMC de Adobe, próximo ao canto superior esquerdo, clique em Criar.

  3. Na página Configuração de conta técnica do Adobe IMS, na lista suspensa Solução da nuvem, clique em Adobe Launch.

  4. Ative Crie um 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!.

    Clique em OK para fechar a caixa de diálogo Informações.

    2019-07-25_12-09-24

  5. Clique em Baixar chave pública para baixar um arquivo de chave pública (*.crt) para o sistema local.

    OBSERVAÇÃO

    Nesse momento, deixe aberta a página Configuração da conta técnica do Adobe IMS; não feche a página e não clique em Avançar. Você retornará posteriormente a esta página nas etapas.

    2019-07-25_12-52-24

  6. Em uma nova guia do navegador, navegue até Console do Adobe I/O.

  7. Na página Integrações do Adobe I/O Console, próximo ao 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.

    2019-07-25_13-04-20

  9. Na segunda página Criar uma nova integração, habilite (ative) o botão de opção API do Experience Platform Launch. No canto inferior direito da página, clique em Continuar.

    2019-07-25_13-13-54

  10. Na terceira página Criar uma nova integração, faça o seguinte:

    • No campo Name, insira o nome descritivo. Por exemplo, DynamicMediaViewersIO.

    • No campo Descrição, insira a descrição da integração.

    • Na área Certificados de chave pública, carregue o arquivo de chave pública (*.crt) que você baixou anteriormente nessas etapas.

    • No cabeçalho Selecione uma função para API de Experience Platform Launch, selecione Admin.

    • No cabeçalho Selecione um ou mais perfis de produto para a API Experience Platform Launch, selecione o perfil de produto chamado Iniciar - <nome_da_empresa>.

    2019-07-25_13-49-18

  11. Clique em Criar integração.

  12. Na página Integração criada, clique em Continuar para os detalhes da integração.

    2019-07-25_14-16-33

  13. Uma página de detalhes de Integrações é exibida, semelhante ao seguinte:

    OBSERVAÇÃO

    Deixe aberta esta página de Detalhes da integração. Você logo precisará de várias informações nas guias Visão geral e JWT.

    2019-07-25_14-35-30
    Página de detalhes da integração

  14. Retorne à página Configuração de conta técnica 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 anterior acidentalmente, volte para o autor do AEM e clique em Ferramentas > Segurança > Configurações do Adobe IMS. Clique em Criar. Na lista suspensa Solução da nuvem, selecione Adobe Launch. Na lista suspensa Certificado, selecione o nome do certificado criado anteriormente.

    2019-07-25_20-57-50
    Configuração de conta técnica Adobe IMS - página Certificado

  15. A página Account tem cinco campos que exigirão que você preencha usando as informações da página de detalhes da integração da etapa anterior.

    2019-07-25_20-42-45
    Configuração de conta técnica 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. Clique na guia JWT. Copie o nome do servidor, sem o caminho, conforme destacado abaixo.

(o nome do servidor de exemplo é apenas para fins ilustrativos) Retorne à página Conta e cole o nome no respectivo campo.
Por exemplo, https://ims-na1.adobelogin.com/
(o nome do servidor de exemplo é apenas para fins ilustrativos)

2019-07-25_15-01-53
Página de detalhes da integração - guia JWT

  1. Chave da API - Retorne à página de detalhes da integração. Clique na guia Visão geral e, à direita do campo Chave da API (ID do cliente), clique em Copiar.

    Retorne à página Conta e cole a chave no respectivo campo.

    2019-07-25_14-35-333
    Página de detalhes da integração

  2. Segredo do cliente - Retorne à página 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 respectivo campo.

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

    2019-07-25_21-59-12
    Página de detalhes da integração - guia JWT

    A página Conta, com todos os campos preenchidos, será semelhante ao seguinte:

    2019-07-25_22-08-30

  4. Perto do canto superior direito da página Conta, clique em Criar.

    Com AEM IMS configurado, agora você tem uma nova IMSAccount listada em Configurações IMS Adobe.

    image2019-7-15_14-17-54

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

  1. Em AEM autor, próximo ao canto superior esquerdo, clique no ícone Ferramentas (martelo) e, em seguida, clique em Cloud Services > Configurações de inicialização de Adobe.

    2019-07-26_12-10-38

  2. Na página Configurações de inicialização de Adobe, no painel esquerdo, selecione um Site AEM para o qual deseja aplicar a Configuração de inicialização de Adobe.

    Somente para fins de ilustração, o Site We.Retail é selecionado na captura de tela abaixo.

    2019-07-26_12-20-06

  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 Adobe IMS associada: selecione a configuração IMS criada anteriormente em Configuração AEM IMS.

    • Empresa - Na lista ​suspensa Empresa, selecione a empresa da Experience Cloud. A lista é preenchida automaticamente.

    • Propriedade - Na lista suspensa Propriedade, selecione a propriedade Adobe Launch criada anteriormente. A lista é preenchida automaticamente.

    Depois de preencher todos os campos, sua página Geral será semelhante ao seguinte:

    image2019-7-15_14-34-23

  5. Próximo ao canto superior esquerdo, clique em Próximo.

  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 esse campo automaticamente.

    Apenas para fins ilustrativos, esta etapa usará bibliotecas de Adobe Launch implantadas no Adobe CDN.

    OBSERVAÇÃO

    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. Ou seja, ele start de uma duplo para a frente.

    Por exemplo: //assets.adobetm.com/launch-xxxx.

    Sua página Preparação deve ser semelhante a seguinte. Observe que as opções Arquivar e Carregar biblioteca de forma assíncrona não estão definidas:

    image2019-7-15_15-21-8

  7. Próximo ao canto superior direito, clique em Próximo.

  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 Preparação anterior.

  9. Próximo ao canto superior direito, clique em Criar.

    Sua nova Configuração da Adobe Launch Cloud agora é criada e listada ao lado do seu site.

  10. Selecione sua nova Adobe para Iniciar a configuração da nuvem (uma marca de seleção é exibida à esquerda do título da configuração quando ela é selecionada). Na barra de ferramentas, clique em Publicar.

    image2019-7-15_15-47-6

Atualmente, AEM autor não suporta a integração de Visualizadores Dynamic Media com o Adobe Launch.

No entanto, ele é suportado no nó de publicação AEM. Usando as configurações padrão da Configuração da Adobe Launch Cloud, AEM publish usa o ambiente de produção da Adobe Launch. Dessa forma, é necessário enviar atualizações da biblioteca de inicialização de Adobe 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 de inicialização do Adobe na configuração da Adobe Launch Cloud para AEM publicação acima. Isso faz com que o nó de publicação AEM use a versão de Desenvolvimento ou Preparação da biblioteca de Adobe Launch.

Consulte Integrar AEM com o Adobe Launch Via Adobe I/O para obter mais informações sobre como configurar a Configuração da Adobe Launch Cloud.

Nesta página