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

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

Visualizadores do Dynamic Media A extensão para Tags do Experience Platform e Visualizadores do Dynamic Media 5.13 permite que os clientes das Tags do Adobe Analytics e Experience Platform usem eventos e dados específicos para visualizadores do Dynamic Media em sua configuração de Tags do Experience Platform.

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 de terceiros, consulte Extensões do Adobe no Guia do usuário de Tags do Experience Platform.

Este tópico destina-se ao seguinte: Administradores de sites, desenvolvedores no programa Adobe Experience Manager 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 do Experience Platform não pode ser usada simultaneamente com a integração do Analytics de visualizadores herdados (por meio do config2= parâmetro).
  • 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 da Duração do armazenamento para Elementos de dados não é compatível com Elementos de dados que usam o Visualizadores do Dynamic Media extensão. Duração do armazenamento deve ser definida como Nenhum.

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 Experience Manager Assets e 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 do 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 do 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 trabalhe em conjunto 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 no Guia do usuário de Tags do Experience Platform.

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:

  • Eventos (if) informa às Tags de Experience Platform quando acionar uma regra.
  • Condições (if) informa às Tags de Experience Platform que outras restrições serão permitidas ou não durante o acionamento de uma Regra.
  • Ações (em seguida) informa às Tags de Experience Platform 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. O Núcleo A extensão do é pré-instalada e está disponível para uso imediato em qualquer configuração. A extensão fornece várias opções para Eventos, como ações básicas no nível do navegador que incluem alteração 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 Definir variáveis ação. Essa ação informa ao Adobe Analytics como preencher variáveis de rastreamento com dados. Ao mesmo tempo, a variável Definir variáveis não envia nada para o servidor de rastreamento.

O Definir variáveis deve ser seguida de uma Enviar beacon ação. O Enviar beacon na verdade envia dados para o servidor de rastreamento do analytics. Ambas as ações, Definir variáveis e Enviar beacon, vêm da extensão do Adobe Analytics.

Consulte Regras no Guia do usuário de Tags do Experience Platform.

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. No Elementos de dados , defina um elemento de dados AssetName que referenciam asset do LOAD da extensão Visualizadores do Dynamic Media.

    image2019-11

  2. No Regras , definir uma regra TrackAssetOnLoad.

    Nessa regra, a variável Evento O campo usa a variável CARREGAR 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:

    Definir variáveis, que mapeia uma variável do analytics de sua escolha para o valor de AssetName Elemento de dados.

    Enviar beacon, que envia informações de rastreamento para o Adobe Analytics.

    image2019-3

  4. A configuração de regra resultante aparece como a 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 na Visualizadores do Dynamic Media configurações de extensão. 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 Visão geral do rastreamento. 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 no 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 Configurar todas as partes da integração deve ser executada. 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.

Consulte Adicionar ativos Dynamic Media às páginas usando o Adobe Sites.

Rastrear visualizadores do Dynamic Media usando o código incorporado

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

Complete as etapas de configuração no Configurar o Adobe Analytics e Configurar tags de Experience Platform seções. 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 de inserção de tags de Experience Platform para saber mais sobre como usar o código incorporado da biblioteca de Tags do Experience Platform.

Para saber mais sobre como usar o recurso de código incorporado do Experience Manager Dynamic Media, consulte Incorporação do visualizador de vídeo ou imagem em uma página da Web.

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 Configurar tags de Experience Platform).
  3. Selecionar Propriedade, em seguida, selecione o Ambientes guia .
  4. Escolha o nível de Ambiente que seja relevante para o ambiente da página da Web. Em seguida, no Instalar selecione o ícone de caixa .
  5. Nas Instruções de Instalação na Web caixa de diálogo, copie o código incorporado completo da biblioteca de Tags de Experience Platform, juntamente com o <script/> tags.

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:

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

  • A função de extensão Visualizadores do Dynamic Media _dmviewers_v001() é definido 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 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 esta opção without com 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 a 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 vamos 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 ocorre na página. Por exemplo, suponha que o Elemento de dados aponte para a variável CARREGAR e seu argumento "asset". 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 a variável ZOOM e seu argumento "scale", o valor de tal Elemento de dados permanece vazio até que o visualizador envie uma 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 Elemento de dados ZoomScale é definido para o parâmetro "scale" do evento ZOOM. No entanto, a única regra presente na configuração Regra é acionada pela variável CARREGAR evento. O valor de ZoomScale O 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 AssetName Elemento de dados que aponta para o CARREGAR e seu argumento "asset". O AssetName O Elemento de dados mantém 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 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 visualizador2.

  • ZoomScale O elemento de dados aponta para a variável ZOOM e seu argumento "scale".

  • TrackPan Regra com o seguinte:

    • Usa o Visualizador do Dynamic Media PAN como um acionador.
    • Envia o valor de ZoomScale Elemento de dados para o Adobe Analytics.
  • TrackKey Regra com o seguinte:

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

