tl

O método tl() é um componente principal importante do Adobe Analytics. Ele captura todas as variáveis do Analytics definidas na página, compila em uma solicitação de imagem e envia esses dados para os servidores de coleta de dados da Adobe. Funciona de forma semelhante ao método t(), no entanto, esse método não aumenta as exibições de página. É útil para rastrear links e outros elementos que não seriam considerados um carregamento de página completo.

Se trackDownloadLinks ou trackExternalLinks estiverem ativados, o AppMeasurement chama o método tl() automaticamente para enviar dados de rastreamento de links de download e de saída. Se sua organização preferir ter mais controle sobre os links a serem rastreados e o comportamento deles, você pode chamar o método tl() manualmente. Os links personalizados só podem ser acompanhados manualmente.

Rastreamento de link usando o SDK da Web

O SDK da Web não diferencia chamadas de exibição de página e chamadas de rastreamento de link; ambos usam o comando sendEvent.

Se você usar um objeto XDM e quiser que o Adobe Analytics contabilize um determinado evento como uma chamada de rastreamento de link, verifique se os dados XDM incluem:

alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "name": "My Custom Link",
        "URL": "https://example.com",
        "type": "other"
      }
    }
  }
});

Se você usar um objeto de dados e quiser que o Adobe Analytics contabilize um determinado evento como uma chamada de rastreamento de link, verifique se o objeto de dados inclui:

alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "linkName": "My custom link",
        "linkURL": "https://example.com",
        "linkType": "o"
      }
    }
  }
});

Rastreamento de link usando a extensão do Adobe Analytics

A extensão do Adobe Analytics tem um local dedicado para definir uma chamada de rastreamento de link.

Não é possível definir argumentos opcionais na extensão do Analytics.

Método s.tl() no AppMeasurement e no editor de código personalizado da extensão do Analytics

Chame o método s.tl() quando quiser enviar uma chamada de rastreamento para a Adobe.

s.tl([Link object],[Link type],[Link name],[Override variable]);

Objeto Link (obrigatório)

O argumento do objeto Link determina se o navegador aguarda até 500 ms antes de sair da página. Se uma solicitação de imagem for enviada antes de 500 ms, a página navegará imediatamente para o link clicado.

// Include a 500ms delay with an exit link
s.tl(this,"e","Example exit link");

// Do not include a 500ms delay with an exit link
s.tl(true,"e","Example exit link");

Tipo de link (obrigatório)

O argumento tipo de link é uma sequência com apenas um caractere que determina o tipo de chamada de rastreamento de link. Há três valores válidos.

// Send a custom link
s.tl(true,"o","Example custom link");

// Send a download link
s.tl(true,"d","Example download link");

// Send an exit link
s.tl(true,"e","Example exit link");

Nome do link (recomendado)

O argumento do nome do link é uma string que determina o item de dimensão do rastreamento do link. Ao usar as dimensões Link personalizado, Link de download ou Link de saída nos relatórios, esta cadeia de caracteres contém o item de dimensão. Se esse argumento não for definido, a variável linkURL será usada.

// When using the Download link dimension, this method call increases the occurrences metric for "Sea turtle PDF report" by 1.
s.tl(true,"d","Sea turtle PDF report");

Substituições de variáveis (opcional)

Permite alterar os valores de variáveis para uma única chamada. Consulte substituições de variáveis para obter mais informações.

var y = new Object();
y.eVar1 = "Override value";
y.linkTrackVars = "eVar1";
s.tl(true,"o","Example custom link",y);

Exemplos e casos de uso

Envie uma chamada básica de rastreamento de link diretamente dentro de um link HTML:

<a href="example.html" onClick="s.tl(true,'o','Example link');">Click here</a>

Use o JavaScript para fazer uma chamada básica de rastreamento de link usando argumentos de método:

s.tl(true,"o","Example link");

Efetuar chamadas de rastreamento de link em uma função personalizada

Você pode consolidar o código de rastreamento de link em uma função JavaScript independente. As chamadas podem ser feitas na função onClick de cada link. Defina o seguinte em um arquivo JavaScript:

function trackClickInteraction(name){
  s.linkTrackVars = "eVar1,eVar2";
  s.eVar1 = name;
  s.eVar2 = s.pageName;
  s.tl(true,"o",name);
}

Em seguida, você pode chamar a função sempre que quiser rastrear um determinado link:

<!-- Use wherever you want to track links -->
<a href="example.html" onClick="trackClickInteraction('Example link');">Click here</a>

Evite rastrear links duplicados

Se trackDownloadLinks ou trackExternalLinks estiverem ativados, o AppMeasurement faz uma chamada de rastreamento de link automaticamente se os filtros corretos coincidirem. Se você também chamar s.tl() manualmente para esses cliques em links, pode ser que envie dados duplicados à Adobe. Dados duplicados aumentam os números nos relatórios e os tornam menos precisos.

Por exemplo, a função a seguir enviaria duas chamadas de rastreamento de link para o mesmo clique de link (links de download manuais e automáticos):

function trackDownload(obj) {
  s.tl(obj,"d","Example PDF download");
}

Você pode ajudar a impedir chamadas de rastreamento de link duplicadas usando a função modificada a seguir. Verifica primeiro se um objeto de link existe e envia apenas uma chamada de rastreamento de link manual se o objeto do link for uma string vazia.

function linkCode(obj) {
  var lt = obj.href != null ? s.lt(obj.href) : "";
  if (lt=="") {
    s.tl(obj,"d","Example PDF download");
  }
}

Usar o método tl() com o Activity Map

Você pode usar o método tl() para rastrear elementos personalizados e configurar a renderização de sobreposição para o conteúdo dinâmico. O parâmetro linkName também é usado para definir a dimensão Link de Activity Map.

Quando o método tl() é chamado diretamente no evento de cliques do elemento de HTML, o Activity Map pode exibir uma sobreposição para esse elemento quando a página da Web for carregada. Por exemplo:

<a href="index.html" onclick="s.tl(this,'o','Example custom link');">Example link text</a>

Quando o método tl() não é chamado diretamente no evento de cliques do elemento HTML, o Activity Map só poderá exibir uma sobreposição depois que o elemento for clicado. Por exemplo:

<a href="index.html" onclick="someFn(event);">Example link text</a>
<script>
  function someFn (event) {
    s.tl(event.srcElement,'o','Example custom link');
  }
</script>