Integrar visualizadores do Dynamic Media com tags Adobe Analytics e Experience Platform

O que é a integração dos visualizadores do Dynamic Media com as tags Adobe Analytics e Experience Platform?

A extensão Dynamic Media Viewersextension for Experience Platform Tags e Dynamic Media Viewers 5.13 permite que os clientes Adobe Analytics e Experience Platform Tags usem eventos e dados específicos para Dynamic Media Viewers na configuração Experience Platform Tags.

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

Para saber mais sobre extensões do Adobe ou extensões de terceiros, consulte Extensões do Adobe no Guia do usuário de Tags do Experience Platform.

Este tópico foi criado para o seguinte: administradores de site, desenvolvedores no Experience Platform e pessoas em Operações.

Limitações da integração

  • A integração de Tags Experience Platform para visualizadores Dynamic Media não funciona no nó de autor do Experience Manager. Não é possível ver nenhum rastreamento de uma página do WCM até que ela seja publicada.
  • A integração de Tags de Experience Platform 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 de Tags de Experience Platform 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 é 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 de 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 None.

Casos de uso da integração

O principal caso de uso da integração com Tags do Experience Platform são os clientes que usam os ativos Adobe Experience Manager e o Adobe Experience Manager Sites. Nesses cenários, você pode configurar uma integração padrão entre o nó Experience Manager author e as Tags do Experience Platform e, em seguida, associar a instância do Sites à propriedade Tags do Experience Platform. Depois disso, qualquer componente WCM do Dynamic Media adicionado a uma página do Sites rastreará os dados e eventos dos visualizadores.

Consulte Rastrear visualizadores Dynamic Media no Experience Manager Sites.

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

Consulte Rastrear 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

O Adobe Analytics permite que você rastreie ações executadas pelo usuário final quando elas interagem com os Visualizadores do Dynamic Media em seu site. O Adobe Analytics também permite rastrear dados específicos do visualizador. Por exemplo, você pode rastrear e registrar eventos de carregamento de exibição junto com o nome do ativo, quaisquer ações de zoom que ocorreram e as ações de reprodução de vídeo.

Em Tags de Experience Platform, os conceitos de Elementos de dados e Regras trabalham juntos para ativar o rastreamento do Adobe Analytics.

Sobre elementos de dados em tags Experience Platform

Um Elemento de dados em Tags Experience Platform é uma propriedade nomeada cujo valor é definido estaticamente ou calculado dinamicamente com base no estado de uma página da Web ou nos dados de Visualizadores do Dynamic Media.

As opções disponíveis para uma definição de Elemento de dados dependem da lista de Extensões instaladas na Propriedade de Tags do Experience Platform. A extensão "Core" é pré-instalada e está disponível para uso imediato em qualquer configuração. Essa extensão "Core" permite definir um Elemento de dados cujo valor provém de cookie, código JavaScript, sequência de consulta e muitas outras fontes.

Para o rastreamento do Adobe Analytics, várias outras extensões devem ser instaladas, 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 que é um argumento do evento Visualizador dinâmico. Por exemplo, é possível fazer referência ao tipo de visualizador ou ao nome do ativo relatado pelo visualizador quando carregado, o nível de zoom relatado quando o usuário final faz zoom e muito mais.

A extensão Visualizador do Dynamic Media mantém os valores de seus Elementos de dados atualizados automaticamente.

Depois de defini-lo, um Elemento de dados pode ser usado em outros locais da interface do usuário de Tags do Experience Platform, usando o widget seletor de elementos de dados. Especificamente, os Elementos de dados definidos para as finalidades do rastreamento de Visualizadores do Dynamic Media são referenciados pela Ação Definir variáveis da extensão Adobe Analytics na Regra (veja abaixo).

Consulte Elementos de dados.

Sobre regras em tags Experience Platform

