Configurar o Asset Insights com o AEM Assets e o Adobe Experience Platform Launch

Nesta série de vídeos de 5 partes, percorremos a configuração do Asset Insights para o Experience Manager implantado por meio do Adobe Launch.

Parte 1: Visão geral do Asset Insights

Visão geral do Asset Insights. Instale os Componentes principais, o Componente de imagem de amostra e outros pacotes de conteúdo para preparar o ambiente.

Diagrama de arquitetura

Diagrama de arquitetura

ATENÇÃO

Faça o download da versão mais recente dos Componentes principais para sua implementação.

O vídeo usa os Componentes principais v2.2.2, que não são mais a versão mais recente; certifique-se de usar a versão mais recente antes de prosseguir para a próxima seção.

Parte 2 : Ativar o rastreamento do Asset Insights para o componente de imagem de amostra

Aprimoramentos aos Componentes principais e uso do componente proxy (Componente de imagem de exemplo) para o Asset Insights. Editar as políticas do modelo da página de conteúdo para ativar o componente de imagem de amostra para o site de referência.

OBSERVAÇÃO

O Componente principal de imagem inclui a capacidade de desativar o rastreamento de UUID ao desativar o rastreamento de UUID do ativo (valor identificador exclusivo para um nó criado no JCR)

O componente Imagem principal usa o atributo data-asset-id dentro do pai <div> de uma tag de imagem para ativar/desativar esse recurso. O Componente de proxy substitui o componente principal pelas seguintes alterações.

  • Remove o data-asset-id do div pai de um elemento <img> dentro do image.html
  • Adiciona data-aem-asset-id diretamente ao elemento <img> dentro do image.html
  • Adiciona o valor data-trackable='true' ao elemento <img> dentro da imagem.html
  • data-aem-asset- idand data-trackable='true' são mantidos no mesmo nível de nó
OBSERVAÇÃO

data-aem-asset-id='image.UUID' e data-trackable='true' são os atributos principais que precisam estar presentes para as Impressões de ativos. Para o Asset Click Insights, além dos atributos de dados acima presentes na tag <img> , a tag principal <a> deve ter um valor href válido.

Parte 3: Adobe Analytics — Criação de conjunto de relatórios, permitindo a coleta de dados em tempo real e os Relatórios do AEM Assets

O conjunto de relatórios com coleta de dados em tempo real é criado para o rastreamento de ativos. A configuração do AEM Assets Insights é configurada usando as credenciais do Adobe Analytics.

OBSERVAÇÃO

A coleta de dados em tempo real e os Relatórios de ativos do AEM precisam ser ativados para seu Conjunto de relatórios do Adobe Analytics. Ativar o Relatórios de ativos do AEM reserva variáveis de análise para rastrear insights de ativos.

Para a configuração do AEM Assets Insights, você precisa das seguintes credenciais

  • Centro de dados
  • Nome da empresa do Analytics
  • Nome de usuário do Analytics
  • Segredo compartilhado (pode ser obtido em Adobe Analytics > Admin > Configurações da empresa > Serviço da Web).
  • Report Suite (Certifique-se de selecionar o Report Suite correto que é usado para o Asset Reporting)

Parte 4: Uso do Adobe Experience Platform Launch para adicionar a extensão do Adobe Analytics

Adicionar a extensão do Adobe Analytics, criar regras de carregamento da página e integrar o AEM ao Launch com a conta técnica do Adobe IMS.

OBSERVAÇÃO

Certifique-se de replicar todas as alterações da instância do autor para a instância de publicação.

Artigo 1º : Rastreador de página (pagetracker.js)

//For AEM 6.3
<script type="text/javascript" src="http://localhost:4503/etc/clientlibs/foundation/assetinsights/pagetracker.js"></script>
//For AEM 6.4
<script type="text/javascript" src="http://localhost:4503/etc.clientlibs/dam/clientlibs/assetinsights/pagetracker.js"></script>

O rastreador de página implementa duas chamadas de retorno (registradas no código incorporado do ativo)

  • &lt;code>assetAnalytics.core.assetLoaded&lt;/code> <code><code>: chamado quando o evento 'load' é despachado para o elemento asset-DOM.</code></code>
  • &lt;code>assetAnalytics.core.assetClicked&lt;/code> <code><code>: chamado quando o evento 'click' é despachado para o elemento asset-DOM, isso é relevante somente quando o elemento asset-DOM tem uma tag de âncora como principal com um atributo 'href' externo válido</code></code>

