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 sendEvent comando. Si desea que Adobe Analytics cuente un evento XDM determinado como una llamada de seguimiento de vínculos, asegúrese de que los datos XDM incluyan o estén asignados a web.webInteraction.name, web.webInteraction.URL, y web.webInteraction.type.

  • El nombre del vínculo se asigna a web.webInteraction.name.
  • Vincular asignaciones de URL a web.webInteraction.URL.
  • El tipo de vínculo se asigna a web.webInteraction.type. Los valores válidos incluyen other (vínculos personalizados), download (vínculos de descarga) y exit (vínculos de salida).
alloy("sendEvent", {
  "xdm": {
    "web": {
      "webInteraction": {
        "name": "My Custom Link",
        "URL": "https://example.com",
        "type": "other"
      }
    }
  }
});

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.

  1. Inicie sesión en la Recopilación de datos de Adobe Experience Platform con sus credenciales de Adobe ID.
  2. Haga clic en la propiedad de etiquetas 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 la acción deseada o en '+' para añadir una acción.
  5. Configure las variables Extensión lista desplegable para Adobe Analytics, y el Tipo de acción hasta Send Beacon.
  6. Haga clic en el botón de opción s.tl().

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.

NOTE
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");
  }
}
recommendation-more-help
b4f6d761-4a8b-4322-b801-c85b9e3be690