Uma Regra em Tags de Experience Platform é uma configuração agnóstica que define três áreas que compõem uma regra: Eventos, Condições e Ações:

  • Os eventos (if) informam às Tags de Experience Platform quando acionar uma regra.
  • As condições (if) informam as Tags de Experience Platform que outras restrições serão permitidas ou não durante o acionamento de uma Regra.
  • As ações (em seguida) informam as Tags de Experience Platform sobre 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 Tags do Experience Platform. A extensão Core é pré-instalada e está disponível e pronta para uso em qualquer configuração. A extensão fornece várias opções para Eventos, como ações básicas no nível do navegador. Essas ações incluem mudança de foco, pressionamentos de tecla e envios de formulário. Também inclui opções para Condições, como valor do 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 outras extensões devem ser instaladas, conforme descrito em Instalação e configuração de extensões. Especificamente:

  • A extensão Visualizadores do Dynamic Media estende a lista de Eventos suportados para eventos específicos dos visualizadores do Dynamic Media, como carregamento do visualizador, troca de ativos, zoom e reprodução de vídeo.
  • A extensão Adobe Analytics estende a lista de ações compatíveis com duas ações necessárias para enviar dados para servidores de rastreamento: Definir variáveis e Enviar beacon.

Para rastrear visualizadores do Dynamic Media, é possível usar qualquer tipo de um dos seguintes itens:

  • Eventos da extensão do Dynamic Media Viewers, da extensão principal 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. Essa ação informa 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 Send Beacon envia dados ao servidor de rastreamento de análise. Ambas as ações, Definir variáveis e Enviar beacon, vêm da extensão Adobe Analytics.

Consulte Regras.

Exemplo de configuração

A configuração de exemplo a seguir em Tags de Experience Platform 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 parâmetro asset do evento LOAD da extensão Visualizadores do Dynamic Media.

    image2019-11

  2. Na guia Rules, defina uma regra TrackAssetOnLoad.

    Nesta regra, o campo Event usa o evento LOAD da extensão Visualizadores do 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 o 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 do Experience Cloud é inscrita 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 se tornam disponíveis no Adobe Analytics. O rastreamento de vídeo depende da presença da extensão Adobe Medium Analytics for Audio and Video.

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 Tracking overview. Especificamente, o rastreamento de QoS, Anúncios, Capítulo/Segmentos ou Erros não é suportado.

Usar a extensão Visualizadores do Dynamic Media

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

Rastrear visualizadores do Dynamic Media no Experience Manager Sites

Para rastrear visualizadores do Dynamic Media no Experience Manager 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 nuvem de tags do Experience Platform.

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

Rastrear visualizadores do Dynamic Media usando o código incorporado

Os clientes que não usam Sites Experience Manager ou incorporam visualizadores Dynamic Media em páginas da Web fora dos Sites Experience Manager, ou ambos, ainda podem usar a integração de Tags Experience Platform.

Complete as etapas de configuração nas seções Configurar Adobe Analytics e Configurar Tags do Experience Platform . No entanto, as etapas de configuração relacionadas ao Experience Manager não são necessárias.

Após a configuração correta, você pode adicionar suporte a Tags de Experience Platform a uma página da Web com um visualizador do Dynamic Media.

Consulte Adicionar o código incorporado de tags do Experience Platform para saber mais sobre como usar o código incorporado da biblioteca de Tags do Experience Platform.

Rastrear visualizadores do Dynamic Media usando o código incorporado:

  1. Ter uma página da Web pronta para incorporar um visualizador do Dynamic Media.
  2. Obtenha o código incorporado da biblioteca de Tags do Experience Platform fazendo logon primeiro em Tags do Experience Platform (consulte Configuração de tags do Experience Platform).
  3. Selecione Propriedade e selecione a guia Ambientes.
  4. Escolha o nível de Ambiente que seja relevante para o ambiente da página da Web. Em seguida, na coluna Install, selecione o ícone da caixa.
  5. Na caixa de diálogo Instruções de instalação da Web , copie o código incorporado da biblioteca de Tags do Experience Platform, juntamente com as <script/> tags subjacentes.

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

