Integração com o Adobe Dynamic Tag Management

Última atualização em 2024-02-29

Integrar Adobe Dynamic Tag Management com AEM, para que você possa usar suas propriedades da Web do Dynamic Tag Management para rastrear sites do AEM. O Dynamic Tag Management permite que os profissionais de marketing gerenciem tags para coleta de dados e distribuam dados nos sistemas de marketing digital. Por exemplo, use o Dynamic Tag Management para coletar dados de uso do site AEM e distribuir os dados para análise no Adobe Analytics ou no Adobe Target.

Antes de integrar, crie o Dynamic Tag Management propriedade da web que rastreia o domínio do seu site AEM. A variável opções de hospedagem da propriedade da web deve ser configurada para que você possa configurar o AEM para acessar as bibliotecas do Dynamic Tag Management.

Após configurar a integração, as alterações nas ferramentas e regras de implantação do Dynamic Tag Management não exigem que você altere a configuração do Dynamic Tag Management no AEM. As alterações são disponibilizadas automaticamente para o AEM.

OBSERVAÇÃO

Se estiver usando o DTM com uma configuração de proxy personalizada, defina as configurações de proxy do HTTP Client, pois algumas funcionalidades do AEM estão usando as APIs 3.x e algumas outras as APIs 4.x:

Opções de implantação

As opções de implantação a seguir afetam a configuração da integração com o Dynamic Tag Management.

Hospedagem dinâmica no Tag Management

O AEM é compatível com o Dynamic Tag Management que está hospedado na nuvem ou hospedado no AEM.

  • Hospedado na nuvem: as bibliotecas JavaScript do Dynamic Tag Management são armazenadas na nuvem e as páginas AEM fazem referência a elas diretamente.
  • Hospedado no AEM: o Dynamic Tag Management gera bibliotecas 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 Dynamic Tag Management.

Biblioteca de preparo e produção

Decida se a instância do autor do AEM usa o código de preparo ou de produção do Dynamic Tag Management.

Normalmente, a instância do autor usa as bibliotecas de preparo do Dynamic Tag Management, 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 Dynamic Tag Management.

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

Uso do gancho de implantação do Dynamic Tag Management

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

Para usar o gancho de implantação, o Dynamic Tag Management deve ser capaz de se conectar à instância AEM que hospeda as bibliotecas. Ativar acesso ao AEM para os servidores do Dynamic Tag Management.

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

Habilitando o acesso para o serviço de gancho de implantação

Ative o serviço de gancho de implantação do Dynamic Tag Management para acessar o AEM para que o serviço possa atualizar as bibliotecas hospedadas pelo AEM. Especifique o endereço IP dos servidores Dynamic Tag Management 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

Execute a configuração usando o Console da Web ou um sling:OsgiConfig nó:

  • 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 do Console da Web Propriedade OSGi Descrição
Lista branca de DTM de preparo dtm.staging.ip.whitelist O endereço IP do servidor Tag Management dinâmico que atualiza as bibliotecas de preparo.
Lista branca de IPs de produção do DTM dtm.production.ip.whitelist O endereço IP do servidor Tag Management dinâmico que atualiza as bibliotecas de produção.

Criação da configuração do Dynamic Tag Management

Crie uma configuração de nuvem para que a instância do AEM possa se autenticar com o Dynamic Tag Management 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 a propriedade da Web do DTM incluir a ferramenta Adobe Analytics e você também estiver usando Content Insight. No seu Configuração do Adobe Analytics Cloud, 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 de API da conta de usuário do Dynamic Tag Management. O AEM usa essa propriedade para se autenticar no Dynamic Tag Management.
Empresa A empresa à qual a ID de logon está associada.
Propriedade O nome da propriedade da Web que você criou para gerenciar as tags do site AEM.
Incluir código de produção em Autor

Selecione esta 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 Dynamic Tag Management.

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

Propriedades de auto hospedagem - Preparo e produção

As seguintes propriedades da configuração do Dynamic Tag Management permitem que o AEM hospede as bibliotecas do Dynamic Tag Management. 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 do Dynamic Tag Management.

Algumas propriedades usam os valores obtidos na seção Download da biblioteca da guia Incorporado para a propriedade da Web do Dynamic Tag Management. Para obter informações, consulte Download da biblioteca na Ajuda do Dynamic Tag Management.

OBSERVAÇÃO

Quando você estiver hospedando o pacote do Dynamic Tag Management no AEM, o Download da biblioteca deve estar ativado no Dynamic Tag Management antes de criar a configuração. Além disso, o Akamai deve estar ativado, pois o Akamai fornece as bibliotecas para download.

Ao hospedar as bibliotecas do Dynamic Tag Management 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 auto hospedagem Selecione quando você estiver hospedando o arquivo da biblioteca do Dynamic Tag Management no AEM. Selecionar essa opção faz com que as outras propriedades nesta tabela apareçam.
URL do pacote de DTM O URL a ser usado para baixar a biblioteca Tag Management dinâmica. Obtenha esse valor na seção URLs de download da página Download da biblioteca do Dynamic Tag Management. 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 Tag Management dinâmica. O modelo padrão é o Download do pacote de DTM padrão. Use este modelo, a menos que tenha criado um modelo personalizado.

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 hospeda a biblioteca do Dynamic Tag Management. Especifique um valor para que você possa substituir o domínio padrão configurado para o Serviço Day CQ Link Externalizer.

