clickCollectionEnabled
A propriedade clickCollectionEnabled é um booliano que determina se o SDK da Web coleta automaticamente dados de link. 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:
xdm.web.webInteraction.namexdm.web.webInteraction.typexdm.web.webInteraction.URL
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, o Adobe recomenda usar o objeto clickCollection.
Lógica de rastreamento de link automático
O SDK da Web 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:
- Se o link corresponder aos critérios com base nos valores em
downloadLinkQualifier, ou se o link contiver um atributo HTMLdownload,xdm.web.webInteraction.typeserá definido como"download"(seclickCollection.downloadLinkEnabledestiver habilitado). - Se o domínio de destino do link for diferente do atual
window.location.hostname,xdm.web.webInteraction.typeestá definido como"exit"(seclickCollection.exitLinkEnabledestiver habilitado). - Se o link não se qualificar para
"download"ou"exit",xdm.web.webInteraction.typeestá definido como"other".
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 SDK da Web 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:
- Coletar cliques internos em links
- Coletar cliques em links externos
- Coletar cliques no link de download
Consulte clickCollection para obter mais informações.
Ativar o rastreamento automático de links usando a biblioteca JavaScript do SDK da Web library
Defina o booleano clickCollectionEnabled ao executar o comando configure. Se você omitir essa propriedade ao configurar o SDK da Web, 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
});