Sobre a configuração dos visualizadores do Dynamic Media

A extensão do Visualizador do Dynamic Media integra-se automaticamente à biblioteca de Tags do Experience Platform se as seguintes condições forem verdadeiras:

  • O objeto global da biblioteca de Tags de Experience Platform ( _satellite) está presente na página.

  • A função de extensão _dmviewers_v001() do Dynamic Media Viewers é definida em _satellite.

  • config2= O parâmetro do visualizador não é 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 de Tags de Experience Platform no visualizador, especificando o parâmetro launch=0 na configuração do visualizador. O valor padrão desse parâmetro é 1.

Configurar a extensão Visualizadores do Dynamic Media

A única opção de configuração para a extensão Visualizadores do Dynamic Media é Ativar o Adobe Medium Analytics para áudio e vídeo.

Ao marcar (habilitar) essa opção e a extensão Adobe Medium Analytics for Audio and Video estiver instalada e configurada, as métricas de reprodução de vídeo serão enviadas à solução Adobe Analytics para áudio e vídeo. Desativar esta opção desativa o rastreamento de vídeo.

Se você ativar essa opção sem ter a extensão Adobe Medium Analytics for Audio and Video instalada, a opção não terá efeito.

image2019-7-22_12-4-23

Sobre elementos de dados na extensão Visualizadores do Dynamic Media

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 Elemento 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 do visualizador do Dynamic Media selecionado.

image2019-7-22_12-5-46

Consulte o Guia de referência de visualizadores do Dynamic Media para obter a lista de eventos suportados por cada tipo de visualizador; vá para a seção visualizador específico e selecione Suporte para a subseção de rastreamento do Adobe Analytics . No momento, o guia de referência Visualizadores do Dynamic Media não documenta argumentos de evento.

Agora considere 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 ocorre na página. Por exemplo, suponha que o Elemento de dados aponte para o evento LOAD e seu argumento "ativo". Nesse caso, o valor desse Elemento de dados recebe dados válidos depois que o visualizador executa 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, suponha que o Elemento de Dados ZoomScale esteja definido para o parâmetro "scale" do evento ZOOM. No entanto, a única regra presente na configuração Regra é acionada pelo evento LOAD. O valor de ZoomScale ainda é atualizado sempre que um usuário executa 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. Por exemplo, suponha que haja vários visualizadores na mesma página e um elemento de dados AssetName que aponte para o evento LOAD e seu argumento "asset". O Elemento de dados AssetName mantém uma coleção de nomes de ativos que estão 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 o Elemento de dados é solicitado em uma Regra que foi acionado por um Evento de alguma outra extensão de Tags de Experience Platform. Nesse momento, o valor do Elemento de dados vem do visualizador que foi o último a atualizar esse Elemento de dados.

Considere a seguinte configuração de exemplo:

  • Uma página da Web que tem dois visualizadores de zoom do Dynamic Media: viewer1 e viewer2.

  • ​O elemento ZoomScaleData aponta para o evento ​ZOOM e seu argumento "scale".

  • ​TrackPanRule com o seguinte:

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

    • Usa o evento de pressionamento de tecla da extensão Tags do Experience Platform principal como acionador.
    • Envia o valor do elemento de dados ZoomScale para Adobe Analytics.

Agora, suponha que o usuário final carregue a página da Web com os dois visualizadores. Em viewer1, aproximam o zoom para uma escala de 50%; em seguida, em viewer2, ampliam para 25% de escala. Em viewer1, eles deslocam a imagem e finalmente selecionam uma tecla no teclado.

