Integração

Carregar e acionar uma chamada do Target

Última atualização em 2023-10-12
  • Criado para:
  • Intermediate
    Developer

AEM Sites as a Cloud Service, AEM Sites 6.5

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 do Launch. 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 Launch 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

Configuração de evento e código personalizado mostrados na página

Na propriedade do Launch, adicione um novo Evento para o Regra

  • Extensão: Núcleo
  • Tipo de evento: Custom Code
  • Nome: Página Mostrar manipulador de eventos (ou algo descritivo)

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 Launch 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 Launch Rule, passing in the new `event` object
        // the `event` obj can now be referenced by the reserved name `event` by other Launch data elements
        // i.e `event.component['someKey']`
        trigger(launchEvent);
   }
}

// With the AEM Core Component event handler, that proxies the event and relevant information to Adobe Launch, 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 pageShownEventHandlere escuta os eventos emitidos pelos Componentes principais do AEM, obtém as informações relevantes do Componente principal, compacta-o em um objeto de evento e aciona o Evento de inicialização com as informações do evento derivadas em sua carga.

A regra do Launch é acionada usando o 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 pega um objeto de evento como um parâmetro que, por sua vez, é exposto nos Elementos de dados do Launch por outro nome reservado no Launch chamado event. Os elementos de dados no Launch agora podem fazer referência a dados desse objeto de evento na 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 do Launch.

Elementos de dados

Elementos de dados

Os Elementos de dados do Adobe Launch 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.

ID da página

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.

Caminho da página

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.

Título da página

Resolução de problemas

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

Erro de domínio do cookie de destino

> 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

Nesta página