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.

Llamada de seguimiento de vínculos en Adobe Experience Platform Launch

Launch tiene una ubicación dedicada configurada como llamada de seguimiento de vínculos.

  1. Inicie sesión en launch.adobe.com con sus credenciales de Adobe ID.
  2. Haga clic en la propiedad deseada.
  3. Vaya a la pestaña Reglas y, a continuación, haga clic en la regla que desee (o cree una regla).
  4. En Acciones, haga clic en el icono “+”.
  5. Establezca la lista desplegable Extensión en Adobe Analytics y el tipo de acción en Enviar señalización.
  6. Haga clic en el botón de opción s.tl().

No puede establecer ningún argumento opcional en Launch.

El método s.tl() en el editor de código personalizado de AppMeasurement y Launch

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.

NOTA

AppMeasurement habilita automáticamente la variable useBeacon para los vínculos de salida, por lo que este argumento ya no se necesita en los exploradores modernos. Este argumento se usaba con mayor frecuencia en versiones anteriores de AppMeasurement.

  • this: Esperar hasta 500 ms para que AppMeasurement tenga tiempo de enviar una solicitud de imagen. Valor predeterminado.
  • true: No esperar.
// 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 definida en la página o en un archivo JavaScript vinculado. 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");
  }
}

En esta página