A atividade do usuário final resulta nas duas chamadas de rastreamento a seguir feitas para o Adobe Analytics:

  • A primeira chamada ocorre porque a Regra TrackPan é acionada quando o usuário é ativado em viewer1. Essa chamada envia 50% como um valor do Elemento de Dados ZoomScale porque o Elemento de Dados sabe 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, pois 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 do Dynamic Media é armazenado no código da biblioteca de Tags do Experience Platform mesmo depois que o próprio visualizador é descartado na página da Web. Essa funcionalidade significa que, se houver uma Regra que é acionada por uma extensão de Visualizador que não é da Dynamic Media e faz referência a esse Elemento de dados, o Elemento de dados retornará o último valor conhecido. Mesmo se o visualizador não estiver mais presente na página da Web.

Em qualquer caso, os valores dos Elementos de dados orientados pelos Visualizadores do Dynamic Media não são armazenados no armazenamento local ou no servidor; em vez disso, elas são mantidas somente na biblioteca de Tags do Experience Platform do lado do cliente. Os valores desse Elemento de dados desaparecem quando a página da Web é recarregada.

Geralmente, o Editor de Elemento de Dados suporta seleção de duração do armazenamento. No entanto, os Elementos de dados que usam a extensão Visualizadores do Dynamic Media oferecem suporte apenas à opção de duração de armazenamento de None. A configuraçã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 do Dynamic Media

No editor de Regras, a extensão adiciona novas opções de configuração para o editor de Eventos. Além disso, o editor fornece uma opção para fazer referência manual aos parâmetros de 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 Tipo de evento chamado Evento do visualizador.

Quando selecionado, o Editor de eventos renderiza o menu suspenso Dynamic Media Viewer events, listando todos os eventos disponíveis compatíveis com os visualizadores do Dynamic Media.

image2019-8-2_15-13-1

Sobre o editor de Ações

A extensão Visualizadores do Dynamic Media permite usar parâmetros de evento de visualizadores do Dynamic Media para mapear variáveis de análise no editor Definir variáveis da extensão Adobe Analytics.

O método mais simples de 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 do Dynamic Media.
  • Finalmente, no editor Definir variáveis da extensão do Adobe Analytics, selecione o ícone do seletor de Elemento de dados (três discos empilhados) para abrir a caixa de diálogo Selecionar elemento de dados e, em seguida, 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. Você pode fazer referência diretamente a um argumento de um evento do Visualizador do Dynamic Media. Insira o nome totalmente qualificado do argumento de evento no campo de entrada value da atribuição de variável do Analytics. Certifique-se de rodar com sinais de porcentagem (%). Por exemplo,

%event.detail.dm.LOAD.asset%

image2019-7-12_19-2-35

Há uma diferença importante entre o uso de Elementos de dados e a referência do argumento de evento direto. Para o 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. Por exemplo, selecionar a página da Web na 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 faz referência.

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 os eventos do Visualizador do Dynamic Media e seus argumentos compatíveis:

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 da integração

ANTES DE COMEÇAR

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 do Dynamic Media com o Adobe Analytics e o Adobe Analytics para áudio e vídeo. Embora o uso da extensão Visualizadores do Dynamic Media para outros propósitos em Tags de Experience Platform, esses cenários não são abordados nesta documentação.

Você usará os seguintes produtos do Adobe para configurar a integração:

  • Adobe Analytics - usado para configurar variáveis e relatórios de rastreamento.
  • Tags de Experience Platform - usadas para 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 o Experience Manager Sites, a seguinte configuração também deverá ser feita:

  • Adobe I/O Console - a integração é criada para Tags do Experience Platform.
  • Nó Experience Manager author - Configuração IMS e configuração da nuvem de Experience Platform Tags.

Como parte da configuração, certifique-se de ter acesso a uma empresa no Adobe Experience Cloud que já tenha Adobe Analytics e Experience Platform Tags ativadas.

Configurar o Adobe Analytics para integração

