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.

O Launch tem um local dedicado definido para uma chamada de rastreamento de link.

  1. Faça logon em launch.adobe.com usando as credenciais da Adobe ID.
  2. Clique na propriedade desejada.
  3. Vá até a guia Regras e clique na regra desejada (ou crie uma regra).
  4. Em Ações, clique no ícone “+”.
  5. Selecione Adobe Analytics na lista suspensa Extensão e Enviar beacon no Tipo de ação.
  6. Clique no botão de opção s.tl().

Não é possível definir argumentos opcionais no Launch.

Método s.tl() no AppMeasurement e no editor de código personalizado do Launch

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]);

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.

OBSERVAÇÃO

O AppMeasurement ativa automaticamente a variável useBeacon para links de saída, tornando esse argumento desnecessário nos navegadores modernos. Esse argumento era usado com mais frequência em versões anteriores do AppMeasurement.

  • this: aguarde até 500 ms para dar tempo ao AppMeasurement para enviar uma solicitação de imagem. Valor padrão.
  • true: não espere.
// 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");

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");

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");

Você pode consolidar o código de rastreamento de link em uma função JavaScript independente definida na página ou em um arquivo JavaScript vinculado. 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>

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");
  }
}

Nesta página