API de seguimiento de posibles clientes
Munchkin JavaScript de Marketo permite rastrear las visitas y los clics de la página del usuario final en las páginas de aterrizaje de Marketo y en las páginas web externas. Se registran en Marketo como actividades "Visitar página web" y "Vínculo en el que se hizo clic en la página web", que luego se pueden utilizar en déclencheur y filtros para campañas inteligentes y listas inteligentes.
Incrustación del código
La instancia de Marketo proporciona automáticamente fragmentos de código de seguimiento preconfigurados para incrustar código en las páginas externas que rastrean la actividad hasta la instancia de Marketo. El uso del código incrustado se rige por este acuerdo de licencia.
Hay tres tipos de código de seguimiento disponibles:
- Simple: se carga sincrónicamente
- Asíncrona: se carga asincrónicamente
- jQuery asincrónico: se carga asincrónicamente y requiere que jQuery se cargue de antemano
Se recomienda encarecidamente que el código de seguimiento asíncrono se utilice para incrustar Munchkin en páginas externas. Para garantizar la tasa de éxito más alta posible para la ejecución, incruste el código de seguimiento asincrónico en <head> de cada página.
Algunos sistemas de gestión de contenido pueden tener métodos o restricciones específicos al incrustar secuencias de comandos arbitrarias.
Como referencia, la página final debe incluir código similar a este en <head> del documento de HTML:
<head>
<script type="text/javascript">
(function() {
var didInit = false;
function initMunchkin() {
if(didInit === false) {
didInit = true;
Munchkin.init('CHANGE-ME');
}
}
var s = document.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = '//munchkin.marketo.net/munchkin.js';
s.onreadystatechange = function() {
if (this.readyState == 'complete' || this.readyState == 'loaded') {
initMunchkin();
}
};
s.onload = initMunchkin;
document.getElementsByTagName('head')[0].appendChild(s);
})();
</script>
...
</head>
Comportamiento de Munchkin
El comportamiento predeterminado de Marketo Munchkin es hacer lo siguiente al cargar la página:
- Compruebe si el explorador actual tiene una cookie de Munchkin y cree una si no está allí.
- Envíe un evento "Visitar página web" a la instancia de Marketo designada con la información de la página y el explorador actuales. Registra una actividad en el registro correspondiente de Marketo.
- Enviar el evento "Vínculo en el que se ha hecho clic en una página web" para cualquier clic del usuario en los vínculos.
El comportamiento de Munchkin se puede modificar mediante el uso de Munchkin Ajustes de configuración, como si se crea una cookie para todos los posibles clientes al visitar la página con la configuración cookieAnon o al modificar el retardo de clic con la configuración clickTime. El envío de la actividad Visita puede deshabilitarse estableciendo la configuración de apiOnly en true. A partir de la versión 162 de (agosto de 2022), se hace un seguimiento de los clics tel y los vínculos mailto, además de los vínculos http/s.
Posibles clientes conocidos y anónimos
En la primera visita de un posible cliente a una página de su dominio, se crea un nuevo registro de posible cliente anónimo en Marketo. La clave principal de este registro es la cookie de Munchkin (_mkto_trk) que se crea en el explorador del usuario. Toda la actividad web subsiguiente en ese navegador se registra en este registro anónimo. Para asociarse a un registro conocido en Marketo, debe producirse una de las siguientes acciones:
- El posible cliente debe visitar una página con seguimiento de Munchkin con un parámetro
mkt_token la cadena de consulta de un vínculo de correo electrónico de Marketo rastreado. - El posible cliente debe rellenar un formulario de Marketo.
- SOAP Se debe enviar una llamada a syncLead o REST Associate Lead de la línea de comandos.
Una vez que se cumpla una de estas condiciones, la cookie y toda la actividad web asociada se asociarán al posible cliente conocido.
Se crea un nuevo registro de actividad web anónimo para cada explorador individual, por lo que si un posible cliente visita su dominio por primera vez utilizando un nuevo equipo o explorador, esta asociación debe volver a realizarse.
Dominios
Munchkin crea y rastrea cookies individuales por dominio, por lo que para que se produzca el seguimiento de posibles clientes conocido entre dominios, debe producirse un evento de asociación de posibles clientes para cada dominio. Por ejemplo, si controlo dos dominios, marketo.com y example.com, y un posible cliente rellena un formulario en marketo.com y luego navega a example.com más tarde, su actividad en marketo.com se rastrea en un registro de posible cliente conocido, pero su actividad en example.com es anónima. Sin embargo, los posibles clientes conocidos persisten entre subdominios, por lo que un posible cliente conocido en www.example.com también es un posible cliente conocido en info.example.com.
En caso de que el dominio de nivel superior esté formado por dos partes, como .co.uk, agregue un parámetro domainLevel al fragmento de Munchkin para que el código se rastree correctamente. Ver aquí para obtener más detalles.
Cookie
La cookie de Munchkin utiliza la clave _mkto_trk y tiene un valor que sigue este patrón:
id:561\-HYG\-937&token:_mch\-marketo.com\-1374552656411\-90718
Las cookies de Munchkin son específicas de cada dominio de segundo nivel, es decir, example.com. La duración predeterminada de la cookie es de 2 años (730 días).
Beta
Para suscribirte al canal beta de Munchkin para tus páginas de aterrizaje, ve al menú Administrador -> Cofre del tesoro y habilita la configuración "Beta de Munchkin en páginas de aterrizaje". Esto proporciona nuevos fragmentos de código en Admin -> Menú Munchkin para permitirle usar la versión beta en sitios externos.
Opción de exclusión
Los visitantes pueden excluirse por completo del seguimiento de Munchkin agregando el parámetro querystring "marketo_opt_out=true" a la dirección URL de su explorador. Cuando Munchkin JavaScript detecta esta configuración, intenta establecer una nueva cookie "mkto_opt_out" con un valor de true. Todas las demás cookies de seguimiento de Marketo se eliminan, no se establecen cookies nuevas y Munchkin no realiza solicitudes HTTP cuando se detecta esta configuración.