Após configurar o Adobe Analytics, as seguintes etapas serão configuradas para a integração:

  • Um Conjunto de relatórios está no lugar e está 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 a integração:

  1. Comece acessando o Adobe Analytics a partir do Experience Cloud home page. Na barra de menus, selecione o ícone Solutions (uma tabela de pontos três por três) próximo ao canto superior direito da página, em seguida, selecione Analytics.

    2019-07-22_18-08-47

    Em seguida, selecione 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 captura de tela 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 é somente um exemplo. O nome do conjunto de relatórios que você selecionar dependerá de você.

    Se nenhum conjunto de relatórios estiver disponível, você ou o administrador da Adobe Analytics devem 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.

    2019-07-22_18-09-49

    Agora, configure as variáveis do Adobe Analytics.

Configurar variáveis do Adobe Analytics

  1. Atribua uma ou mais variáveis do Adobe Analytics que você deseja usar para rastrear o comportamento dos Visualizadores do Dynamic Media 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 Tráfego personalizado [props], Conversão [eVar]) é orientada pelas necessidades específicas da sua 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 se tornam disponíveis em um Relatório do Analytics alguns minutos depois que uma ação ocorre em uma página da Web.

    Para ativar uma nova variável de Tráfego personalizado, no Adobe Analytics, na barra de ferramentas, vá para Admin > Conjuntos de relatórios.

  2. Na página Gerenciador do conjunto de relatórios, selecione o relatório correto e, na barra de ferramentas, navegue até Editar configurações > Tráfego > Variáveis de tráfego.

  3. Selecione uma variável que não esteja sendo usada, 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, selecione Save.

Configurar 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, é suficiente saber que os relatórios de Tráfego personalizado ficam automaticamente disponíveis no Adobe Analytics depois que você configura variáveis de Tráfego personalizado em Configurar variáveis do Adobe Analytics.

    Por exemplo, o relatório para a 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

Configurar tags de Experience Platform para a integração

Após configurar as Tags de Experience Platform, as seguintes etapas serão configuradas para a integração:

  • A criação de uma nova propriedade para manter todas as configurações juntas.
  • A instalação e configuração das extensões. O código do lado do cliente de todas as extensões instaladas na Propriedade é compilado em conjunto em uma biblioteca. Essa biblioteca é usada posteriormente pela página da Web.
  • Configuração de elementos de dados e regras. Essa configuração define quais dados capturar dos 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 Tags de Experience Platform para a integração:

  1. Comece acessando Tags de Experience Platform a partir do Experience Cloud home page. Na barra de menus, selecione o ícone Solutions (três por três tabelas de pontos) próximo ao canto superior direito da página e selecione Tags.

    Você também pode abrir Tags de Experience Platform diretamente.

    image2019-7-8_15-38-44

Criar uma propriedade em Tags do Experience Platform

Uma propriedade nas Tags do Experience Platform é 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 Tags.

  1. Em Tags de Experience Platform, selecione 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 Domains, digite 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. Selecione Salvar.

    Selecione a 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 nas Tags do Experience Platform são listadas em Extensões > Catálogo.

Para instalar uma extensão, selecione Instalar. Se necessário, execute uma configuração de extensão única e selecione Save.

Quando necessário, as seguintes extensões devem ser instaladas e configuradas:

  • (Obrigatório) Extensão Experience Cloud ID Service.

Nenhuma configuração adicional é necessária, aceite para qualquer valor proposto. Quando terminar, selecione Save.

Consulte Extensão do Adobe Experience Cloud Identity Service.

  • (Obrigatório) Extensão Adobe Analytics

Para configurar essa extensão, você precisa da 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 do Conjunto de relatórios do DynamicMediaViewersExtensionDoc Conjunto de relatórios é 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 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.

Selecione Salvar.

Consulte Extensão do Adobe Analytics.

  • (Opcional; obrigatório somente se o rastreamento de vídeo for necessário) extensão Adobe Medium Analytics for Audio and Video

