[Integração]{class="badge positive"}

Carregar e acionar uma chamada do Target load-fire-target

[AEM Sites as a Cloud Service, AEM Sites 6.5]{class="badge informative"}

Saiba como carregar, transmitir parâmetros para solicitação de página e acionar uma chamada do Target na página do site usando uma regra de tags. As informações da página da Web são recuperadas e passadas como parâmetros usando a Camada de dados do cliente Adobe, que permite coletar e armazenar dados sobre a experiência do visitante em uma página da Web e, em seguida, facilitar o acesso a esses dados.

Regra de carregamento de página

A Camada de dados de clientes Adobe é uma camada de dados orientada por eventos. Quando a camada de dados da página AEM é carregada, ela aciona um evento cmp:show . No vídeo, a variável tags Library Loaded A regra é invocada usando um evento personalizado. Abaixo, você pode encontrar os trechos de código usados no vídeo para o evento personalizado e para os elementos de dados.

Evento de exibição de página personalizada page-event

Na propriedade tags, adicione um novo Evento para o Regra

Toque no Abrir editor e cole no seguinte trecho de código. Este código deve ser adicionado ao Configuração de evento e uma Ação.

// Define the event handler function
var pageShownEventHandler = function(coreComponentEvent) {

    // Check to ensure event trigger via AEM Core Components is shaped correctly
    if (coreComponentEvent.hasOwnProperty("eventInfo") &&
        coreComponentEvent.eventInfo.hasOwnProperty("path")) {

        // Debug the AEM Component path the show event is associated with
        console.debug("cmp:show event: " + coreComponentEvent.eventInfo.path);

        // Create the tags Event object
        var launchEvent = {
            // Include the ID of the AEM Component that triggered the event
            id: coreComponentEvent.eventInfo.path,
            // Get the state of the AEM Component that triggered the event
            component: window.adobeDataLayer.getState(coreComponentEvent.eventInfo.path)
        };

        // Trigger the tags Rule, passing in the new `event` object
        // the `event` obj can now be referenced by the reserved name `event` by other tags data elements
        // i.e `event.component['someKey']`
        trigger(launchEvent);
   }
}

// With the AEM Core Component event handler, that proxies the event and relevant information to Data Collection, defined above...

// Initialize the adobeDataLayer global object in a safe way
window.adobeDataLayer = window.adobeDataLayer || [];

// Push the event custom listener onto the Adobe Data Layer
window.adobeDataLayer.push(function (dataLayer) {
   // Add event listener for the `cmp:show` event, and the custom `pageShownEventHandler` function as the callback
   dataLayer.addEventListener("cmp:show", pageShownEventHandler);
});

Uma função personalizada define o pageShownEventHandler, e ouve eventos emitidos pelos Componentes principais do AEM, deriva as informações relevantes do Componente principal, empacota-o em um objeto de evento e aciona as tags Evento com as informações do evento derivado em sua carga.

A regra de tags é acionada usando o da tag trigger(...) função que é somente disponível em uma definição de trecho de código personalizado do Evento de regra.

A variável trigger(...) A função utiliza um objeto de evento como um parâmetro que, por sua vez, é exposto em tags Elementos de dados, por outro nome reservado em tags chamadas event. Os elementos de dados nas tags agora podem fazer referência a dados desse objeto de evento da event objeto usando sintaxe como event.component['someKey'].

Se trigger(...) for usado fora do contexto de um tipo de evento Código personalizado do evento (por exemplo, em uma Ação), o erro de JavaScript trigger is undefined é lançado no site integrado à propriedade das tags.

Elementos de dados

Os elementos de dados das tags mapeiam os dados do objeto de evento acionado no evento personalizado Exibição de página para variáveis disponíveis no Adobe Target, por meio do Tipo de elemento de dados de código personalizado da extensão principal.

Elemento de dados da ID da página

if (event && event.id) {
    return event.id;
}

Esse código retorna a ID exclusiva gerada pelo Componente principal.

Elemento de dados do caminho da página

if (event && event.component && event.component.hasOwnProperty('repo:path')) {
    return event.component['repo:path'];
}

Esse código retorna o caminho da página AEM.

Elemento de dados do título da página

if (event && event.component && event.component.hasOwnProperty('dc:title')) {
    return event.component['dc:title'];
}

Esse código retorna o título da página AEM.

Resolução de problemas

Por que as mboxes não estão sendo acionadas nas minhas páginas da Web?

Mensagem de erro quando o cookie mboxDisable não está definido

> AT: [page-init] Adobe Target content delivery is disabled. Ensure that you can save cookies to your current domain, there is no "mboxDisable" cookie and there is no "mboxDisable" parameter in the query string.

Solução

Os clientes do, às vezes, usam instâncias baseadas em nuvem com o Target para testes ou fins de prova de conceito simples. Esses domínios e muitos outros fazem parte da Lista de sufixos públicos.
Se estiver usando esses domínios, os navegadores modernos não salvarão os cookies, a menos que você personalize o cookieDomain configuração usando targetGlobalSettings().

window.targetGlobalSettings = {
   cookieDomain: 'your-domain' //set the cookie directly on this subdomain, for example: 'publish-p1234-e5678.adobeaemcloud.com'
};

Próximas etapas

Links de suporte