Rastrear links

Última atualização em 2023-08-02
  • Tópicos
  • Web SDK
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer

Os links podem ser definidos manualmente ou rastreados automaticamente. O rastreamento manual é feito adicionando os detalhes em web.webInteraction parte do esquema. Há duas variáveis necessárias:

  • web.webInteraction.type
  • web.webInteraction.linkClicks.value
alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "linkClicks": {
            "value": 1
        },
        "name": "My Custom Link", // Name that shows up in the custom links report
        "URL": "https://myurl.com", // The URL of the link
        "type": "other" // values: other, download, exit
      }
    }
  }
});

A partir da versão 2.15.0, o SDK da Web captura o region do elemento de HTML clicado. Isso habilita a Activity Map recursos de relatórios no Adobe Analytics.

O tipo de link pode ser um destes três valores:

  • other: Um link personalizado
  • download: Um link de download
  • exit: Um link de saída

Esses valores são mapeado automaticamente no Adobe Analytics se configurado para fazer isso.

Rastreamento automático de links

Por padrão, o SDK da Web captura, rótulos e registros de cliques em tags de link qualificadas. Os cliques são capturados com um capturar clique em ouvinte de eventos anexado ao documento.

O rastreamento automático de links pode ser desativado por configurando o SDK da Web.

clickCollectionEnabled: false

O rastreamento automático de links é feito para âncora A e AREA específicos. No entanto, essas tags não serão consideradas para o rastreamento de links se tiverem uma anexada onclick manipulador.

Os links são rotulados como um link de download se a tag âncora incluir um atributo de download ou se o link terminar com uma extensão de arquivo popular. O qualificador de link de download pode ser configurado com uma expressão regular:

downloadLinkQualifier: "\\.(exe|zip|wav|mp3|mov|mpg|avi|wmv|pdf|doc|docx|xls|xlsx|ppt|pptx)$"

Os links são rotulados como um link de saída se o domínio de destino do link for diferente do atual window.location.hostname.

Os links que não se qualificam como link de download ou de saída são rotulados como "outros".

Os dados coletados com o rastreamento automático de links podem ser inspecionados e filtrados fornecendo uma função de retorno de chamada onBeforeEventSend.

A filtragem dos dados de rastreamento de link pode ser útil na preparação de dados para os relatórios do Analytics. O rastreamento automático de links captura o nome do link e o URL do link. Nos relatórios do Analytics, o nome do link tem prioridade sobre o URL do link. Se desejar relatar o URL do link, o nome do link precisa ser removido. O exemplo a seguir mostra uma onBeforeEventSend função que remove o nome do link para links de download:

alloy("configure", {
  onBeforeEventSend: function(options) {
    if (options
      && options.xdm
      && options.xdm.web
      && options.xdm.web.webInteraction) {
        if (options.xdm.web.webInteraction.type === "download") {
          options.xdm.web.webInteraction.name = undefined;
        }
    }
  }
});

A partir do SDK da Web versão 2.15.0, os dados coletados com o rastreamento automático de link podem ser inspecionados, aumentados ou filtrados fornecendo um função de retorno de chamada onBeforeLinkClickSend.

Essa função de retorno de chamada é executada somente quando ocorre um evento automático de clique de link.

alloy("configure", {
  onBeforeLinkClickSend: function(options) {
    if (options.xdm.web.webInteraction.type === "download") {
      options.xdm.web.webInteraction.name = undefined;
    }
  }
});

Ao filtrar os eventos de rastreamento de link usando o onBeforeLinkClickSend , o Adobe recomenda retornar false para os cliques em links que não devem ser rastreados. Qualquer outra resposta fará com que o SDK da Web envie os dados para a Rede de borda.

OBSERVAÇÃO

** Quando ambos os onBeforeEventSend e onBeforeLinkClickSend forem definidas funções de retorno de chamada, o SDK da Web executará a onBeforeLinkClickSend função de retorno de chamada para filtrar e aumentar o evento de interação de clique no link, seguido pelo onBeforeEventSend função de retorno de chamada.

Nesta página