Integrar visualizadores do Dynamic Media com tags Adobe Analytics e Experience Platform integrating-dynamic-media-viewers-with-adobe-analytics-and-adobe-launch

O que é a integração do Dynamic Media Viewers com as tags Adobe Analytics e Experience Platform? what-is-dynamic-media-viewers-integration-with-adobe-analytics-and-adobe-launch

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

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

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

Este tópico é destinado ao seguinte: administradores de site, desenvolvedores no programa Adobe Experience Manager e pessoas em Operações.

Limitações da integração limitations-of-the-integration

  • A integração de tags do Experience Platform para visualizadores do Dynamic Media não funciona no nó do autor do Experience Manager. Não é possível ver nenhum rastreamento de uma página WCM até que ela seja publicada.
  • A integração de tags Experience Platform para visualizadores do Dynamic Media não é compatível com o modo de operação "pop-up", em que o URL do visualizador é obtido usando o botão "URL" na página Detalhes do ativo.
  • A integração de tags Experience Platform não pode ser usada simultaneamente com visualizadores herdados e a integração do Analytics (por meio do parâmetro config2=).
  • O suporte ao rastreamento de vídeo está limitado apenas ao rastreamento principal de reprodução, conforme descrito em Visão geral do rastreamento. Especificamente, o rastreamento de QoS, Anúncios, Capítulo/Segmentos ou Erros não é compatível.
  • A configuração da Duração de Armazenamento para Elementos de Dados não tem suporte para Elementos de Dados que usam a extensão Dynamic Media Viewers. A Duração do Armazenamento deve ser definida como Nenhuma.

Casos de uso para a integração do use-cases-for-the-integration

O principal caso de uso para a integração com tags Experience Platform são os clientes que usam Experience Manager Assets e Experience Manager Sites. Nesses cenários, é possível configurar uma integração padrão entre o nó do autor do Experience Manager 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 compatível com a 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 incorporado do visualizador e o adiciona à página do site. Em seguida, obtenha o URL de produção da biblioteca de Tags de Experience Platform das 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 how-data-and-event-tracking-works-in-the-integration

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 about-tracking-using-adobe-analytics

O Adobe Analytics permite rastrear as ações executadas pelo usuário quando ele interage com os Visualizadores do Dynamic Media no seu site. O Adobe Analytics também permite rastrear dados específicos do visualizador. Por exemplo, é possível rastrear e registrar eventos de carregamento de exibição junto com o nome do ativo, ações de zoom ocorridas e ações de reprodução de vídeo.

Nas Tags do Experience Platform, os conceitos de Elementos de Dados e Regras trabalham juntos para habilitar o rastreamento do Adobe Analytics.

Sobre os elementos de dados nas tags Experience Platform about-data-elements-in-adobe-launch

Um elemento de dados nas tags Experience Platform é uma propriedade nomeada cujo valor é definido estaticamente ou calculado dinamicamente com base no estado de uma página da Web ou 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 das Tags de Experience Platform. A extensão "Principal" é pré-instalada e está disponível imediatamente em qualquer configuração. Essa extensão "principal" permite definir um Elemento de dados cujo valor vem do cookie, do código JavaScript, da sequência de consulta e de muitas outras fontes.

Para o rastreamento 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 a capacidade de definir um Elemento de dados cujo valor é um argumento do evento Visualizador dinâmico. Por exemplo, é possível fazer referência ao tipo de visualizador, ou ao nome do ativo relatado pelo visualizador na carga, ao nível de zoom relatado quando o usuário final amplia e muito mais.

A extensão do 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 de Experience Platform, usando o widget Seletor de elementos de dados. Especificamente, os Elementos de dados definidos para fins de rastreamento dos 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 Marcas de Experience Platform.

Sobre regras nas tags Experience Platform about-rules-in-adobe-launch

Uma Regra nas Marcas 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) informam às Marcas de Experience Platform quando acionar uma Regra.
  • As condições (if) informam às Marcas de Experience Platform quais outras restrições permitir ou proibir ao acionar uma Regra.
  • As ações (then) informam às Marcas 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 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 que incluem alteração de foco, pressionamentos de tecla e envio de formulários. Também inclui opções para Condições, como valor de cookie, tipo de navegador e muito mais. Para Ações, somente a opção Código personalizado está disponível.

