Rastrear links

Os links podem ser definidos manualmente ou rastreados automaticamente. O rastreamento manual é feito ao adicionar os detalhes na guia web.webInteraction parte do schema. Há três variáveis obrigatórias:

  • web.webInteraction.name
  • 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
      }
    }
  }
});

O tipo de link pode ser um dos 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, rotula e registra cliques em tags de link qualificadas. Os cliques são capturados com um captura clique em ouvinte de evento anexado ao documento.

O rastreamento automático de link pode ser desativado por configuração o SDK da Web.

clickCollectionEnabled: false

O rastreamento automático de link é feito para âncora A e AREA tags. No entanto, essas tags não são consideradas para o rastreamento de link se tiverem um onclick manipulador.

Os links são rotulados como um link de download se a tag da â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 link podem ser inspecionados e filtrados fornecendo um Função de retorno de chamada onBeforeEventSend.

A filtragem de dados de rastreamento de link pode ser útil na preparação de dados para relatórios do Analytics. O rastreamento automático de link 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 você deseja relatar o URL do link, o nome do link precisa ser removido. O exemplo a seguir mostra um onBeforeEventSend que remove o nome do link dos 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;
        }
    }
  }
});

Nesta página