Preencha o campo do servidor de rastreamento. O servidor de rastreamento da extensão Adobe Medium Analytics for Audio and Video é diferente do servidor de rastreamento usado para o 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 Extensão Adobe Medium Analytics for Audio and Video.

  • (Obrigatório) Extensão Dynamic Media Viewers

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

A partir dessa gravação, a extensão Dynamic Media Viewers só estará disponível se a Propriedade de tags Experience Platform for criada para desenvolvimento.

Consulte Criar uma propriedade em Tags do Experience Platform.

Depois que as extensões forem instaladas e configuradas, no mínimo, as cinco extensões a seguir (quatro se você não estiver rastreando vídeo) serão listadas na área Extensões > Instalado.

image2019-7-22_12-7-36

Configurar elementos de dados e regras

Em Tags de Experience Platform, crie os Elementos de dados e as Regras necessários para rastrear os visualizadores do Dynamic Media.

Consulte Como os dados e o rastreamento de eventos funcionam na integração para obter uma visão geral do rastreamento com Tags de Experience Platform.

Consulte Exemplo de configuração para obter uma configuração de amostra em Tags do Experience Platform que demonstra como rastrear um nome de ativo no carregamento do visualizador.

Consulte Configurar a extensão Visualizadores do Dynamic Media para obter informações detalhadas sobre os recursos da extensão.

Publicar uma biblioteca

Para alterar a configuração das Tags do Experience Platform (incluindo a configuração de Propriedade, Extensões, Regras e Elementos de Dados), você deve publicar essas alterações. A publicação em Tags do Experience Platform é executada a partir da guia Publicação na configuração Propriedade.

As Tags do Experience Platform podem ter vários ambientes de desenvolvimento, um ambiente de preparo e um ambiente de produção. Por padrão, a Configuração da nuvem de Experience Platform Tags no Experience Manager aponta o nó Experience Manager author para o ambiente Stage das Experience Platform Tags. O nó Experience Manager Publish aponta para o ambiente de produção das Tags do Experience Platform. Esse arranjo significa que, com as configurações padrão do Experience Manager, é necessário publicar a biblioteca de Tags do Experience Platform no ambiente de preparo. Isso permite usá-lo no Experience Manager author. Em seguida, você pode publicá-lo no ambiente de Produção para que ele possa ser usado na publicação do Experience Manager.

Consulte Ambientes para obter mais informações sobre os ambientes de Tags do Experience Platform.

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.
  • Migração da biblioteca para níveis de ambiente diferentes (de desenvolvimento para armazenamento temporário e produção).

Adicionar e criar uma nova biblioteca

  1. Na primeira vez que você abre a guia Publicação em Tags do Experience Platform, a lista da biblioteca fica vazia.

    Na coluna da esquerda, selecione 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 Ambiente . Inicialmente, somente o nível de Desenvolvimento está disponível para seleção. Próximo ao lado inferior esquerdo da página, selecione Adicionar todos os recursos alterados.

    image2019-7-15_14-49-41

  3. Próximo ao canto superior direito da página, selecione Salvar e criar para desenvolvimento.

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

    image2019-7-15_15-3-34

    OBSERVAÇÃO

    Na próxima vez que você alterar a configuração das Tags do Experience Platform, vá para a guia Publicação na configuração Propriedade e selecione a biblioteca criada anteriormente.

    Na tela de publicação da biblioteca, selecione Adicionar todos os recursos alterados e selecione Salvar e criar para desenvolvimento.

Mover uma biblioteca para cima por meio de níveis de ambiente

  1. Após a adição de uma nova biblioteca, ela é encontrada no ambiente de desenvolvimento. Para movê-lo para o nível de ambiente de preparo (que corresponde à coluna Enviado ), no menu suspenso da biblioteca, selecione Enviar para aprovação.

    image2019-7-15_15-52-37

  2. Na caixa de diálogo de confirmação, selecione Enviar.

    Depois que a biblioteca for movida para a coluna Enviado, no menu suspenso da biblioteca, selecione Criar para preparo.

    image2019-7-15_15-54-37

  3. Para mover a biblioteca do ambiente de preparo para o ambiente de produção (que é a coluna Publicado ), siga um processo semelhante.

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

    image2019-7-15_16-7-39

  4. No menu suspenso, selecione 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 em Tags do Experience Platform.

