Show Menu
TÓPICOS×

Extensão do AEM Asset Insights

Esta extensão deve ser usada juntamente com o AEM Asset Insights . Mais especificamente, ela substitui o processo “pageTracker” e o código incorporado. Quando configurada, essa extensão envia as métricas Impressão e Clique do ativo para o Adobe Analytics, depois elas são importadas para os relatórios do AEM Asset Insights. As métricas do ativo podem ser informadas usando o AEM Asset Insights ou o Adobe Analytics Project Workspaces.

Pré-requisitos da extensão

Analytics

Os relatórios do AEM Asset no Analytics contêm três dimensões do AEM:
  • ID do ativo
  • Origem do ativo
  • Ativo clicado
Há também duas métricas:
  • Impressões do ativo
  • Cliques em ativos.
Esses relatórios devem ser ativados usando o Administrador do Analytics (clique em Analytics > Admin > Report Suites >  <report suite>  > Edit Settings > AEM > AEM Assets Reporting ) antes que eles possam ser preenchidos com essa extensão.
A extensão “ Adobe Analytics ” do Launch deve ser instalada na mesma Propriedade da Web do Launch.

Adobe Experience Manager (AEM)

  1. Ative o AEM Asset Insights . No AEM, clique em Tools > Assets , em seguida, abra o painel Insights Configuration .
  2. Desative o rastreamento de UUID.
    Essa extensão não funcionará se a configuração Disable UUID Tracking do AEM Asset estiver marcada. Ela está desmarcada por padrão.

Configurar o Adobe Experience Manager (AEM)

Esta seção descreve como configurar o AEM com o Launch, como ativar o Asset Insight no AEM e como ativar o rastreamento de UUID para o Assets.

Integrar o AEM com o Adobe Launch

A integração recomendada do Adobe Launch com o Adobe Experience Manager é feita via Adobe I/O.

Ativar o Asset Insight no AEM

Para obter instruções sobre como ativar o Asset Insights, consulte o Guia do usuário do Experience Manager 6.5 .

Ativar o rastreamento de UUID para o Assets

Rastrear ativos no Analytics usando a UUID do ativo no AEM.
Para habilitar o rastreamento com a UUID do ativo, abra o console de política do componente do modelo editável e desmarque a propriedade “Desabilitar rastreamento UUID”. (Por padrão, essa propriedade é verificada para o componente de imagem OOTB.)
Depois de ativar o UUID, você deve ver o elemento de dados “data-asset-id” que está preenchido com a UUID do ativo. O Analytics rastreia o clique ou impressão do ativo com essa UUID.

Uso de extensão

Essa extensão tem dois eventos e uma ação.
  • Ativo clicado: um evento que é acionado quando o visitante clica em um AEM Asset que está ativado para rastreamento e tem um destino (atributo href).
  • Ativo clicado (sem destino): um evento que é acionado quando o visitante clica em um AEM Asset que está ativado para rastreamento e não tem um destino (nenhum atributo href).
  • Definir variáveis AA: uma ação que define as variáveis do Analytics reservadas para o AEM Assets (variáveis de dados de contexto a.assets.source , a.assets.idlist e a.asset.clickedid ) dependendo de qual evento foi usado e como o evento e a ação são configurados. Essa extensão não usa eventos, props ou eVars do Analytics.

Impressões do ativo

Adicione a ação “Definir variáveis AA” a uma regra do Launch nova ou existente que é acionada em cada página e envia uma solicitação de imagem do Analytics. A ação “Definir variáveis AA” deve aparecer antes da ação “Adobe Analytics - Enviar beacon”. Ações adicionais podem ser adicionadas, conforme necessário.
Na página de configuração #, selecione a opção # (padrão). Essa ação definirá somente o evento de impressões para ativos que são realmente vistos pelo visitante.
Embora não seja recomendado, a ação “Definir variáveis AA” também aceita uma opção “carregada”, que envia impressões de ativos para cada ativo na página, independentemente de o visitante os ter visto ou não.

Cliques no ativo

Configure uma segunda regra usando o evento “Ativo clicado” e a ação “Definir variáveis AA”. O evento “Ativo clicado” deve ser configurado para que a “Solicitação de imagem de ativo clicado” seja definida como “No carregamento da página” (padrão). Esta regra não requer nenhuma ação do Adobe Analytics (como Enviar beacon) porque a ID do ativo será salva em sessionStorage e enviada pela próxima regra de impressões.
O evento “Ativo clicado” também oferece suporte à configuração “Solicitação de imagem de ativo clicado” de “No clique”. Essa configuração envia a métrica de clique para o Analytics imediatamente e exige uma ação “Enviar beacon” do Analytics.
Configure uma terceira regra que será acionada quando houver Ativos nas páginas que não têm um destino (nenhum atributo href ). No mínimo, a nova regra precisa usar o evento “Ativo clicado (Sem destino)”, bem como as ações “Definir variáveis AA” e “Adobe Analytics - Enviar beacon”. Condições e ações adicionais podem ser adicionadas, conforme necessário.

Dicas de teste de extensão

Configure três regras conforme descrito acima:
  • Impressões do ativo
  • Cliques no ativo
  • Cliques no ativo sem destino
Impressões
  1. Acesse uma página que contém AEM Assets.
  2. Se não houver ativos visíveis no navegador, role a página até que você possa ver pelo menos um ativo e clicar nele ou navegar para outra página.
  3. Examine a solicitação de imagem do Analytics.
    Se a.assets.idlist contiver as IDs de ativo que estavam visíveis na página anterior, a regra está funcionando corretamente.
    Se a.assets.idlist não estiver na solicitação de imagem, é provável que isso aconteça por um dos dois motivos:
    • Nunca houve um ativo na área de visualização do navegador
    • Não havia ativos na página configurada com o Asset Insights habilitado no AEM.
Cliques
  1. Acesse uma página que contém AEM Assets.
  2. Clique em um dos ativos.
Na solicitação de imagem resultante do Analytics (da próxima página), se a.assets.idlist tiver as IDs de ativo na página de destino e a.assets.clickedid tiver a ID do ativo que foi clicado na página de origem, a regra está funcionando corretamente.
Se a.assets.clickedid não estiver na solicitação de imagem, é provável que o ativo que foi clicado não tenha o Asset Insights habilitado no AEM.
Cliques sem destino
  1. Acesse uma página que contenha pelo menos um AEM Assets que não tenha destino (nenhum atributo href ).
  2. Clique nesse ativo.
Na solicitação de imagem resultante do Analytics, se a.assets.clickedid tiver a ID do ativo, a regra está funcionando corretamente.
Se a.assets.clickedid não estiver na solicitação de imagem, é provável que o ativo que foi clicado não tenha o Asset Insights habilitado no AEM.