Para rastreamento 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 compatíveis para eventos específicos de visualizadores do Dynamic Media, como carga do visualizador, troca de ativos, aumento de zoom e reprodução de vídeo.
  • A extensão do Adobe Analytics estende a lista de Ações com suporte com duas ações necessárias para enviar dados aos servidores de rastreamento: Definir Variáveis e Enviar Beacon.

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

  • Eventos de extensão do Dynamic Media Viewers, extensão principal ou 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 Enviar sinal envia dados para o servidor de rastreamento de análise. 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 sample-configuration

O exemplo de configuração a seguir nas Tags do Experience Platform demonstra como rastrear um nome de ativo na carga do visualizador.

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

    image2019-11

  2. Na guia Regras, defina uma regra TrackAssetOnLoad.

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

    image2019-22

  3. A configuração Ação tem dois tipos de Ação da extensão do Adobe Analytics:

    Definir Variáveis, que mapeiam uma variável de análise de sua escolha para o valor de Elemento de Dados AssetName.

    Enviar sinal, que envia informações de rastreamento para a Adobe Analytics.

    image2019-3

  4. A configuração de regra resultante é exibida da seguinte maneira:

    image2019-4

Sobre o Adobe Analytics para áudio e vídeo about-adobe-analytics-for-audio-and-video

Quando uma conta Experience Cloud é assinada para usar o Adobe Analytics para áudio e vídeo, basta habilitar o rastreamento de vídeo nas configurações de extensão do Dynamic Media Viewers. As métricas de vídeo são disponibilizadas no Adobe Analytics. O rastreamento de vídeo depende da presença da extensão Adobe Medium Analytics para áudio e vídeo.

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

Atualmente, o suporte para rastreamento de vídeo está limitado apenas 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 é compatível.

Usar a extensão Visualizadores do Dynamic Media using-the-dynamic-media-viewers-extension

Como mencionado nos Casos de uso da integração, é possível rastrear visualizadores do Dynamic Media com a nova integração de tags Experience Platform no Experience Manager Sites e usando o código de inserção.

Rastrear visualizadores do Dynamic Media no Experience Manager Sites tracking-dynamic-media-viewers-in-aem-sites

Para rastrear visualizadores do Dynamic Media no Experience Manager Sites, todas as etapas listadas na seção Configurar todas as partes da integração devem ser executadas. Especificamente, você deve criar a configuração do IMS e a configuração da nuvem de tags do Experience Platform.

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

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

Rastrear visualizadores do Dynamic Media usando o código incorporado tracking-dynamic-media-viewers-using-embed-code

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 ambas, ainda podem usar a integração de tags Experience Platform.

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

Após a configuração adequada, é possível adicionar o suporte a tags Experience Platform a uma página da Web com um visualizador do Dynamic Media.

Consulte Adicionar o código de inserção das tags do Experience Platform para saber mais sobre como usar o código de inserção 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 de inserção:

  1. Ter uma página da Web pronta para incorporar um visualizador do Dynamic Media.
  2. Obtenha o código incorporado para a biblioteca de marcas de Experience Platform fazendo primeiro logon nas marcas de Experience Platform (consulte Configurar marcas de Experience Platform).
  3. Selecione Propriedade e depois a guia Ambientes.
  4. Selecione o nível de Ambiente relevante para o ambiente da página da Web. Em seguida, na coluna Instalar, selecione o ícone de caixa.
  5. Na caixa de diálogo Instruções de Instalação da Web, copie o código incorporado completo da biblioteca de marcas Experience Platform, juntamente com as <script/> marcas ao redor.

Guia de referência para a extensão Visualizadores do Dynamic Media reference-guide-for-the-dynamic-media-viewers-extension

Sobre a configuração dos Visualizadores do Dynamic Media about-the-dynamic-media-viewers-configuration

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

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

  • A função de extensão _dmviewers_v001() dos Visualizadores do Dynamic Media está definida em _satellite.

  • O parâmetro do visualizador config2= não foi especificado, o que significa que o visualizador não usa a integração do Analytics herdada.

Além disso, há uma opção para desabilitar 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 configuring-the-dynamic-media-viewers-extension

A única opção de configuração para a extensão Dynamic Media Viewers é Habilitar Adobe Medium para Áudio e Vídeo.

Quando você marca (habilita) esta opção e a extensão do Adobe Medium Analytics para áudio e vídeo é instalada e configurada, as métricas de reprodução de vídeo são enviadas para a solução Adobe Analytics para áudio e vídeo. Desativar essa opção desativa o rastreamento de vídeo.

