Show Menu
TÓPICOS×

Adobe Experience Manager ContextHub tool

Use a ferramenta AEM ContextHub para integrar o Gerenciamento dinâmico de tags (DMT) ao Adobe Experience Manager (AEM) ContextHub (versão da camada de dados no AEM). Use-a também para integrar o DTM a qualquer camada de dados, mesmo em sites que não usam o AEM.
Com frequência, os clientes do DTM usam elementos de dados para mapear as camadas de dados de seus sites. Por exemplo, a camada de dados pode informar que um usuário está interessado em um produto específico, ou colocou um item no carrinho de compras. O DTM pode usar essas informações de várias formas, em condições e ações de estabelecimento de regras. Isso inclui o envio de dados ao Analytics, para uso em relatórios, ou ao Target, para a exibição de conteúdo personalizado para o usuário.
A ferramenta AEM ContextHub resolve muitos problemas associados às camadas de dados. Algumas camadas de dados não são carregadas no início da página. Outras são dinâmicas ou assíncronas e mudam frequentemente, acompanhando as mudanças da página. No passado, essas questões tornavam o envio de dados e o início eficiente de ações um problema para o DTM.
A ferramenta AEM ContextHub elimina a necessidade de gravar o código personalizado que ela verifica frequentemente para determinar se a camada de dados muda, é carregada fora do início da página ou muda com suas alterações.
Por exemplo, suponhamos que um cliente coloque e retire um item do carrinho de compras. Se a página não for atualizada conforme a camada de dados muda, o DTM não reconhecerá a alteração sem uma adição de código personalizada. A ferramenta AEM ContexHub contém um mecanismo de sondagem que verifica a cada segundo para determinar se há alguma alteração.
Como o DTM agora consegue preencher antecipadamente elementos de dados usando a camada de dados, os usuários também podem usar os elementos de dados do AEM ContextHub junto com condições lançadas anteriormente, como o Valor de elemento de dados. Isso possibilita gerenciar valores da camada de dados quando a página é carregada, ou combinar a condição de Valor de elemento de dados com o evento dataelementchanged , nos casos de mudança da camada de dados em função de interação com o usuário.
Ao configurar essa ferramenta, pode-se usar a definição padrão para se integrar ao AEM ContextHub ou personalizar a estrutura para trabalhar com qualquer site.
  1. Click <Web Property Name> > Overview > Add a Tool > AEM ContextHub .
  2. Especifique um nome descritivo para a ferramenta.
    This name displays on the Overview tab under Installed Tools.
  3. Click Create Tool to display the AEM ContextHub Settings page.
  4. Preencha os campos:
    Elemento
    Descrição
    Usar a camada padrão de dados do ContextHub
    Use o formato do AEM ContextHub. Com esta opção selecionada, o DTM consulta o esquema padrão do ContextHub para essa integração. Se você tiver alterado seu esquema do ContextHub ou quiser usar outra camada de dados, use a opção personalizada.
    Personalizar a camada de dados do ContextHub
    Use um formato personalizado que mapeie a estrutura da camada de dados de qualquer site, mesmo que ele não use o AEM. Essa opção permite editar seu esquema de camada de dados. Por padrão, ela preenche a janela de edição com a camada de dados padrão do ContextHub, e você pode fazer alterações ou substituí-la totalmente pelo seu código.
    Abrir editor
    Se você optar por Personalizar a camada de dados do ContextHub, pode usar o editor para inserir seu código personalizado.
    Adicionar uma observação
    Adicione observações sobre essa implementação.
  5. Clique em Save Changes .

Data layer management using the ContextHub tool

A ferramenta AEM ContextHub do Dynamic Tag Management (DTM) pode ser usada para implementações de camadas de dados genéricas e do ContextHub. O esquema da camada de dados do ContextHub é carregado por padrão na ferramenta e fornece uma integração simples com Adobe Experience Manager lojas ContextHub (AEM). São fornecidos exemplos da implementação padrão do ContextHub e uma implementação de camada de dados genérica personalizada.

Pré-requisitos