Configurar o Adobe Experience Manager para integração

Pré-requisitos:

  • O Experience Manager executa as instâncias Autor e Publicação.
  • O nó Experience Manager author é configurado no Dynamic Media - Modo de execução Scene7 (dynamicmedia_s7)
  • Os componentes WCM do Dynamic Media são ativados no Experience Manager Sites.

A configuração de Experience Manager consiste nas duas etapas principais a seguir:

  • Configuração do Experience Manager IMS.
  • Configuração da nuvem de tags do Experience Platform.

Configurar Experience Manager IMS

  1. No autor do Experience Manager, selecione o ícone Ferramentas (martelo) e vá para Segurança > Configurações do Adobe IMS.

    2019-07-25_11-52-58

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

  3. Na página Adobe IMS Technical Account Configuration, na lista suspensa Cloud Solution, selecione Experience Platform Tags.

  4. Habilite Criar novo certificado, em seguida, no campo de texto, insira qualquer valor significativo para seu certificado. Por exemplo, AdobeLaunchIMSCert. Selecione Criar certificado.

    A seguinte mensagem de Informações é exibida:

    Para recuperar um token de acesso válido, a chave pública do novo certificado é adicionada à conta técnica no Adobe I/O!

    Para fechar a caixa de diálogo Informações, selecione OK.

    2019-07-25_12-09-24

  5. Para baixar um arquivo de chave pública (*.crt) em seu sistema local, selecione Baixar chave pública.

    OBSERVAÇÃO

    Neste ponto, deixe aberta a página Configuração de Conta Técnica do Adobe IMS; do not feche a página e do not selecione Next. Você retornará a esta página mais tarde nas etapas.

    2019-07-25_12-52-24

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

  7. Na página Integrações do console do Adobe I/O , próximo ao canto superior direito, selecione Nova integração.

  8. Na caixa de diálogo Create a new integration, verifique se o botão de opção Access an API está selecionado e selecione Continue.

    2019-07-25_13-04-20

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

    2019-07-25_13-13-54

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

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

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

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

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

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

    2019-07-25_13-49-18

  11. Selecione Criar integração.

  12. Na página Integration created, selecione Continue to integration details.

    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ê precisará de várias informações das guias Visão geral e JWT em apenas um momento.

    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, selecione Next para abrir a página Account na janela Adobe IMS Technical Account Configuration.

    (Se você tiver fechado a página anterior, volte para o autor do Experience Manager e navegue até Ferramentas > Segurança > Configurações do Adobe IMS. Selecione Criar. Na lista suspensa Solução da nuvem, selecione Tags do Experience Platform. Na lista suspensa Certificado, selecione o nome do certificado criado anteriormente.)

    2019-07-25_20-57-50

    Configuração de conta técnica do Adobe IMS - página Certificado.

  15. A página Account tem cinco campos que você precisa preencher usando informações da página Detalhes da integração da etapa anterior.

    2019-07-25_20-42-45

    Configuração de conta técnica do Adobe IMS - página Conta.

  16. Na página Account, preencha os seguintes campos:

    • Título - Insira um título de conta descritiva.
    • Servidor de autorização - Retorne à página Detalhes da integração que você abriu anteriormente. Selecione a guia JWT. Copie o nome do servidor, sem o caminho, conforme destacado abaixo.

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

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. Selecione a guia Visão geral e, à direita do campo Chave da API (ID do cliente), selecione 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, selecione Recuperar segredo do cliente. À direita do campo Segredo do cliente, selecione 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, é semelhante ao seguinte:

    2019-07-25_22-08-30

  4. Próximo ao canto superior direito da página Conta, selecione Criar.

    Com o Experience Manager IMS configurado, agora você tem um novo IMSAccount listado em Adobe IMS Configurations.

    image2019-7-15_14-17-54