Se você habilitar esta opção sem ter o Adobe Medium Analytics para extensão de Áudio e Vídeo instalado, a opção não terá efeito.

image2019-7-22_12-4-23

Sobre elementos de dados na extensão Visualizadores do Dynamic Media about-data-elements-in-the-dynamic-media-viewers-extension

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 compatíveis com cada tipo de visualizador; vá para a seção de visualizador específica e selecione a subseção Suporte para rastreamento do Adobe Analytics. Atualmente, o guia de referência do Dynamic Media Viewers não documenta argumentos de evento.

Agora vamos considerar o ciclo de vida do Elemento de dados dos visualizadores do Dynamic Media. 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 "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 o evento ZOOM e seu argumento de "escala", o valor desse Elemento de Dados permanecerá vazio até que o visualizador envie um evento ZOOM pela primeira vez.

Da mesma forma, os valores dos Elementos de dados são atualizados automaticamente quando o visualizador envia um evento correspondente na página. A atualização de valor acontece mesmo se o evento específico não for definido na configuração Regra. Por exemplo, suponha que o Elemento de dados ZoomScale seja definido como 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 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 acionada por um Evento de alguma outra extensão de Tags de Experience Platform. Nesse ponto, 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 com dois visualizadores de zoom do Dynamic Media: viewer1 e viewer2.

  • O Elemento de Dados ZoomScale aponta para o evento ZOOM e seu argumento de "escala".

  • Regra de TrackPan com o seguinte:

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

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

Agora, suponha que o usuário carregue a página da Web com os dois visualizadores. No visualizador1, eles ampliam para 50% da escala; em seguida, no visualizador2, eles ampliam para 25% da escala. No visualizador1, eles deslocam a imagem e, por fim, pressionam uma tecla no teclado.

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

  • A primeira chamada ocorre porque a Regra de TrackPan é acionada quando o usuário se projeta no visualizador1. Essa chamada envia 50% como um valor do Elemento de Dados ZoomScale porque o Elemento de Dados sabe que a Regra é acionada pelo visualizador1 e busca o valor de escala correspondente;
  • A segunda chamada ocorre porque a Regra TrackKey é acionada quando o usuário pressiona uma tecla no teclado. Essa chamada envia 25% como um valor do Elemento de Dados ZoomScale porque a Regra não foi acionada pelo visualizador. Dessa forma, o Elemento de dados retorna o valor mais atualizado.

A amostra configurada acima também afeta a duração do valor do Elemento de dados. O valor do Elemento de dados gerenciado pelo Visualizador 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 acionada por uma extensão de Visualizador que não seja da Dynamic Media e fizer referência a esse Elemento de dados, o Elemento de dados retornará o último valor conhecido. Mesmo que o visualizador não esteja mais presente na página da Web.

Em qualquer caso, os valores de elementos de dados orientados por visualizadores do Dynamic Media não são armazenados no armazenamento local ou no servidor; em vez disso, são mantidos somente na biblioteca de tags 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 oferece suporte a seleção de duração de armazenamento. No entanto, os Elementos de Dados que usam a extensão Visualizadores do Dynamic Media só oferecem suporte à opção de duração de armazenamento Nenhuma. É possível definir qualquer outro valor 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 por conta própria: 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 about-rules-in-the-dynamic-media-viewers-extension

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 a parâmetros de eventos no editor de ações como uma opção abreviada, em vez de usar Elementos de dados pré-configurados.

Sobre o editor de eventos about-the-events-editor

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 os eventos do Visualizador do Dynamic Media suspensos, listando todos os eventos disponíveis que são suportados pelos visualizadores do Dynamic Media.

image2019-8-2_15-13-1

Sobre o editor de ações about-the-actions-editor

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 do Adobe Analytics.

O método mais simples para fazer isso é concluir o seguinte processo de duas etapas:

  • Primeiro, defina um ou mais Elementos de dados, em que cada Elemento de dados representa um parâmetro de um evento do Dynamic Media Viewer.
  • Por fim, no editor Definir variáveis da extensão 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.

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 cercar 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 direta ao argumento de evento. Para Elementos 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 de 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 configuring-all-the-integration-pieces

ANTES DE COMEÇAR