Para usar a ferramenta ContextHub, você deve cumprir estes pré-requisitos:
  • Uma camada de dados de objeto ContextHub ou Javascript existente no site.
  • Um esquema JSON que defina corretamente a camada de dados em uso no site.
  • Uma propriedade da Web do DTM ativa em uso no site.

AEM ContextHub tool components

A ferramenta AEM ContextHub adiciona dois itens de funcionalidade ao DTM:
  • A definição da camada de dados
  • O tipo de camada de dados do AEM ContextHub
Além disso, para facilitar o monitoramento da camada de dados, foi adicionado um novo tipo de evento chamado dataelementchanged . Esse tipo de evento pode ser usado independentemente da ferramenta AEM ContextHub.
Cada área funcional corresponde a uma etapa de configuração descrita nos dois exemplos abaixo.

Data element monitoring

The new dataelementchanged event type monitors any changes that occur to a specific data element value during a page view. As observações a seguir devem ser levadas em conta quando se usa esse tipo de evento.
  1. O elemento de dados deve mapear para um valor simples do Javascript. Valores complexos, como matrizes e objetos retornados em um script personalizado de elemento de dados, não funcionarão corretamente. Parâmetros de cookies, de seletores de CSS e de URL também produzem resultados inesperados e talvez não funcionem de forma alguma. Valores simples, como sequências de caracteres e números inteiros, funcionam bem.
  2. Seja cauteloso no número de tipos de evento de dataelementchanged referenciado em uma única página. Embora o monitoramento seja eficiente, números elevados de avaliações talvez prejudiquem o desempenho da página.
  3. O tipo de evento dataelementchanged funciona somente na exibição da página atual, pois este é um sistema de monitoramento baseado em DOM.
  4. O monitor de elementos de dados investiga os valores.

ContextHub data layer default example

Example using the AEM ContextHub tool that references and uses the default ContextHub data layer within the Dynamic Tag Management configuration.
A camada de dados do ContextHub será carregada em um site de teste Adobe Experience Manager (AEM), mas o ContextHub pode ser usado separado do AEM. Entre em contato com seu representante da Adobe caso deseje usar o ContextHub separado do AEM.
Todos os armazenamentos do ContextHub podem ser referenciados no console do navegador.
O monitor de camadas de dados do DTM é iniciado antes de qualquer outra função do DTM; por isso, os exemplos não implantarão a camada de dados por meio do DTM, embora seja possível fazê-lo. Em vez disso, eles dependerão da camada de dados gerada no servidor. Caso contrário, poderia haver avisos do Javascript, pois determinados valores de camada de dados talvez não estejam disponíveis.

Definir a camada de dados

A primeira etapa na configuração da ferramenta AEM ContextHub é adicioná-la a uma propriedade da Web.
No momento, apenas uma ferramenta AEM contexthub é permitida por propriedade da Web do DTM.
  1. Click <Web Property Name> > Overview > Add a Tool > AEM ContextHub .
  2. Especifique um nome descritivo para a ferramenta.
  3. Click Create Tool to display the AEM ContextHub Settings page.
  4. Select Use Default ContextHub Data Layer to leverage the standard ContextHub stores.
    Ou
    Select Customize ContextHub Data Layer to modify the schema. É necessário usar a opção personalizada se uma camada de dados fora do padrão do ContextHub estiver sendo usada na implementação.
    A Raiz da camada de dados padrão permite acesso a todos os armazenamentos do ContextHub. Em vista da natureza dinâmica dos armazenamentos do ContextHub, há funções adicionais disponíveis com essa camada de dados e não na referência de objeto do Javascript simples usada pela abordagem de camada de dados genérica.
  5. (Conditional) To use a custom data layer, click Open Editor to view the data layer schema definition. If the custom data layer is a modification of the ContextHub schema be sure to add “ContextHub” in the Data Layer Root field.
    O esquema padrão do ContextHub é preenchido no editor.
    1. Modifique o esquema conforme necessário para que corresponda ao da camada de dados do site.
    2. Click Save and Close to save the schema and close the editor.
  6. Clique em Save Changes .