Quando conectado ao Dynamic Tag Management, o AEM usa esse valor para configurar o Caminho HTTP de preparo ou o Caminho HTTP de produção das propriedades de download da biblioteca para a propriedade da Web do Dynamic Tag Management.

Dica do domínio segura

(Opcional) O domínio do servidor AEM que está hospedando a biblioteca Tag Management dinâmica em HTTPS. Especifique um valor para que você possa substituir o domínio padrão configurado para o Serviço Day CQ Link Externalizer.

Quando conectado ao Dynamic Tag Management, o AEM usa esse valor para configurar o Caminho HTTPS de preparo ou o Caminho HTTPS de produção das propriedades de download da biblioteca para a propriedade da Web do Dynamic Tag Management.

Segredo compartilhado

(Opcional) O segredo compartilhado a ser usado para descriptografar o download. Obtenha esse valor no campo Segredo compartilhado da página Download de biblioteca do Dynamic Tag Management.

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

Habilitar o importador de pesquisa

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

O AEM configura automaticamente a propriedade Implantar URL do gancho das propriedades Download da biblioteca para a propriedade da Web do Dynamic Tag Management. Quando selecionada, a propriedade é configurada sem valor. Quando não selecionada, a propriedade é configurada com o URL da sua configuração do Dynamic Tag Management.

Ative o importador de pesquisa quando o gancho de implantação do Dynamic Tag Management 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 é obrigatório quando Ativar importador de pesquisa estiver selecionado.) Uma expressão cron que controla quando as bibliotecas do Dynamic Tag Management são baixadas.

chlimage_1-352

Propriedades de hospedagem na nuvem - Preparo e produção

Você define as seguintes propriedades para a configuração do Dynamic Tag Management quando o Dynamic Tag Configuration estiver hospedado na nuvem.

Propriedade Descrição
Usar auto hospedagem Desmarque essa opção quando o arquivo da biblioteca de Dynamic Tag Management estiver hospedado na nuvem.
Código do cabeçalho

O código de cabeçalho para preparo obtido do Dynamic Tag Management para o seu host. Esse valor é preenchido automaticamente ao se conectar ao Dynamic Tag Management.

Para ver o código no Dynamic Tag Management, clique na guia Incorporar e, em seguida, clique no nome do host. Expanda a seção Código do cabeçalho e clique na área Copiar código incorporado do código de inserção de preparo ou na área Código de inserção de produção, conforme necessário.

Código de rodapé

O código de rodapé para preparo obtido do Dynamic Tag Management para o seu host. Esse valor é preenchido automaticamente ao se conectar ao Dynamic Tag Management.

Para ver o código no Dynamic Tag Management, clique na guia Incorporar e, em seguida, clique no nome do host. Expanda a seção Código de rodapé e clique na área Copiar código de inserção do código de inserção de preparo ou da produção, conforme necessário.

chlimage_1-353

O procedimento a seguir usa a interface otimizada para toque para configurar a integração com o Dynamic Tag Management.

  1. No painel, clique em Ferramentas > Operações > Nuvem > Cloud Service.

  2. Na área Tag Management dinâmico, 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, em seguida, 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 de API, digite o valor da propriedade Token de API da conta de usuário do Dynamic Tag Management.

    Para obter o valor do token de 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 Dynamic Tag Management o solicite explicitamente.

    chlimage_1-355

  5. Clique em Conectar ao DTM. O AEM é autenticado com o Dynamic Tag Management 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 o site AEM.

  7. Se estiver usando 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 armazenamento temporário e na guia Configurações de produção, se necessário, e clique em OK.

Download manual da biblioteca Tag Management dinâmica

Baixe manualmente as bibliotecas Tag Management dinâmicas para atualizá-las imediatamente no AEM. Por exemplo, baixe manualmente quando quiser testar uma biblioteca atualizada antes que o importador de pesquisa seja agendado para baixar automaticamente a biblioteca.

  1. No painel, clique em Ferramentas > Operações > Nuvem > Cloud Service.

  2. Na área Dynamic Tag Management, clique em Mostrar configurações e, em seguida, clique na configuração.

  3. Na área Configurações de armazenamento temporário ou Configurações de produção, clique no botão Acionar fluxo de trabalho de download para baixar e implantar o pacote de biblioteca.

    chlimage_1-356

OBSERVAÇÃO

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

Os itens a seguir são obtidos diretamente do seu Configuração do DTM.

  • myconfig
  • companyID
  • propertyID
  • servertype

Associar uma configuração do Dynamic Tag Management ao seu site

Associe sua configuração do Dynamic Tag Management às páginas do seu site para que 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 Dynamic Tag Management.

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

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

  3. Na guia Cloud Service, clique em Adicionar serviço, selecione Tag Management dinâmico e clique em OK.

    chlimage_1-357

  4. Use o menu suspenso Dynamic Tag Management 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 Sidekick para abrir as propriedades da página.

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

    chlimage_1-358

  4. Remova ou selecione uma configuração diferente do Dynamic Tag Management e clique em OK.

Nesta página