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 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:

  • Nome do link: mapeado para xdm.web.webInteraction.name.
  • URL do link: mapeado para xdm.web.webInteraction.URL.
  • Tipo de link: mapeado para xdm.web.webInteraction.type. Os valores válidos incluem other (Links personalizados), download (Links de download) e exit (Links de saída).
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:

  • Nome do link: mapeado para data.__adobe.analytics.linkName.
  • URL do link: mapeado para data.__adobe.analytics.linkURL.
  • Tipo de link: mapeado para data.__adobe.analytics.linkType. Os valores válidos incluem o (Links personalizados), d (Links de download) e e (Links de saída).
alloy("sendEvent", {
  "data": {
    "__adobe": {
      "analytics": {
        "linkName": "My custom link",
        "linkURL": "https://example.com",
        "linkType": "o"
      }
    }
  }
});

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

  1. Faça logon na Coleção de dados da Adobe Experience Platform usando suas credenciais da Adobe ID.
  2. Clique na propriedade de tag desejada.
  3. Vá até a guia Regras e clique na regra desejada (ou crie uma regra).
  4. Em Ações, clique na ação desejada ou clique no ícone '+' para adicionar uma ação.
  5. Defina a lista suspensa Extensão como Adobe Analytics e o Tipo de Ação como Enviar Beacon.
  6. Clique no botão de opção s.tl().

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

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.

NOTE
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. 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>
NOTE
Chamar o método tl() indiretamente pode tornar os relatórios de sobreposição de Activity Map menos convenientes. Você deve clicar em cada link para registrar a função com o elemento link. No entanto, as dimensões de Activity Map no Workspace são rastreadas da mesma forma.

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>
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690