Criar um elemento de dados da camada de dados

  1. In the web property, click the Rules tab, then click Data Elements in the left menu.
  2. Clique em Create New Data Element .
  3. Especifique um nome para o elemento de dados. Neste exemplo, atribua o nome "total_price".
  4. From the Type drop-down list, select AEM ContextHub .
    O nome da ferramenta AEM ContextHub aparecerá em “Origem”, mas, na versão atual, só pode ser definida uma ferramenta AEM ContextHub.
  5. Mapeie o elemento de dados para a camada de dados selecionando um caminho no seletor de Objeto.
    Neste exemplo, selecione o objeto cart.totalPriceFloat .
  6. Clique em Save Data Element .

Criar uma regra baseada em eventos que use o tipo de evento de alteração de elemento de dados

  1. In the web property, click the Rules tab, then click Event Based Rules in the left menu.
  2. Clique em Create New Rule .
  3. Atribua um nome à regra. Neste exemplo, atribua o nome "cart_total_update".
  4. Expanda a seção Condições.
  5. From the Event Type drop-down list, select dataelementchanged .
  6. Selecione o elemento de dados criado na seção anterior (total_price).
  7. Under Rule Conditions , select Data Element Value from the drop-down list, then click Add Criteria .
  8. Selecione o elemento de dados criado na seção anterior (total_price) e atribua um valor que provoque o acionamento da regra.
    Neste exemplo, é usada uma expressão regular para avaliar qualquer condição maior ou igual a 50: ^([5-9]\d|[1-9]\d{2,})$
    Se os valores do elemento de dados forem usados dessa forma como condições, é importante que as configurações do elemento de dados sejam consideradas na correspondência. For example, selecting the Force Lowercase Value option in the data element settings would convert the value to all lowercase before evaluation. Como o Javascript distingue maiúsculas de minúsculas, “test” não seria o mesmo que “Test” e a condição não seria acionada como esperado.
  9. Expand the Javascript / Third Party Tags section.
  10. Clique em Add New Script .
  11. Adicione um Javascript não sequencial que notifique se a regra for acionada. Atribua à regra o nome “big_money_alert” e adicione um script de alerta semelhante ao do exemplo a seguir:
    alert('$' + _satellite.getVar(‘total_price’) + ‘ is big money!’);
  12. Click Save Code , then click Save Rule .

Valide a implementação

No site habilitado pelo DTM que executa a propriedade da Web acima, valide a implementação.
  • No console do desenvolvedor, verifique se há a camada de dados ( ContextHub ).
  • Mude o objeto da camada de dados que está sendo monitorada para um valor que NÃO corresponda à condição acima: ContextHub.setItem('/store/cart/totalPriceFloat','5');
  • Mude o objeto da camada de dados que está sendo monitorada para um valor que CORRESPONDA à condição acima: ContextHub.setItem('/store/cart/totalPriceFloat','52');
  • Neste exemplo de implementação, deverá aparecer uma caixa de alerta:
Se a depuração do DTM estiver ativada, a falha de avaliação deverá aparecer no console.

Custom data layer example

Example using the AEM ContextHub tool that references and uses a custom, non-ContextHub data layer within the Dynamic Tag Management configuration.
The example data layer ( _dl ) will be loaded on the test web page as a Javascript object definition in the <head/> section of the page before the DTM embed code is referenced.
<head> 
    <script> 
        window._dl = { 
            page: { 
                name: 'homepage', 
                quantity: 1, 
                friend: 'No one' } 
        } 
    </script> 
    <script src="//assets.adobedtm.com/satelliteLib-*.js"></script> 
</head> 

O monitor de camadas de dados do DTM (veja abaixo) é iniciado antes de qualquer outra função do DTM; por isso, os exemplos não implantarão a camada de dados por meio do DTM. Caso contrário, poderia haver avisos do Javascript, pois determinados valores de camada de dados talvez não estejam disponíveis.

Definir a camada de dados

