API di tracciamento dei lead
Munchkin JavaScript di Marketo tiene traccia delle visite alle pagine e dei clic sui collegamenti sulle pagine di destinazione e sulle pagine web esterne di Marketo. Marketo registra queste interazioni come attività “Visita pagina web” e “Collegamento cliccato su pagina web”.
Utilizza le attività in trigger e filtri per Campagne avanzate ed Elenchi smart.
Incorporazione del codice
L’istanza Marketo fornisce snippet di codice preconfigurato per il tracciamento dell’attività da pagine esterne. L’utilizzo del codice di incorporamento è disciplinato dal contratto di licenza.
Sono disponibili tre tipi di codici di tracciamento:
- Semplice (Simple) - Carica in modo sincrono.
- Asincrono: viene caricato in modo asincrono.
- Asynchronous jQuery - Carica in modo asincrono e richiede che jQuery venga caricato per primo.
Utilizza il codice di tracciamento asincrono per incorporare Munchkin in pagine esterne. Per ottenere il tasso di successo di esecuzione più alto possibile, inserire il codice nell’elemento <head> di ogni pagina.
Alcuni sistemi di gestione dei contenuti possono disporre di metodi o restrizioni specifici quando incorporano script arbitrari.
Nell’elemento <head> del documento HTML la pagina finale deve includere un codice simile al seguente esempio:
<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>
Comportamento di Munchkin
Per impostazione predefinita, Marketo Munchkin esegue le azioni seguenti al caricamento di una pagina:
- Verifica se il browser corrente dispone di un cookie Munchkin e, se necessario, ne crea uno.
- Invia un evento “Visita pagina Web” all’istanza di Marketo designata utilizzando le informazioni della pagina corrente e del browser. Questo evento registra un’attività nel record Marketo corrispondente.
- Invia un evento “Collegamento selezionato su pagina Web” quando l’utente seleziona un collegamento.
Utilizza le impostazioni di configurazione di Munchkin per modificare questo comportamento. Ad esempio, utilizza cookieAnon per controllare se Munchkin crea un cookie per tutti i lead che visitano la pagina o utilizza clickTime per modificare il ritardo di clic.
Per disabilitare l’attività Visita, impostare apiOnly su true. A partire dalla versione 162 (agosto 2022), Munchkin tiene traccia dei clic su tel e mailto collegamenti oltre a http/s collegamenti.
Lead noti e anonimi
Quando un lead visita per la prima volta una pagina del dominio, Marketo crea un record lead anonimo. La chiave primaria per questo record è il cookie di Munchkin (_mkto_trk) creato nel browser dell’utente.
Marketo registra la successiva attività web da quel browser sul record anonimo. Per associare l’attività a un record Marketo noto, deve verificarsi uno dei seguenti eventi:
- Il lead deve visitare una pagina tracciata da Munchkin con un parametro
mkt_toknella stringa query da un collegamento e-mail di Marketo tracciato. - Il lead deve compilare un Marketo Form.
- È necessario inviare una chiamata REST Associa lead.
Quando si verifica uno di questi eventi, Marketo associa il cookie e tutte le attività web correlate al lead noto.
Marketo crea un record di attività web anonimo per ogni browser. Se un lead visita il dominio da un nuovo computer o browser, l’associazione deve ripetersi.
Domini
Munchkin crea e tiene traccia dei cookie in base al singolo dominio. Per tenere traccia di un lead noto tra più domini, è necessario che su ciascun dominio si verifichi un evento di associazione lead.
Si supponga ad esempio di controllare marketo.com e example.com. Un lead invia un modulo il marketo.com e successivamente passa a example.com. L’attività su marketo.com è associata al lead noto, ma l’attività su example.com è anonima.
I lead noti persistono tra i sottodomini. Un lead noto su www.example.com è anche un lead noto su info.example.com.
Se il dominio di primo livello include due parti, ad esempio .co.uk, aggiungere un parametro domainLevel al frammento di codice Munchkin. Per ulteriori informazioni, vedere Configurazione.
Cookie
Il cookie Munchkin utilizza la chiave _mkto_trk e un valore che segue uno dei seguenti pattern:
id:561-HYG-937&token:_mch-marketo.com-1374552656411-90718
Oppure
id:561-HYG-937&token:_mch-marketo.com-97bf4361ef4433921a6da262e8df45a
I cookie di Munchkin sono specifici di ogni dominio di secondo livello, ad esempio example.com. La durata predefinita del cookie è di 2 anni (730 giorni).
Beta
Per accedere al canale beta Munchkin per le pagine di destinazione, passa a Amministratore -> Treasure Chest e abilita l’impostazione “Munchkin Beta sulle pagine di destinazione”.
Questa impostazione aggiunge snippet di codice al menu Admin -> Munchkin. Utilizza questi snippet per eseguire la versione beta su siti esterni.
Rinuncia
I visitatori possono rinunciare al tracciamento di Munchkin aggiungendo il parametro querystring “marketo_opt_out=true” all’URL nel browser. Quando Munchkin JavaScript rileva questa impostazione, tenta di impostare un nuovo cookie “mkto_opt_out” con un valore di true.
Munchkin elimina quindi tutti gli altri cookie di tracciamento di Marketo, non imposta nuovi cookie e non effettua richieste HTTP.