A Adobe recomenda que você analise completamente toda a documentação antes desta seção para que você entenda a integração completa.

Esta seção explica as etapas de configuração necessárias para integrar visualizadores do Dynamic Media com o Adobe Analytics e o Adobe Analytics para áudio e vídeo. Embora o uso da extensão Dynamic Media Viewers para outros fins em tags Experience Platform seja possível, esses cenários não são abordados nesta documentação.

Você usará os seguintes produtos 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 deverá ser feita:

  • Adobe Developer Console - a integração foi criada para as Marcas de Experience Platform.
  • Nó do autor de Experience Manager - configuração do IMS e configuração da nuvem de Tags de Experience Platform.

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

Configurar o Adobe Analytics para a integração configuring-adobe-analytics-for-the-integration

Após configurar o Adobe Analytics, o seguinte é configurado para a integração:

  • Um conjunto de relatórios está em vigor e foi 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 no Adobe Analytics.

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

Para configurar o Adobe Analytics para a integração:

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

    2019-07-22_18-08-47

    Agora selecione um conjunto de relatórios.

Selecionar um conjunto de relatórios selecting-a-report-suite

  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 o selecionou na lista suspensa. O nome do conjunto de relatórios é apenas um exemplo. O nome do conjunto de relatórios que você selecionar depende de você.

    Se nenhum conjunto de relatórios estiver disponível, você ou o administrador do Adobe Analytics deverá criar um antes de continuar com a configuração.

    Consulte Relatórios e Conjuntos de Relatórios e Criar um conjunto de relatórios.

    No Adobe Analytics, os conjuntos de relatórios são gerenciados em Administrador > Conjuntos de relatórios.

    07-22_18-09-49-2019

    Agora, configure as variáveis do Adobe Analytics.

Configurar variáveis do Adobe Analytics setting-up-adobe-analytics-variables

  1. Designe uma ou mais variáveis do Adobe Analytics que deseja usar para rastrear o comportamento dos Visualizadores do Dynamic Media na página da Web.

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

    Consulte Visão geral de props e eVars.

    Para os fins desta documentação, somente uma variável de Tráfego personalizado (props) é usada porque ela fica disponível em um Relatório do Analytics dentro de alguns minutos após uma ação ocorrer em uma página da Web.

    Para habilitar uma nova variável de Tráfego Personalizado no Adobe Analytics, na barra de ferramentas, vá para Administrador > Conjuntos de Relatórios.

  2. Na página 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 altere a caixa de combinação para "Habilitado" na coluna Habilitado.

    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 setting-up-a-report

  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á fora do escopo dessa integração.

    No entanto, basta saber que os relatórios de Tráfego personalizado ficam disponíveis automaticamente 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 da variável Ativo do visualizador (prop 30) está disponível no menu Relatórios em Tráfego personalizado > Tráfego personalizado 21-30 > Ativo do visualizador (prop 30).

    Visitar este relatório logo após a criação do Ativo do visualizador (prop 30), não mostra dados; o que é esperado neste momento da integração.

    image2019-6-26_23-12-49

Configurar tags Experience Platform para a integração configuring-adobe-launch-for-the-integration

Após configurar as Tags do Experience Platform, o seguinte é configurado para a integração:

  • A criação de uma nova propriedade para manter todas as suas configurações unidas.
  • A instalação e a 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 pela página da Web posteriormente.
  • Configuração dos 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 para onde enviar os dados do visualizador no Adobe Analytics.
  • Publicação da biblioteca.

Para configurar as Marcas de Experience Platform para a integração:

  1. Comece acessando as Marcas de Experience Platform a partir da página inicial do Experience Cloud. Na barra de menus, selecione o ícone Soluções (tabela de três por três pontos) próximo ao canto superior direito da página e selecione Marcas.

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

    image2019-7-8_15-38-44

Criar uma propriedade nas Tags Experience Platform creating-a-property-in-adobe-launch

Uma propriedade nas Tags de Experience Platform é uma configuração nomeada que mantém todas as suas configurações unidas. Uma biblioteca de definições de configuração é gerada e publicada em diferentes níveis de ambiente (desenvolvimento, armazenamento temporário e produção).

Consulte também Configurar uma propriedade select.

Para criar uma propriedade nas Marcas Experience Platform:

  1. Em Marcas 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 Domínios, digite o domínio do seu 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 criada e prossiga para Instalação e configuração de extensões.

