Integração com o Gerenciamento dinâmico de tags da Adobe

Integre o Gerenciamento dinâmico de tags da Adobe ao AEM para que você possa usar as propriedades da Web do Gerenciamento dinâmico de tags para rastrear sites do AEM. O Gerenciamento dinâmico de tags permite que os profissionais de marketing gerenciem tags para coletar dados e distribuam dados pelos sistemas de marketing digital. Por exemplo, use o Gerenciamento dinâmico de tags para coletar dados de uso para seu site do AEM e distribuir os dados para análise no Adobe Analytics ou Adobe Target.

Antes de se integrar, é necessário criar a propriedade da Web do Gerenciamento dinâmico de tags que rastreia o domínio do site do AEM. As opções de hospedagem da propriedade da Web devem ser configuradas para que você possa configurar o AEM para acessar as bibliotecas do Gerenciamento dinâmico de tags.

Após configurar a integração, as alterações nas ferramentas e regras de implantação do Gerenciamento dinâmico de tags não exigem que você altere a configuração do Gerenciamento dinâmico de tags no AEM. As alterações estão automaticamente disponíveis para o AEM.

Observação

Se você estiver usando o DTM com uma configuração de proxy personalizada, precisará configurar ambas as configurações de proxy do Cliente HTTP, já que algumas funcionalidades do AEM estão usando as APIs 3.x e outras as APIs 4.x:

Opções de implantação

As seguintes opções de implantação afetam a configuração da integração com o Gerenciamento dinâmico de tags.

Hospedagem do Gerenciamento dinâmico de tags

O AEM oferece suporte ao Gerenciamento dinâmico de tags hospedado na nuvem ou hospedado no AEM.

  • Hospedado na nuvem: As bibliotecas de javascript do Gerenciamento dinâmico de tags são armazenadas na nuvem e suas páginas do AEM as fazem referência diretamente.
  • AEM hospedado: O Gerenciamento dinâmico de tags gera bibliotecas de javascript. O AEM usa um modelo de fluxo de trabalho para obter e instalar as bibliotecas.

O tipo de hospedagem que sua implementação usa determina algumas das tarefas de configuração e implementação que você executa. Para obter informações sobre as opções de hospedagem, consulte Hospedagem - guia Incorporar na Ajuda do Gerenciamento dinâmico de tags.

Biblioteca de preparo e produção

Decida se a instância do autor do AEM usa o código de produção ou armazenamento temporário do Gerenciamento dinâmico de tags.

Normalmente, sua instância do autor usa as bibliotecas de preparo do Gerenciamento dinâmico de tags e a instância de produção usa as bibliotecas de produção. Esse cenário permite usar a instância do autor para testar configurações não aprovadas do Gerenciamento dinâmico de tags.

Se desejar, a instância do autor poderá usar as bibliotecas de produção. Estão disponíveis plug-ins de navegador da Web que permitem alternar entre o uso de bibliotecas de preparo para fins de teste quando as bibliotecas são hospedadas na nuvem.

Usando o gancho de implantação do Gerenciamento dinâmico de tags

Quando o AEM hospeda as bibliotecas do Gerenciamento dinâmico de tags, você pode usar o serviço de gancho de implantação do Gerenciamento dinâmico de tags para enviar automaticamente atualizações da biblioteca para o AEM. As atualizações da biblioteca são enviadas quando alterações são feitas nas bibliotecas, como quando as propriedades da Web do Gerenciamento dinâmico de tags são editadas.

Para usar o gancho de implantação, o Gerenciamento dinâmico de tags deve poder se conectar à instância do AEM que hospeda as bibliotecas. Você deve ativar o acesso ao AEM para os servidores do Gerenciamento dinâmico de tags.

Em algumas circunstâncias, o AEM pode estar inacessível, como quando o AEM está por trás de um firewall. Nesses casos, você pode usar a opção de importador de pesquisa do AEM para recuperar periodicamente as bibliotecas. Uma expressão de tarefa cron determina o agendamento para downloads da biblioteca.

Ativando o Acesso ao Serviço de Gancho de Implantação