Agora, suponha que o usuário final carregue a página da Web com os dois visualizadores. Em viewer1, ampliam para 50% de escala; em seguida, em visualizador2, ampliam para 25% de escala. Em viewer1, eles percorrem imagens e finalmente pressionam 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 TrackPan A regra é acionada quando o usuário entra viewer1. Essa chamada envia 50% como um valor de ZoomScale Elemento de dados porque o Elemento de dados sabe que a Regra é acionada por viewer1 e buscar o valor de escala correspondente;
  • A segunda chamada ocorre porque TrackKey A regra é 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 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 da duração do armazenamento. No entanto, os Elementos de dados que usam a extensão Visualizadores do Dynamic Media suportam apenas a opção de duração de armazenamento de Nenhum. 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 Eventos do visualizador do Dynamic Media, 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.
  • Por fim, no editor Definir variáveis da extensão do Adobe Analytics, selecione o ícone Seletor de elementos 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 na value campo de entrada da atribuição de variável do Analytics. Certifique-se de rodar por 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 (como 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 deve ser realizada:

  • Console Adobe I/O - 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 página inicial. Na barra de menus, selecione o ícone Soluções (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.

    No exemplo abaixo, um usuário criou um conjunto de relatórios chamado DynamicMediaViewersExtensionDoc e selecionou na lista suspensa. O nome do conjunto de relatórios é apenas 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 Administrador > 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]) é orientado por necessidades específicas de 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 Tráfego personalizado, no Adobe Analytics, na barra de ferramentas, acesse Administrador > Conjuntos de relatórios.

  2. No Gerenciador do Conjunto de relatórios selecione o relatório correto e, na barra de ferramentas, vá para Editar configurações > Tráfego > Variáveis de tráfego.

  3. Escolha uma variável não usada, dê a ela um nome descritivo ( Ativo do visualizador (prop 30)) e, em seguida, 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 Salvar.

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 as variáveis de Tráfego personalizado em Configurar variáveis do Adobe Analytics.

    Por exemplo, o relatório de 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 adquirir 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 do Experience Cloud página inicial. Na barra de menus, selecione o ícone Soluções (três por três tabelas de pontos) próximo ao canto superior direito da página, em seguida, selecione Tags.

    Você também pode abrir Tags do 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.

Para criar uma propriedade em Tags de Experience Platform:

  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 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. 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 estão listadas na seção Extensões > Catálogo.

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

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

  • (Obrigatório) Serviço de ID de Experience Cloud extensão

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

Consulte Extensão do Experience Cloud Identity Service.

  • (Obrigatório) Adobe Analytics extensão

Para configurar essa extensão, você precisa da ID do conjunto de relatórios encontrada no Adobe Analytics, em Administrador > Conjunto de relatórios nos termos do ID do conjunto de relatórios cabeçalho da coluna.

(Somente para fins de demonstração, a ID do conjunto de relatórios do DynamicMediaViewersExtensionDoc O Conjunto de relatórios é usado 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ê pretende usar o rastreamento de vídeo:

No Instalar extensão página, expandir Geral, em seguida, especifique o Servidor de rastreamento. O servidor de rastreamento segue o modelo <trackingNamespace>.sc.omtrdc.net, onde <trackingNamespace> é a informação obtida 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) Adobe Medium Analytics para áudio e vídeo extensão

Preencha o campo do servidor de rastreamento. O servidor de rastreamento para Adobe Medium Analytics para áudio e vídeo é diferente do servidor de rastreamento usado para o Adobe Analytics. Ele segue o modelo <trackingNamespace>.hb.omtrdc.net, onde <trackingNamespace> é a informação do email de provisionamento.

Todos os outros campos são opcionais.

Consulte Extensão Adobe Medium Analytics for Audio and Video.

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

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