Instalação e configuração de extensões installing-and-setup-of-extensions

Todas as extensões disponíveis nas Tags Experience Platform estã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 Salvar.

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 quaisquer valores propostos. Quando terminar, certifique-se de selecionar Salvar.

Consulte Extensão do 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 é 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 item a seguir somente se pretender usar o acompanhamento 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. Necessário somente se o rastreamento de vídeo for necessário) Extensão Adobe Medium para áudio e vídeo

Preencha o campo servidor de rastreamento. O servidor de rastreamento da extensão 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> são as informações do email de provisionamento.

Todos os outros campos são opcionais.

Adobe Medium Consulte Analytics para extensão de Áudio e Vídeo.

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

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

Até este momento, a extensão Dynamic Media Viewers só estará disponível se a Propriedade de Marcas de Experience Platform for criada para desenvolvimento.

Consulte Criar uma propriedade nas Tags 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 o vídeo) serão listadas na área Extensões > Instaladas.

image2019-7-22_12-7-36

Configurar Elementos de Dados e Regras setting-up-data-elements-and-rules

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

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

Consulte Configuração de exemplo para obter uma configuração de exemplo em Marcas de Experience Platform que demonstra como rastrear um nome de ativo na carga do visualizador.

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

Publish uma biblioteca publishing-a-library

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

As tags 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 tags de Experience Platform no Experience Manager aponta o nó do autor de Experience Manager para o ambiente de preparo das tags da plataforma. O nó Experience Manager Publish aponta para o ambiente de Produção das Tags de Experience Platform. Essa organização significa que, com as configurações padrão de Experience Manager, é necessário publicar a biblioteca de tags Experience Platform no ambiente de preparo. Isso permite que você o use no autor do Experience Manager. 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 estas duas etapas:

  • Adicionar e criar uma nova biblioteca incluindo todas as alterações necessárias (novas e atualizações) na biblioteca.
  • Subir a biblioteca pelos diferentes níveis de ambiente (de desenvolvimento a preparo e produção).

Adicionar e criar uma nova biblioteca adding-and-building-a-new-library

  1. Na primeira vez que você abrir a guia Publicação nas Tags do Experience Platform, a lista da biblioteca estará 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 será criada e estará pronta para uso.

    image2019-7-15_15-3-34

    note note
    NOTE
    Na próxima vez que você alterar a configuração de Tags de Experience Platform, acesse 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 nos níveis do ambiente moving-a-library-up-through-environment-levels

  1. Depois que uma nova biblioteca é adicionada, ela é encontrada no ambiente de desenvolvimento. Para movê-lo para o nível 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 Build 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 Build & Publish para produção.

    image2019-7-15_16-8-9

    Consulte Publicação para obter mais informações sobre o processo de publicação em Marcas de Experience Platform.

Configurar o Adobe Experience Manager para a integração configuring-adobe-experience-manager-for-the-integration

Pré-requisitos:

  • O Experience Manager executa instâncias do Autor e do Publish.
  • O nó do autor do Experience Manager está configurado no Dynamic Media.
  • Os componentes do 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 IMS Experience Manager.
  • Configuração da nuvem de tags Experience Platform.

Configurar o Experience Manager IMS configuring-aem-ims

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

    07-25_11-52-58-2019

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

  3. Na página Configuração de conta técnica do Adobe IMS, na lista suspensa Solução da nuvem, selecione Coleta de dados Experience Platform.

  4. Habilite Criar novo certificado. Em seguida, no campo de texto, digite qualquer valor significativo para o certificado. Por exemplo, AdobeLaunchIMSCert. Selecione Criar certificado.

    A seguinte mensagem Info é exibida:

    Para recuperar um token de acesso válido, é necessário adicionar a chave pública do novo certificado à conta técnica do Adobe Developer!

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

    2019-07-25_12-09-24

  5. Selecione Baixar Chave Pública para baixar um arquivo de chave pública (*.crt) no sistema local.

    note note
    NOTE
    Neste ponto, deixe aberta a página Configuração de Conta Técnica do Adobe IMS; não feche a página e não selecione Avançar. Você retornará posteriormente a esta página nas etapas.

    2019-07-25_12-52-24

  6. Em uma nova guia do navegador, navegue até a Adobe Developer Console.

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

  8. Na caixa de diálogo Criar uma nova integração, verifique se o botão de opção Acessar uma API está selecionado e selecione Continuar.