Por fim, o Pagetracker implementa uma função de inicialização como .

  • &lt;code>assetAnalytics.dispatcher.init()&lt;/code> <code><code>: chamado para inicializar o componente Pagetracker .</code></code> Isso DEVE ser chamado antes que qualquer um dos eventos do asset-insights (impressões e/ou cliques) seja gerado na página da Web.
  • &lt;code>assetAnalytics.dispatcher.init()&lt;/code> <code><code>: aceita opcionalmente um objeto AppMeasurement — se fornecido, ele não tenta criar uma nova instância do objeto AppMeasurement.</code></code>

Regra 2: Rastreador de imagem — Ação 1 (asset-insights.js)

/*
 * AEM Asset Insights
 */

var sObj = window.s;
_satellite.notify('in assetAnalytics customInit');
(function initializeAssetAnalytics() {
 if ((!!window.assetAnalytics) && (!!assetAnalytics.dispatcher)) {
 _satellite.notify('assetAnalytics ready');
 /** NOTE:
  Copy over the call to 'assetAnalytics.dispatcher.init()' from Assets Pagetracker
  Be mindful about changing the AppMeasurement object as retrieved above.
  */
 assetAnalytics.dispatcher.init(
                                "",  /** RSID to send tracking-call to */
                                "",  /** Tracking Server to send tracking-call to */
                                "",  /** Visitor Namespace to send tracking-call to */
                                "",  /** listVar to put comma-separated-list of Asset IDs for Asset Impression Events in tracking-call, e.g. 'listVar1' */
                                "",  /** eVar to put Asset ID for Asset Click Events in, e.g. 'eVar3' */
                                "",  /** event to include in tracking-calls for Asset Impression Events, e.g. 'event8' */
                                "",  /** event to include in tracking-calls for Asset Click Events, e.g. 'event7' */
                                sObj  /** [OPTIONAL] if the webpage already has an AppMeasurement object, please include the object here. If unspecified, Pagetracker Core shall create its own AppMeasurement object */
                                );
 sObj.usePlugins = true;
 sObj.doPlugins = assetAnalytics.core.updateContextData;
}
 else {
 _satellite.notify('assetAnalytics not available. Consider updating the Custom Page Code', 4);
 }
})();

Regra 2: Rastreador de imagem — Ação 2 (image-tracker.js)

/*
 * AEM Asset Insights
 */

document.querySelectorAll('[data-aem-asset-id]').forEach(function(element) {
    assetAnalytics.core.assetLoaded(element);
    var parent = element.parentElement;
    if (parent.nodeName == "A") {
        parent.addEventListener("click", function() {
            assetAnalytics.core.assetClicked(this)
        });
    }
});
  • assetAnalytics.core.assetLoaded() : é chamado quando o carregamento da página é concluído e aciona Impressões de ativos para todas as imagens rastreáveis
  • Variável do Analytics que contém a lista de ativos carregados : contextData['c.a.assets.idList']
  • assetAnalytics.core.assetClicked() : é chamado quando o elemento DOM do ativo tem uma tag de âncora com valor href válido. Quando um ativo é clicado, um cookie é criado com a ID do ativo clicado como seu valor.(Nome do cookie: a.assets.clickedid)
  • Variável do Analytics que contém a lista de ativos carregados : contextData['c.a.assets.clickedid']
  • Origem : contextData['c.a.assets.source']

Declarações de depuração do console

//Launch Build Info
_satellite.buildInfo

//Enables debug messages
_satellite.setDebug(true);

//Asset Insight JS Object
assetAnalytics

//List of trackable images
document.querySelectorAll(".cmp-image__image");

Duas extensões de navegador Google Chrome são mencionadas no vídeo como maneiras de depurar o Analytics. Extensões semelhantes também estão disponíveis para outros navegadores.

Também é possível alternar o DTM para o modo de depuração com a seguinte Extensão do Chrome: Iniciar e Comutador DTM. Isso facilita ver se há erros relacionados à implantação do DTM. Além disso, é possível alternar manualmente o DTM para o modo de depuração por meio de qualquer navegador ferramentas do desenvolvedor -> Console JS adicionando o seguinte trecho:

Parte 5 : Testando o rastreamento analítico e sincronizando dados de insight

Configuração do AEM Asset Reporting Sync Job Scheduler e do Relatório do Assets Insights

Nesta página