clickCollectionEnabled

A propriedade clickCollectionEnabled é um booliano que determina se o Web SDK coleta dados de link automaticamente. Se você não definir essa variável, seu valor padrão será true, o que significa que os dados de rastreamento de link serão coletados automaticamente por padrão. Configurar essa propriedade como false é importante nos casos em que você prefere rastrear os dados do link manualmente.

Quando clickCollectionEnabled está habilitado, os seguintes elementos XDM são preenchidos automaticamente com dados:

Links internos, links de download e links de saída são rastreados automaticamente por padrão quando esse booleano é ativado. Se você quiser ter mais controle sobre o rastreamento automático de links, a Adobe recomenda usar o objeto clickCollection.

Suporte para elementos Shadow DOM abertos

O Web SDK oferece suporte ao rastreamento automático de cliques para links dentro de elementos DOM de sombra aberta.

Muitos sites modernos usam Componentes Web para criar elementos de interface do usuário reutilizáveis e encapsulados. Esses componentes geralmente usam uma tecnologia chamada DOM de sombra para manter sua estrutura interna e estilos separados do restante da página.

Há dois tipos de DOM de sombra:

O Web SDK rastreia automaticamente os cliques nos elementos <a> e <area> dentro dos DOMs de Sombra Aberta, da mesma forma que faz para os links no documento principal. Isso garante que os cliques em links dentro de componentes da Web que usam Shadow DOM abertos sejam incluídos nos dados de análise. Os cliques dentro de DOMs de sombra fechados não são rastreados, pois sua estrutura interna está oculta do código JavaScript que opera fora do componente.

Lógica de rastreamento de link automático

O Web SDK rastreia todos os cliques nos elementos HTML <a> e <area> se não tiver um atributo onClick. Os cliques são capturados com um ouvinte de eventos de clique capture anexado ao documento. Quando um link válido é clicado, a seguinte lógica é executada em ordem:

Em todos os casos, xdm.web.webInteraction.name está definido como o rótulo de texto do link e xdm.web.webInteraction.URL está definido como a URL de destino do link. Se você quiser definir o nome do link para a URL também, poderá substituir esse campo XDM usando o retorno de chamada filterClickDetails no objeto clickCollection.

Ativar o rastreamento automático de links usando a extensão de tag do Web SDK tag-extension

Essa variável é gerenciada automaticamente pela extensão de tag; não é necessário defini-la explicitamente. Se qualquer um dos itens a seguir for selecionado ao configurar a extensão de tag, os dados de rastreamento de link aplicáveis serão coletados:

Consulte clickCollection para obter mais informações.

Ativar o rastreamento automático de links usando a biblioteca JavaScript do Web SDK library

Defina o booleano clickCollectionEnabled ao executar o comando configure. Se você omitir essa propriedade ao configurar o Web SDK, o padrão será true. Defina este valor como false se preferir definir xdm.web.webInteraction.type e xdm.web.webInteraction.value manualmente.

alloy(configure, {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: false
});