Ative o serviço de gancho de implantação do Gerenciamento dinâmico de tags para acessar o AEM para que o serviço possa atualizar as bibliotecas hospedadas pelo AEM. Especifique o endereço IP dos servidores do Gerenciamento dinâmico de tags que atualizam as bibliotecas de preparo e produção, conforme necessário:

  • Estágios: 107.21.99.31
  • Produção: 23.23.225.112 e 204.236.240.48

Perform the configuration using either the Web Console or a sling:OsgiConfig node:

  • No Console da Web, use o item Configuração do gancho de implantação do Adobe DTM na página Configuração.
  • Para uma configuração OSGi, o PID do serviço é com.adobe.cq.dtm.impl.servlets.DTMDeployHookServlet.

A tabela a seguir descreve as propriedades a serem configuradas.

propriedade Console da Web propriedade OSGi Descrição
Lista técnica de IP do DTM de armazenamento temporário dtm.staging.ip.whitelist O endereço IP do servidor do Gerenciamento dinâmico de tags que atualiza as bibliotecas de preparo.
Lista técnica de IP do DTM de produção dtm.production.ip.whitelist O endereço IP do servidor do Gerenciamento dinâmico de tags que atualiza as bibliotecas de produção.

Criação da configuração do Gerenciamento dinâmico de tags

Crie uma configuração em nuvem para que a instância do AEM possa se autenticar com o Gerenciamento dinâmico de tags e interagir com sua propriedade da Web.

Observação

Evite a inclusão de dois códigos de rastreamento do Adobe Analytics em suas páginas quando sua propriedade da Web do DTM incluir a ferramenta Adobe Analytics e você também estiver usando o Content Insight. Na configuração da nuvem doAdobe Analytics, selecione a opção Não incluir código de rastreamento.

Configurações gerais

Propriedade Descrição
Token de API O valor da propriedade Token da API da sua conta de usuário do Gerenciamento dinâmico de tags. O AEM usa essa propriedade para autenticação com o Gerenciamento dinâmico de tags.
Empresa A empresa à qual sua ID de logon está associada.
Propriedade O nome da propriedade da Web que você criou para gerenciar as tags do site do AEM.
Incluir código de produção em Autor

Selecione essa opção para fazer com que as instâncias de autor e publicação do AEM usem a versão de produção das bibliotecas do Gerenciamento dinâmico de tags.

Quando essa opção não está selecionada, as Configurações de armazenamento temporário se aplicam à instância do autor e as Configurações de produção se aplicam à instância de publicação.

Propriedades de hospedagem própria - armazenamento temporário e produção

As seguintes propriedades da configuração do Gerenciamento dinâmico de tags permitem que o AEM hospede as bibliotecas do Gerenciamento dinâmico de tags. As propriedades permitem que o AEM baixe e instale as bibliotecas. Como opção, você pode atualizar automaticamente as bibliotecas para garantir que elas reflitam quaisquer alterações feitas no aplicativo de gerenciamento dinâmico de tags.

Algumas propriedades usam valores obtidos na seção Download da biblioteca da guia Incorporar para sua propriedade da Web Gerenciamento dinâmico de tags. Para obter informações, consulte Download da biblioteca na Ajuda do Gerenciamento dinâmico de tags.

Observação

Quando você estiver hospedando o pacote Gerenciamento dinâmico de tags no AEM, o Download da biblioteca deve estar habilitado no Gerenciamento dinâmico de tags antes de criar a configuração. Além disso, o Akamai deve estar habilitado porque o Akamai fornece as bibliotecas para download.

Ao hospedar as bibliotecas do Gerenciamento dinâmico de tags no AEM, o AEM configura automaticamente algumas propriedades da propriedade da Web de acordo com sua configuração. Consulte as descrições na tabela a seguir.

Propriedade Descrição
Usar hospedagem própria Selecione quando estiver hospedando o arquivo da biblioteca do Gerenciamento dinâmico de tags no AEM. Selecionar essa opção faz com que as outras propriedades desta tabela sejam exibidas.
URL do pacote de DTM O URL a ser usado para baixar a biblioteca do Gerenciamento dinâmico de tags. Obtenha esse valor na seção Download de URLs da página Download da biblioteca do Gerenciamento dinâmico de tags. Por motivos de segurança, esse valor deve ser configurado manualmente.
Download do fluxo de trabalho