Configurar a Experience Platform Tags Cloud para integração

  1. No autor do Experience Manager, próximo ao canto superior esquerdo, selecione o ícone Ferramentas (martelo) e vá para Cloud Services > Experience Platform Tags Configurations.

    2019-07-26_12-10-38

  2. Na página Configurações de Tags do Experience Platform, no painel esquerdo, selecione um Experience Manager Site para o qual deseja aplicar a Configuração de Tags do Experience Platform.

    Somente para fins de amostra, o site We.Retail é selecionado na captura de tela abaixo.

    2019-07-26_12-20-06

  3. Próximo ao canto superior esquerdo da página, selecione Criar.

  4. Na página Geral (1/3 páginas) da janela Criar configuração de Experience Platform Tags, preencha os seguintes campos:

    • Título - insira um título de configuração descritivo. Por exemplo, We.Retail Tags cloud configuration.

    • Configuração associada do Adobe IMS - selecione a configuração IMS criada anteriormente em Configurar Experience Manager IMS.

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

    • Propriedade - Na lista suspensa Propriedade, selecione a propriedade Tags de Experience Platform criada anteriormente. A lista é preenchida automaticamente.

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

    image2019-7-15_14-34-23

  5. Próximo ao canto superior esquerdo, selecione Próximo.

  6. Na página Preparo (2/3 páginas) da janela Criar configuração de Experience Platform Tags, preencha o seguinte campo:

    No campo Library URI (Uniform Resource Identifier), verifique o local da versão de preparo da biblioteca de Tags do Experience Platform. Experience Manager preenche este campo automaticamente.

    Por exemplo, apenas para fins de teste, essa etapa usa bibliotecas de Tags de Experience Platform que são 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, começa com uma barra dupla.

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

    Sua página Preparando provavelmente aparecerá semelhante ao seguinte. As opções Arquivar e Carregar biblioteca de forma assíncrona são não definidas:

    image2019-7-15_15-21-8

  7. Próximo ao canto superior direito, selecione Próximo.

  8. Na página Production (3/3 páginas) da janela Create Experience Platform Tags Configuration, se necessário, corrija o URI de produção preenchido automaticamente de modo semelhante ao que foi feito na página anterior Staging.

  9. Próximo ao canto superior direito, selecione Criar.

    A nova configuração da nuvem de tags de Experience Platform é criada e listada ao lado do site, como no exemplo a seguir:

  10. Selecione a nova Configuração da nuvem de tags de Experience Platform (uma marca de seleção é exibida à esquerda do título da configuração quando selecionada). Na barra de ferramentas, selecione Publish.

    image2019-7-15_15-47-6

No momento, o autor do Experience Manager não oferece suporte à integração de visualizadores Dynamic Media com tags Experience Platform.

No entanto, ele é compatível com o nó de publicação do Experience Manager. Usando as configurações padrão da Configuração da nuvem de Experience Platform Tags, o nó de publicação do Experience Manager usa o ambiente de produção de Tags do Experience Platform. Dessa forma, é necessário enviar atualizações da biblioteca de Tags do Experience Platform do Desenvolvimento para o ambiente de Produção sempre durante o teste.

É possível contornar essa limitação. Especifique o URL de desenvolvimento ou armazenamento temporário da biblioteca de Tags de plataforma na configuração da nuvem de Tags do Experience Platform para o nó de publicação do Experience Manager acima. Isso faz com que o nó de publicação do Experience Manager use a versão de Desenvolvimento ou Armazenamento temporário da biblioteca de Tags do Experience Platform.

Consulte Integrar o Experience Manager com Tags de Experience Platform por meio de Adobe I/O para obter mais informações sobre como configurar a Configuração da nuvem de tags de Experience Platform.

Nesta página