A partir dessa escrita, a Visualizadores do Dynamic Media A extensão só estará disponível se a propriedade Tags do 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 o rastreamento de dados e eventos funciona 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 exemplo 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 tais 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 Tags de plataforma. 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 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 Nome , insira 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. Ao lado do 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 de Tags do Experience Platform, acesse Publicação na guia Propriedade , em seguida, selecione a biblioteca criada anteriormente.

    Na tela de publicação da biblioteca, selecione Adicionar todos os recursos alterados, em seguida 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 armazenamento temporário.

    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.
  • 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. No Configuração de conta técnica do Adobe IMS na página Solução da nuvem , selecione Coleta de dados do Experience Platform.

  4. Habilitar Criar novo certificado, em seguida, no campo de texto, insira qualquer valor significativo para o certificado. Por exemplo, AdobeLaunchIMSCert. Selecionar 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!

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

    2019-07-25_12-09-24

  5. Selecionar Baixar chave pública para baixar um arquivo de chave pública (*.crt) ao seu sistema local.

    OBSERVAÇÃO

    Neste ponto, deixar aberto o Configuração de conta técnica do Adobe IMS página; não feche a página e não select Próximo. 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é o Console Adobe I/O.

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

  8. No Criar uma nova integração , verifique se Acessar uma API o botão de opção está selecionado e, em seguida, selecione Continuar.

    2019-07-25_13-04-20

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

    2019-07-25_13-13-54

  10. No terceiro Criar uma nova integração faça o seguinte:

    • No Nome digite o nome descritivo. Por exemplo, DynamicMediaViewersIO.

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

    • No Certificados de chave pública , faça upload do arquivo de chave pública (*.crt) que você baixou anteriormente nessas etapas.

    • Em Selecione uma função para a API de Tags de Experience Platform título, selecione Administrador.

    • Em Selecione um ou mais perfis de produto para a API de Tags do Experience Platform , selecione o perfil de produto chamado Tags - <your_company_name>.

    2019-07-25_13-49-18

  11. Selecionar Criar integração.

  12. No Integração criada página, selecione Continuar para detalhes de 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ê precisará de várias informações da Visão geral e JWT em 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 Próximo para abrir o Conta na página Configuração de conta técnica do Adobe IMS janela.

    (Se você tiver fechado a página anterior, volte para o autor do Experience Manager e, em seguida, vá para Ferramentas > Segurança > Configurações do Adobe IMS. Selecione Criar. No Solução da nuvem , selecione Tags de 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. O Conta tem cinco campos que exigem que você preencha usando as 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. No Conta 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 o JWT guia . Copie o nome do servidor - sem o caminho - conforme destacado abaixo.

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

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 o Visão geral , em seguida à direita do 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. No Visão geral guia , selecione Recuperar Segredo do Cliente. À direita do Segredo do cliente , selecione Copiar.

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

  3. Carga - Retorne à página Detalhes da integração . No 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 do Conta página, selecione Criar.

    Com o Experience Manager IMS configurado, agora há um novo IMSAccount listado em Configurações do Adobe IMS.

    image2019-7-15_14-17-54

Configurar a Experience Platform Tags Cloud para integração

  1. No Experience Manager author, próximo ao canto superior esquerdo, selecione o ícone Tools (martelo) e vá para Cloud Services > Configurações de Tags de Experience Platform.

    2019-07-26_12-10-38

  2. No Configurações de Tags de Experience Platform no painel esquerdo, selecione um Experience Manager Site para o qual deseja aplicar sua Configuração de tags do Experience Platform.

    Somente para fins de amostra, a variável We.Retail O site é selecionado na captura de tela abaixo.

    2019-07-26_12-20-06

  3. Ao lado do canto superior esquerdo da página, selecione Criar.

  4. No Geral página (1/3 páginas) do 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 - Do 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 completar todos os campos, Geral será semelhante ao seguinte:

    image2019-7-15_14-34-23

  5. Ao lado do canto superior esquerdo, selecione Próximo.

  6. No Estágios página (2/3 páginas) do Criar configuração de Experience Platform Tags , preencha o seguinte campo:

    No URI da biblioteca (Identificador de recurso uniforme), verifique o local da versão de preparo da biblioteca de Tags do Experience Platform. Experience Manager preenche este campo automaticamente.

    Para fins de explicação somente, esta 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.

    Seu Estágios A página provavelmente aparecerá de forma semelhante ao seguinte. O Arquivar e Carregar biblioteca de forma assíncrona as opções são not definido:

    image2019-7-15_15-21-8

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

  8. No Produção página (3/3 páginas) do Criar configuração de Experience Platform Tags , se necessário, corrija o URI de produção preenchido automaticamente de modo semelhante ao que foi feito no Estágios página.

  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.

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

    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 tags de Experience Platform, a publicação do Experience Manager usa o ambiente de produção de Tags de 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 preparo ou desenvolvimento da biblioteca de Tags do Experience Platform na configuração da nuvem de Tags do Experience Platform para 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 tags e Experience Manager do Experience Platform para obter mais informações sobre como configurar a Configuração da nuvem de tags do Experience Platform.

Nesta página