tl

El método tl() es un componente principal importante de Adobe Analytics. Toma todas las variables de Analytics definidas en la página, las compila en una solicitud de imagen y envía esos datos a los servidores de recopilación de datos de Adobe. Funciona de manera similar al método t(), pero este no incrementa las vistas de página. Es útil para rastrear vínculos y otros elementos que no se considerarían una carga de página completa.

Si trackDownloadLinks o trackExternalLinks están activados, AppMeasurement llama automáticamente al método tl() para enviar datos de seguimiento de vínculos de descarga y de salida. Si su organización prefiere tener más control sobre los vínculos que quiere rastrear y su comportamiento, puede llamar al método tl() manualmente. Los vínculos personalizados solo se pueden rastrear manualmente.

Seguimiento de vínculos mediante el SDK web

El SDK web no diferencia entre las llamadas de vista de página y las llamadas de seguimiento de vínculos; ambas utilizan el comando sendEvent.

Si utiliza un objeto XDM y desea que Adobe Analytics cuente un evento determinado como una llamada de seguimiento de vínculos, asegúrese de que los datos XDM incluyan:

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

Si utiliza un objeto de datos y desea que Adobe Analytics cuente un evento determinado como una llamada de seguimiento de vínculos, asegúrese de que el objeto de datos incluya:

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

Seguimiento de vínculos con la extensión Adobe Analytics

La extensión de Adobe Analytics tiene una ubicación específica para establecer una llamada de seguimiento de vínculos.

No puede establecer ningún argumento opcional en la extensión de Analytics.

El método s.tl() en AppMeasurement y el editor de código personalizado de la extensión de Analytics

Llame al método s.tl() cuando desee enviar una llamada de seguimiento a Adobe.

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

Objeto de vinculación (obligatorio)

El argumento del objeto de vinculación determina si el explorador espera hasta 500 ms antes de salir de la página. Si una solicitud de imagen se envía antes de 500 ms, la página se desplaza inmediatamente al vínculo donde se hizo clic.

// 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 vínculo (obligatorio)

El argumento del tipo de vínculo es una cadena de un solo carácter que determina el tipo de llamada de seguimiento de vínculos. Existen tres 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");

Nombre del vínculo (recomendado)

El argumento del nombre de la vinculación es una cadena que determina el elemento de la dimensión de seguimiento del vínculo. Al utilizar las dimensiones Vínculo personalizado, Vínculo de descarga o Vínculo de salida en la creación de informes, esta cadena contiene el elemento de dimensión. Si no se establece este argumento, se utiliza la variable linkURL.

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

Anulaciones de variables (opcional)

Permite cambiar los valores de las variables para una sola llamada. Consulte las anulaciones de variables para obtener más información.

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

Ejemplos y casos de uso

Envíe una llamada de seguimiento de vínculos básica directamente dentro de un vínculo HTML:

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

Utilice JavaScript para hacer una llamada de seguimiento de vínculos básica con argumentos de método:

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

Realizar llamadas de seguimiento de vínculos dentro de una función personalizada

Puede consolidar el código de seguimiento de vínculos en una función JavaScript independiente. Las llamadas se pueden realizar en la función onClick de cada vínculo. Establezca lo siguiente en un archivo JavaScript:

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

A continuación, puede llamar a la función siempre que desee rastrear una vinculación determinada:

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

Evitar el seguimiento de vínculos duplicados

Si trackDownloadLinks o trackExternalLinks están activados, AppMeasurement realiza automáticamente una llamada de seguimiento de vínculos si coinciden los filtros correctos. Si también llama manualmente a s.tl() para estos clics en vínculos, puede enviar datos duplicados a Adobe. La duplicación de datos infla los números del informe y los hace menos precisos.

Por ejemplo: la siguiente función enviaría dos llamadas de seguimiento de vínculos para el mismo clic en vínculo (vínculos de descarga manuales y automáticos):

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

Puede ayudar a evitar llamadas de seguimiento de vínculos duplicados mediante la siguiente función modificada. Primero comprueba si existe un objeto de vinculación y solo envía una llamada de seguimiento manual si el objeto de vinculación es una cadena vacía.

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

Utilizar el método tl() con el Activity Map

Puede usar el método tl() para hacer un seguimiento de elementos personalizados y configurar la representación de las superposiciones en el contenido dinámico. El parámetro linkName también se usa para establecer la dimensión Vínculo de Activity Map.

Cuando se llama directamente al método tl() desde el evento en el que se hace clic del elemento HTML, el Activity Map puede mostrar una superposición para ese elemento al cargar la página web. Por ejemplo:

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

Cuando no se llama directamente al método tl() desde el evento en el que se hace clic del elemento HTML, el Activity Map solo puede mostrar una superposición cuando se ha hecho clic en el elemento. Por ejemplo:

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