Utilização da camada de dados do cliente Adobe com componentes principais AEM overview

Navegue até https://wknd.site/us/en.html

Abra as ferramentas do desenvolvedor e digite o seguinte comando no Console:

window.adobeDataLayer.getState();

Para ver o estado atual da camada de dados em um site AEM, inspecione a resposta. Você deve ver informações sobre a página e os componentes individuais.

Envie um objeto de dados para a camada de dados inserindo o seguinte no console:

window.adobeDataLayer.push({
    "component": {
        "training-data": {
            "title": "Learn More",
            "link": "learn-more.html"
        }
    }
});

Execute o comando adobeDataLayer.getState() novamente e localize a entrada para training-data.

Em seguida, adicione um parâmetro de caminho para retornar apenas o estado específico de um componente:

window.adobeDataLayer.getState('component.training-data');

Digite o seguinte método auxiliar no console:

function getDataObjectHelper(event, filter) {
    if (event.hasOwnProperty("eventInfo") && event.eventInfo.hasOwnProperty("path")) {
        var dataObject = window.adobeDataLayer.getState(event.eventInfo.path);
        if (dataObject != null) {
            for (var property in filter) {
                if (!dataObject.hasOwnProperty(property) || (filter[property] !== null && filter[property] !== dataObject[property])) {
                    return;
                }
                return dataObject;
            }
        }
    }
    return;
}

O código acima inspeciona o objeto event e usa o método adobeDataLayer.getState para obter o estado atual do objeto que acionou o evento. O método auxiliar inspeciona o filter e somente se o dataObject atual atender aos critérios de filtro ele será retornado.

Em seguida, insira um manipulador de eventos chamado quando um componente Teaser for exibido em um Carrossel.

function teaserShownHandler(event) {
    var dataObject = getDataObjectHelper(event, {"@type": "wknd/components/carousel/item"});
    if(dataObject != null) {
        console.log("Teaser Shown: " + dataObject['dc:title']);
        console.log(dataObject);
    }
}

A função teaserShownHandler chama a função getDataObjectHelper e passa um filtro de wknd/components/carousel/item como @type para filtrar eventos acionados por outros componentes.

Em seguida, envie um ouvinte de eventos por push para a camada de dados para ouvir o evento cmp:show.

window.adobeDataLayer.push(function (dl) {
     dl.addEventListener("cmp:show", teaserShownHandler);
});

O evento cmp:show é acionado por vários componentes diferentes, como quando um novo slide é mostrado no Carrossel ou quando uma nova guia é selecionada no componente Guia.

Na página, alterne os slides do carrossel e observe as instruções do console:

Para interromper a escuta do evento cmp:show, remova o ouvinte do evento da camada de dados

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function(dl) {
    dl.removeEventListener("cmp:show", teaserShownHandler);
});

Retorne à página e alterne os slides do carrossel. Observe que não há mais instruções registradas e que o evento não está sendo ouvido.

Em seguida, crie um manipulador de eventos que é chamado quando o evento de exibição de página é acionado:

function pageShownHandler(event) {
    var dataObject = getDataObjectHelper(event, {"@type": "wknd/components/page"});
    if(dataObject != null) {
        console.log("Page Shown: " + dataObject['dc:title']);
        console.log(dataObject);
    }
}

Observe que o tipo de recurso wknd/components/page é usado para filtrar o evento.

Em seguida, envie um ouvinte de eventos por push para a camada de dados para ouvir o evento cmp:show, chamando o pageShownHandler.

window.adobeDataLayer = window.adobeDataLayer || [];
window.adobeDataLayer.push(function (dl) {
     dl.addEventListener("cmp:show", pageShownHandler);
});

Você deve ver imediatamente uma instrução do console acionada com os dados da página:

O evento cmp:show para a página é acionado em cada carregamento de página na parte superior da página. Você pode perguntar, por que o manipulador de eventos foi acionado quando a página claramente já foi carregada?

Um dos recursos exclusivos da Camada de Dados de Clientes Adobe é registrar ouvintes de eventos antes ou depois de a Camada de Dados ter sido inicializada. Isso ajuda a evitar as condições de corrida.

A Camada de dados mantém uma matriz de filas de todos os eventos que ocorreram em sequência. A Camada de Dados por padrão disparará retornos de chamada de evento para eventos que ocorreram no passado e eventos no futuro. É possível filtrar os eventos do passado ou do futuro. Mais informações podem ser encontradas na documentação.