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.
El SDK web no diferencia entre las llamadas de vista de página y las llamadas de seguimiento de vínculos; ambos utilizan la variable 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 incluyen o están asignados a web.webInteraction.name
, web.webInteraction.URL
y web.webInteraction.type
.
web.webInteraction.name
.web.webInteraction.URL
.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"
}
}
}
});
La extensión de Adobe Analytics tiene una ubicación dedicada para establecer una llamada de seguimiento de vínculos.
s.tl()
.No puede establecer ningún argumento opcional en 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]);
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.
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");
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.
o
: el vínculo es un vínculo personalizado.d
: el vínculo es un vínculo de descarga.e
: el vínculo es un vínculo de salida.// 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");
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");
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);
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");
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>
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");
}
}