O modelo de fluxo de trabalho a ser usado para baixar e instalar a biblioteca do Gerenciamento dinâmico de tags. O modelo padrão é Download padrão do pacote do DTM. Use esse modelo a menos que você tenha criado um modelo personalizado.

Observe que o fluxo de trabalho de download padrão ativa automaticamente as bibliotecas quando elas são baixadas.

Dica de domínio

(Opcional) O domínio do servidor AEM que está hospedando a biblioteca do Gerenciamento dinâmico de tags. Especifique um valor para substituir o domínio padrão configurado para o serviço Externalizador de links doDay CQ.

Quando conectado ao Gerenciamento dinâmico de tags, o AEM usa esse valor para configurar o Caminho HTTP de preparo ou o Caminho HTTP de produção das propriedades Download da biblioteca para a propriedade da Web Gerenciamento dinâmico de tags.

Dica do domínio segura

(Opcional) O domínio do servidor AEM que está hospedando a biblioteca do Gerenciamento dinâmico de tags em HTTPS. Especifique um valor para substituir o domínio padrão configurado para o serviço Externalizador de links doDay CQ.

Quando conectado ao Gerenciamento dinâmico de tags, o AEM usa esse valor para configurar o Caminho HTTPS de preparo ou o Caminho HTTPS de produção das propriedades Download da biblioteca para a propriedade da Web Gerenciamento dinâmico de tags.

Segredo compartilhado

(Opcional) O segredo compartilhado a ser usado para descriptografar o download. Obtenha esse valor do campo Segredo compartilhado da página Download da biblioteca do Gerenciamento dinâmico de tags.

Observação: Você deve ter as bibliotecas OpenSSL instaladas no computador onde o AEM está instalado para que o AEM possa descriptografar as bibliotecas baixadas.

Ativar o importador de pesquisa

(Opcional) Selecione para baixar e instalar periodicamente a biblioteca do Gerenciamento dinâmico de tags para garantir que você esteja usando uma versão atualizada. Quando selecionado, o Gerenciamento dinâmico de tags não envia solicitações HTTP POST para o URL de gancho de implantação.

O AEM configura automaticamente a propriedade Implantar URL do gancho das propriedades Download da biblioteca para a propriedade da Web Gerenciamento dinâmico de tags. Quando selecionada, a propriedade é configurada sem valor. Quando não selecionada, a propriedade é configurada com o URL da configuração do Gerenciamento dinâmico de tags.

Ative o importador de pesquisa quando o gancho de implantação do Gerenciamento dinâmico de tags não puder se conectar ao AEM, por exemplo, quando o AEM estiver atrás de um firewall.

Expressão de programação (Aparece e é necessário quando a opção Ativar Importador de Pesquisa está selecionada.) Uma expressão cron que controla quando as bibliotecas do Gerenciamento dinâmico de tags são baixadas.

chlimage_1-352

Propriedades de hospedagem na nuvem - armazenamento temporário e produção

As seguintes propriedades são configuradas para a configuração do Gerenciamento dinâmico de tags quando a Configuração dinâmica de tags é hospedada na nuvem.

Propriedade Descrição
Usar hospedagem própria Desmarque essa opção quando o arquivo da biblioteca do Gerenciamento dinâmico de tags estiver hospedado na nuvem.
Código do cabeçalho

O código do cabeçalho para armazenamento temporário obtido do Gerenciamento dinâmico de tags para seu host. Esse valor é preenchido automaticamente quando você se conecta ao Gerenciamento dinâmico de tags.

Para ver o código no Gerenciamento dinâmico de tags, clique na guia Incorporar e clique no nome do host. Expanda a seção Código do cabeçalho e clique em Copiar código incorporado do código incorporado de preparo ou na área Código incorporado de produção, conforme necessário.

Código de rodapé

O código do rodapé para armazenamento temporário obtido do Gerenciamento dinâmico de tags para seu host. Esse valor é preenchido automaticamente quando você se conecta ao Gerenciamento dinâmico de tags.