2019-07-25_13-04-20

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

    07-25_13-13-54

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

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

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

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

    • No cabeçalho Selecionar uma função para a API de Tags do Experience Platform, selecione Administrador.

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

    2019-07-25_13-49-18

  3. Selecione Criar integração.

  4. Na página Integração criada, selecione Continuar com os detalhes da integração.

    07-25_14-16-33-2019

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

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

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

  6. 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 Avançar para abrir a página Conta na janela Configuração de conta técnica do Adobe IMS.

    (Se você tiver fechado a página antes, volte para o autor do Experience Manager e vá para Ferramentas > Segurança > Configurações do Adobe IMS. Selecione Criar. Na lista suspensa Solução da nuvem, selecione Marcas 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 do certificado

  7. A página Conta tem cinco campos que precisam ser preenchidos com 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 da conta

  8. Na página Conta, preencha os seguintes campos:

    • Título - Insira um título de conta descritivo.
    • 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 - como destacado abaixo.

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

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

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

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

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

  11. Carga - Retorne à página 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, é exibida semelhante ao seguinte:

    2019-07-25_22-08-30

  12. 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 Configurações do Adobe IMS.

    image2019-7-15_14-17-54

Configurar a nuvem de tags do Experience Platform para integração configuring-adobe-launch-cloud-for-the-integration

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

    2019-07-26_12-10-38

  2. Na página Configurações de tags de Experience Platform, no painel esquerdo, selecione um site de Experience Manager para o qual você deseja aplicar sua Configuração de tags de Experience Platform.

    Somente para fins de exemplo, o Site We.Retail está 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 Marcas de Experience Platform, preencha os seguintes campos:

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

    • Configuração IMS da Adobe Associada - Selecione a configuração IMS criada anteriormente em Configurar IMS do Experience Manager.

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

    • Propriedade - Na lista suspensa Propriedade, selecione a propriedade Marcas de Experience Platform que você criou anteriormente. A lista é preenchida automaticamente.

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

image2019-7-15_14-34-23

  1. Próximo ao canto superior esquerdo, selecione Avançar.

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

    No campo URI da Biblioteca (Uniform Resource Identifier), verifique o local da versão de preparo da biblioteca de Marcas de Experience Platform. O Experience Manager preenche esse campo automaticamente.

    Somente para fins de explicação, essa etapa usa bibliotecas de Tags de Experience Platform implantadas no CDN de Adobe.

    note note
    NOTE
    Verifique se o URI (Uniform Resource Identifier) da biblioteca preenchida automaticamente não está malformado. Se necessário, corrija-o para que o URI represente um URI relativo a protocolo. Isto é, começa com uma barra dupla.
    Por exemplo: //assets.adobetm.com/launch-xxxx.

    Sua página Preparação provavelmente é semelhante a esta. As opções Arquivar e Carregar Biblioteca de Forma Assíncrona estão não definidas:

    image2019-7-15_15-21-8

  3. Próximo ao canto superior direito, selecione Avançar.

  4. Na página Produção (3/3 páginas) da janela Criar Configuração de Tags de Experience Platform, se necessário, corrija o URI de produção preenchido automaticamente de modo semelhante ao que foi feito na página Preparação anterior.

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

    A nova Configuração da nuvem de tags Experience Platform agora é criada e listada ao lado do site.

  6. 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 ele é selecionado). Na barra de ferramentas, selecione Publish.

    image2019-7-15_15-47-6

Atualmente, o autor do Experience Manager não é compatível com a integração dos visualizadores do Dynamic Media com as tags de Experience Platform.

No entanto, ela é compatível com o nó de publicação do Experience Manager. Usando as configurações padrão de Configuração em nuvem de tags de Experience Platform, a publicação de Experience Manager usa o ambiente de produção de tags de Experience Platform. Dessa forma, é necessário enviar as atualizações da biblioteca de tags 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 de armazenamento temporário da biblioteca de tags Experience Platform na configuração da nuvem de tags Experience Platform para publicação no Experience Manager acima. Isso faz com que o nó de publicação do Experience Manager use a versão de Desenvolvimento ou Preparo da biblioteca de tags do Experience Platform.

Consulte Integrar tags de Experience Platform e Experience Manager para obter mais informações sobre como definir a configuração da nuvem de tags de Experience Platform.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab