Uso del método tl() con el Activity Map

El método tl() se puede usar para hacer un seguimiento de elementos personalizados y configurar la representación de las superposiciones en el contenido dinámico.

Seguimiento de elementos personalizados

Al usar tl() el método en el módulo AppMeasurement de Activity Map se puede realizar un seguimiento de cualquier objeto en el que se haga clic, incluso objetos que no sean etiquetas de anclaje ni elementos de imagen. Con tl(), puede rastrear cualquier elemento personalizado que no resulte en una carga de página.

En el método tl(), el parámetro linkName que se usa actualmente para identificar los vínculos de salida, los vínculos personalizados, etc. ahora se utiliza también para identificar el ID del vínculo que corresponde a la variable de Activity Map.

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

En otras palabras, si utiliza tl() para hacer un seguimiento de los elementos personalizados, el ID del vínculo se extrae del valor pasado como tercer parámetro (Nombre del vínculo) en el método tl(). No se extrae del algoritmo de seguimiento estándar de vínculos que se utiliza para el seguimiento predeterminado en Activity Map.

Representación de superposiciones en el contenido dinámico

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

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

Cuando se añade contenido de página web a la página tras su carga inicial, se llama indirectamente el método tl() y no se pueden mostrar superposiciones para ese nuevo contenido si no se activa expresamente o se hace clic en él. Luego se desencadena un proceso de recopilación de nuevos vínculos desde Activity Map.

Cuando no se llama directamente a el método tl() desde el evento en el que se hace clic del elemento HTML, Activity Map solo puede mostrar la superposición cuando el usuario ha hecho clic en el elemento. A continuación, vemos un ejemplo en el que se llama el método tl() de manera indirecta:

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

La mejor manera para que el Activity Map superponga vínculos de contenido dinámico es tener configurada una función ActivityMap.link personalizada para llamar a la misma función cuyo valor devuelto se pase a tl(). Por ejemplo:

var originalLinkFunction = s.ActivityMap.link;
s.ActivityMap.link = function(element,linkName)
{
    // if this is a s.tl call, just return string passed
    return linkName ||
    // this is ActivityMap reporting time
    makeLinkName(element) ||
    // our custom function didn't return anything, so just return the default ActivityMap Link
    originalLinkFunction(element,linkName);
};

<button type="button" onclick="s.tl(this,'o',makeLinkName(this)">Add To Cart</button>

En este caso, se ha anulado la función ActivityMap.link para realizar una de las tres cosas cuando se llama a :

1. Si se pasa linkName, esto lo llamó tl(), por lo que solo debe devolver lo que tl() pasó como linkName.
2. Cuando el Activity Map lo llama en el momento de generar el informe, nunca se pasa un linkName y, por lo tanto, llama a makeLinkName() con el elemento del vínculo. Este es el paso clave: la llamada makeLinkName(element) debe ser el mismo que el tercer argumento de la llamada tl() en la etiqueta <button>. Esto significa que cuando se llama a tl(), realizamos un seguimiento de la cadena devuelta por makeLinkName(). Cuando el Activity Map informa de los vínculos de la página, utiliza la misma llamada para crear un vínculo.
3. La solución definitiva es devolver el valor devuelto original de la función predeterminada de vínculo de Activity Map. Mantener esta referencia alrededor de para llamar en el caso predeterminado solo le ayuda a sobrescribir o escribir código personalizado para makeLinkName() y a no tener que presentar un valor devuelto de vínculo para todos los vínculos de la página.