API de seguimiento de posibles clientes
El JavaScript Munchkin de Marketo permite rastrear las visitas y los clics de la página del usuario final en sus 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 lo siguiente contrato 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 un 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 puede modificarse 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 cookieAnon configuración o modificación del retardo de clic con clickTime configuración. El envío de la actividad Visita puede deshabilitarse estableciendo la configuración de apiOnly en true. En la versión 162 de (agosto de 2022), haga clic en tel y mailto además de los vínculos de http/s Vínculos.
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
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 A syncLead o REST Asociar posible cliente La llamada de debe enviarse.
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.comy un posible cliente rellena un formulario en marketo.com, luego navega a example.com posteriormente, y su actividad en marketo.com se rastrea en un registro de posibles clientes conocido, pero su actividad en example.com es anónimo. Sin embargo, los posibles clientes conocidos persisten entre subdominios, por lo que un posible cliente conocido en www.example.com también es una posible cliente conocida en info.example.com.
En caso de que el dominio de nivel superior esté formado por dos partes, como .co.ukA continuación, añada un parámetro domainLevel al fragmento de Munchkin para que el código se rastree correctamente. Consulte aquí para obtener más información.
Cookie
La cookie de Munchkin utiliza la clave _mkto_trky 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 suscribirse al canal beta de Munchkin para sus páginas de aterrizaje, vaya a su Administrador -> Cofre del tesoro y habilite la configuración "Munchkin Beta on Landing Pages". Esto proporciona nuevos fragmentos de código en la variable Administrador -> Munchkin para permitirle utilizar la versión beta en sitios externos.
Opción de exclusión
Los visitantes pueden excluirse del seguimiento de Munchkin agregando el querystring parámetro "marketo_opt_out=true" a la 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.