Para ver o código no Gerenciamento dinâmico de tags, clique na guia Incorporar e clique no nome do host. Expanda a seção Código do rodapé e clique na área Copiar código incorporado do código incorporado de preparo ou Código incorporado de produção, conforme necessário.

chlimage_1-353

O procedimento a seguir usa a interface otimizada ao toque para configurar a integração com o Gerenciamento dinâmico de tags.

  1. No trilho, clique em Ferramentas > Operações > Nuvem > Serviços em nuvem.

  2. Na área Gerenciamento dinâmico de tags, um dos links a seguir é exibido para adicionar uma configuração:

    • Clique em Configurar agora se esta for a primeira configuração que você está adicionando.
    • Clique em Mostrar configurações e clique no link + ao lado de Configurações disponíveis se uma ou mais configurações tiverem sido criadas.

    chlimage_1-354

  3. Digite um título para a configuração e clique em Criar.

  4. No campo Token da API, digite o valor da propriedade Token da API da conta de usuário do Gerenciamento dinâmico de tags.

    Para obter o valor do token da API, entre em contato com o Atendimento ao cliente do DTM.

    Observação

    O token da API não expira até que o usuário do Gerenciamento dinâmico de tags o solicite explicitamente.

    chlimage_1-355

  5. Clique em Conectar-se ao DTM. O AEM é autenticado com o Gerenciamento dinâmico de tags e recupera a lista de empresas às quais sua conta está associada.

  6. Selecione a Empresa e, em seguida, selecione a Propriedade que você está usando para rastrear seu site do AEM.

  7. Se você estiver usando o código de preparo na instância do autor, desmarque Incluir código de produção no autor.

  8. Forneça valores para as propriedades na guia Configurações de preparo e na guia Configurações de produção, se necessário, e clique em OK.

Download manual da biblioteca do Gerenciamento dinâmico de tags

Baixe manualmente as bibliotecas do Gerenciamento dinâmico de tags para atualizá-las imediatamente no AEM. Por exemplo, baixe manualmente quando quiser testar uma biblioteca atualizada antes que o importador de pesquisa esteja programado para baixar automaticamente a biblioteca.

  1. No trilho, clique em Ferramentas > Operações > Nuvem > Serviços em nuvem.

  2. Na área Gerenciamento dinâmico de tags, clique em Mostrar configurações e clique em sua configuração.

  3. Na área Configurações de preparo ou Configurações de produção, clique no botão Fluxo de trabalho de download do acionador para baixar e implantar o pacote da biblioteca.

    chlimage_1-356

Observação

Os arquivos baixados são armazenados em /etc/clientlibs/dtm/my config/companyID/propertyID/servertype.

As informações a seguir são obtidas diretamente da configuração doDTM.

  • myconfig
  • companyID
  • propertyID
  • servertype

Associando uma configuração do Gerenciamento dinâmico de tags ao seu site

Associe sua configuração do Gerenciamento dinâmico de tags às páginas do site para que o AEM adicione o script necessário às páginas. Associe a página raiz do site à configuração. Todos os descendentes dessa página herdam a associação. Se necessário, é possível substituir a associação em uma página descendente.

Use o procedimento a seguir para associar uma página e os descendentes a uma configuração do Gerenciamento dinâmico de tags.

  1. Abra a página raiz do site na interface clássica.

  2. Use o Sidekick para abrir as propriedades da página.

  3. Na guia Serviços em nuvem, clique em Adicionar serviço, selecione Gerenciamento dinâmico de tags e clique em OK.

    chlimage_1-357

  4. Use o menu suspenso Gerenciamento dinâmico de tags para selecionar sua configuração e clique em OK.

Use o procedimento a seguir para substituir a associação de configuração herdada de uma página. A substituição afeta a página e todos os descendentes da página.

  1. Abra a página na interface clássica.

  2. Use o Sidekick para abrir as propriedades da página.

  3. Na guia Serviços em nuvem, clique no ícone de cadeado ao lado da propriedade Herdado de e clique em Sim na caixa de diálogo de confirmação.

    chlimage_1-358

  4. Remova ou selecione uma configuração diferente do Gerenciamento dinâmico de tags e clique em OK.

Nesta página