A primeira etapa na configuração da ferramenta AEM ContextHub é adicioná-la a uma propriedade da Web.
No momento, apenas uma ferramenta AEM contexthub é permitida por propriedade da Web do DTM.
  1. Click <Web Property Name> > Overview > Add a Tool > AEM ContextHub .
  2. Especifique um nome descritivo para a ferramenta.
  3. Click Create Tool to display the AEM ContextHub Settings page.
  4. Select Customize ContextHub Data Layer to modify the schema.
    A root Javascript object name must be added to the Data Layer Root field for non-ContextHub data layers. _dl A definição é usada nos exemplos genéricos nesta seção.
  5. Click Open Editor to view the data layer schema definition.
    Por padrão, o esquema padrão do ContextHub é preenchido no editor.
  6. Exclua o esquema padrão e cole no esquema da camada de dados do site.
    A amostra de esquema não pertencente ao ContextHub a seguir é usada nos exemplos genéricos:
    { 
      "$schema": "https://json-schema.org/draft-04/schema#", 
      "type": "object", 
      "properties": { 
        "page": { 
          "type": "object", 
          "properties": { 
            "name": { 
              "type": "string" 
            }, 
            "quantity": { 
              "type": "number" 
            }, 
            "friend": { 
              "type": "string" 
            } 
          }, 
          "required": [ 
            "name", 
            "quantity", 
            "friend" 
          ] 
        } 
       }, 
      "required": [ 
        "page" 
      ] 
    } 
    
    
  7. Click Save and Close to save the schema and close the editor, then click Save Changes .

Criar um elemento de dados da camada de dados

  1. In the web property, click the Rules tab, then click Data Elements in the left menu.
  2. Clique em Create New Data Element .
  3. Especifique um nome para o elemento de dados. Neste exemplo, atribua o nome "my_friend".
  4. From the Type drop-down list, select AEM ContextHub .
    O nome da ferramenta AEM ContextHub aparecerá em “Origem”, mas, na versão atual, só pode ser definida uma ferramenta AEM ContextHub.
  5. Mapeie o elemento de dados para a camada de dados selecionando um caminho no seletor de Objeto.
    Neste exemplo, selecione o objeto page.friend .
  6. Clique em Save Data Element .

Criar uma regra baseada em eventos que use o tipo de evento de alteração de elemento de dados

  1. In the web property, click the Rules tab, then click Event Based Rules in the left menu.
  2. Clique em Create New Rule .
  3. Atribua um nome à regra. Neste exemplo, atribua o nome "find_a_friend".
  4. Expanda a seção Condições.
  5. From the Event Type drop-down list, select dataelementchanged .
  6. Selecione o elemento de dados criado na seção anterior (my_friend).
  7. Under Rule Conditions , select Data Element Value from the drop-down list, then click Add Criteria .
  8. Selecione o elemento de dados criado na seção anterior (my_friend) e atribua um valor que provoque o acionamento da regra.
    Neste exemplo, use o valor “Carl”.
    Se os valores do elemento de dados forem usados dessa forma como condições, é importante que as configurações do elemento de dados sejam consideradas na correspondência. For example, selecting the Force Lowercase Value option in the data element settings would convert the value to all lowercase before evaluation. Como o Javascript distingue maiúsculas de minúsculas, “test” não seria o mesmo que “Test” e a condição não seria acionada como esperado.
  9. Expand the Javascript / Third Party Tags section.
  10. Clique em Add New Script .
  11. Adicione um Javascript não sequencial que notifique se a regra for acionada. Atribua à regra o nome “found_my_friend” e adicione um script de alerta semelhante ao do exemplo a seguir:
    alert(_satellite.getVar(‘my_friend’) + ‘ is my friend.’);
  12. Click Save Code , then click Save Rule .

Valide a implementação

No site habilitado pelo DTM que executa a propriedade da Web acima, valide a implementação.
  • No console do desenvolvedor, verifique se há a camada de dados ( _dl ).
  • Mude o objeto da camada de dados que está sendo monitorada para o valor definido na condição acima ( _dl.page.friend = ‘Carl’ ).
    • Neste exemplo de implementação, deverá aparecer uma caixa de alerta:
  • Change the object to a different value ( _dl.page.friend = ‘Bob’ ) and no alert should display.
    Se a depuração do DTM estiver ativada, a falha de avaliação deverá aparecer no console.
  • Change the object to a lowercase value of the match ( _dl.page.friend = ‘carl’ ) and no alert should display.
  • Change the object to the correct case value of the match ( _dl.page.friend = ‘Carl’ ) and the alert should once again display.